We apologize for untranslated text, you can use the Google Translation button to get an automatic translation of the web page in the language of your choice.

Module d'export CSV

Description

Le module d'export de contenus permet d'exporter au format csv tous les types de publication de votre site :

  • Contenus
  • Contenu utilisateur
  • Formulaire
  • Portlet

Installation

Ce module a été réalisé par WISEN, expert sur les solutions Jalios.

Pour télécharger ce module, rendez-vous sur cette page.

Ajouter ce module avec le gestionnaire de modules depuis l’administration technique et redémarrer l’application.

Expertise Web sur-mesure

Présentation

Le module d'export de contenus intègre une toute nouvelle interface de personnalisation du fichier d’export, avec la possibilité de sélectionner une partie ou l’ensemble des données de la publication sélectionnée (champs de la publication, métadonnées, etc.).

L’interface de personnalisation est accessible pour tout contributeur et/ou administrateur habilité depuis le back office de JPlateform :

  • Depuis l’espace d’administration pour les administrateurs
  • Depuis les espaces de travail pour les contributeurs

 

Dans l’espace de travail, il suffit de sélectionner un type de publication et si besoin filtrer sur l’état de workflow et/ou ajouter un filtre textuel :

 exportCSV intro

Une fois le type de publication sélectionné, le lien d’export est affiché permettant d’ouvrir l’interface de personnalisation du fichier csv.

L’export s’appliquera sur la liste de résultats qui vous est affichée en fonction des filtres utilisés (état de workflow et/ou filtre textuel).

 

Ci-dessous un extrait de l’interface pour un contenu de type article :

 

exportCSV intro2

exportCSV intro3

 

Plusieurs paramètres de module décrits dans la liste des propriétés permettent de personnaliser l’interface, de définir le positionnement du lien d’export, les utilisateurs habilités, etc.

 

Dans l'explorateur de document, il suffit de dérouler le menu "Actions" :

explorateur document exporter

 

L'export s'effectue sur les documents affichés dans l'explorateur et tenant compte des filtres en cours (catégorie et/ou recherche textuelle). 

L'archive exportée a l'avantage de contenir l'arborescence telle qu'elle est dans votre explorateur et restituée sous forme de dossiers. 

 

Informations techniques

Compatibilité JPlateform

Ce module est compatible sur les versions :

  • JPlateform 9 SP1
  • JPlateform 9 SP2
  • JPlateform 9 SP3
  • JPlateform 9 SP4

 

Compatibilité JSync

Ce module est compatible jSync, il fonctionnera sans problème sur un environnement à plusieurs réplicas.

En revanche, il est important de noter que la configuration du module ne sera pas répliquée et sera à faire sur chaque nœud.

 

Compatibilité JDK

Ce module est compatible avec la version 1.7 de JDK (Java Development Kit). Si vous êtes sur la version 1.6 de JDK, contactez-nous.

 

Prérequis

Pour une meilleure compréhension et utilisation de ce module, il est conseillé d’avoir suivi les formations JPlateform suivantes :

  • Formation d’administrateur technique
  • Formation d’administrateur fonctionnel

 

Ce module ne dépend d’aucun autre module.

 

Paramétrage

Liste des propriétés

Editez le module pour paramétrer ou modifier ses propriétés :

Propriété

Nom technique

Description

Paramètres globaux

Groupe autorisé à faire les exports

jcmsplugin.exportcsvplugin.aa.export.grp.id.jsp

Permet de sélectionner un groupe unique autorisé à effectuer les exports (dans le cas où les exports de contenus doivent être accessibles que pour certains utilisateurs).

Adresse mail par défaut de l'émetteur

jcmsplugin.exportcsvplugin.ac.export.mail.from

Il s’agit de l’adresse mail de l’émetteur pour les envois par mail des exports CSV.

Lancer plusieurs exports par session

jcmsplugin.exportcsvplugin.ad.multi.export.boolean

Permet de lancer plusieurs exports CSV par session pour limiter la charge du serveur dans le cas d’export complexe.

Nombre maximum de lignes par fichier

jcmsplugin.exportcsvplugin.ae.export.max.line

Permet de limiter le nombre de lignes par fichier CSV avant de passer à un autre fichier.

Séparateur de champ multivalué

jcmsplugin.exportcsvplugin.af.multivalues.separator

Permet de préciser le séparateur de champ à valeur multiple utilisé dans le fichier d’export CSV.

Nettoyage des caractères spéciaux

jcmsplugin.exportcsvplugin.ag.clean.ascii.boolean

Si activé, permet de retirer du fichier tous les caractères spéciaux qui ne sont pas autorisés suivant ce qui est renseigné dans le champ suivant « Caractères ASCII à conserver ».

Caractères ASCII à conserver

jcmsplugin.exportcsvplugin.ah.ascii.to.conserve

Permet de préciser les caractères spéciaux à conserver dans le fichier. Il est possible d’indiquer des intervalles de caractères à conserver en les séparant par des espaces.

Exemple : 32|255 = les caractères 32 à 255 inclus seront conservés dans le fichier.

Fenêtre de l'export - Hauteur automatique

jcmsplugin.exportcsvplugin.ak.ui.modal.autoheight.boolean

Permet de laisser la fenêtre de l’interface d’export en back office s’ajuster automatiquement (en hauteur) à la fenêtre de l’utilisateur.

Fenêtre de l'export - Hauteur maximum (en pixels)

jcmsplugin.exportcsvplugin.al.ui.modal.manualheight

Permet de figer la hauteur de la fenêtre de l’interface d’export en pixels.

Accessibilité - Taille des champs et boutons

jcmsplugin.exportcsvplugin.an.ui.field.size.jsp

Permet d’augmenter la taille des champs et des boutons utilisés dans l’interface d’export (pour répondre à des contraintes d’accessibilité notamment).

Paramétrage du format de fichier en sortie

Modèle par défaut de tous les types

jcmsplugin.exportcsvplugin.ba.export.default.model.fields

Permet d’indiquer le modèle par défaut du fichier d’export pour tous les types de contenu. Il suffit d’indiquer les noms techniques ou noms java des champs à intégrer dans le modèle par défaut.

Catégorie d'une publication : exporter le nom ou l'id

jcmsplugin.exportcsvplugin.bb.category.pub.export.jsp

Permet de choisir, pour les champs de type catégorie, de récupérer dans le fichier d’export le nom ou l’identifiant de la catégorie.

Groupe d'une publication : exporter le nom ou l'id

jcmsplugin.exportcsvplugin.bc.group.pub.export.jsp

Permet de choisir, pour les champs de type groupe, de récupérer dans le fichier d’export le nom ou l’identifiant du groupe.

Publication liée : exporter l'url, le titre ou l'id

jcmsplugin.exportcsvplugin.bd.linked.pub.export.jsp

Permet de choisir, pour les publications liées à la publication que vous souhaitez exporter, de récupérer dans le fichier d’export l’url, le titre ou l’identifiant de ces publications.

Membre d'une publication : exporter le nom + prénom ou l'id

jcmsplugin.exportcsvplugin.be.member.pub.export.jsp

Permet de choisir, pour les membres des publications, de récupérer dans le fichier d’export le nom et prénom ou l’identifiant de chaque membre.

Etat de workflow : exporter le nom de l'état ou son numéro

jcmsplugin.exportcsvplugin.bf.worflow.status.export.jsp

Permet de choisir, pour les états de workflow, de récupérer dans le fichier d’export le nom de l’état ou le numéro de chaque état.

Paramétrages sur les champs Wysiwyg/Wiki

Nettoyage automatique des champs wiki / wysiwyg

jcmsplugin.exportcsvplugin.ca.clean.wiki.wysiwyg.field.boolean

Permet de nettoyer les champs wysiwyg automatiquement pour récupérer uniquement le texte brut (retrait des mises en forme, image, lien, etc.).

Réécrire les liens des champs wiki / wysiwyg

jcmsplugin.exportcsvplugin.cb.rewrite.link.wiki.wysiwyg.field.boolean

Permet de remplacer les liens vers des contenus JCMS paramétrés dans les champs wiki et wysiwyg par des liens intégrant l’URL complète vers ces contenus.

Ce paramètre ne s’applique pas si « Nettoyage automatique des champs wiki / wysiwyg » est activé.

Supprimer les liens des champs wiki / wysiwyg qui ne pointent pas vers un contenu JPlateform (liens cassés)

jcmsplugin.exportcsvplugin.cc.remove.link.wiki.wysiwyg.field.boolean

Permet de supprimer tous les liens des champs wiki et wysiwyg qui ne pointent pas vers un contenu JPlateform.

Cette option est liée à "Réécrire les liens des champs wiki / wysiwyg". Les liens externes ne seront pas supprimés.

Ce paramètre ne s’applique pas si « Nettoyage automatique des champs wiki / wysiwyg » est activé.

Découper les zones WIKI / WYSIWYG en plusieurs colonnes

jcmsplugin.exportcsvplugin.cd.excel.cell.multi.column.boolean

Permet de découper les zones wiki et wysiwyg en plusieurs colonnes pour limiter le nombre de caractères par cellule dans Excel.

Nombre de caractères avant découpe des zones WIKI / WYSIWYG en plusieurs colonnes

jcmsplugin.exportcsvplugin.ce.excel.cell.max.char

Permet de définir le nombre de caractères avant chaque découpage des champs wiki et wysiwyg (affichage dans la colonne suivante à chaque découpe).

Ce paramètre s’applique si « Découper les zones WIKI / WYSIWYG en plusieurs colonnes » est activé.

Paramétrage de l'export physique des documents

Exporter physiquement les documents

jcmsplugin.exportcsvplugin.da.export.file.of.filedocument.boolean

Permet de récupérer les fichiers physiques (word, excel, power point, pdf…) attachés aux FileDocument et liés aux publications exportées.

Ajouter START_PATH au début du chemin d'accès au fichier des FileDocument

jcmsplugin.exportcsvplugin.db.export.file.of.filedocument.update.path.boolean

Ce paramètre s’applique si « Exporter physiquement les documents » est activé.

Le start_path est un exécutable déployé dans le fichier compressé. Pour qu’il s’exécute correctement, vous devrez préalablement dé-zipper le dossier.

Il permet de générer des liens d’accès valides et utilisables dans le fichier csv vers les fichiers physiques (word, excel, power point, pdf…) attachés aux FileDocument et liés aux publications exportées.

Ajouter file:// au tout début du chemin d'accès au fichier des FileDocument (hors WIKI / WISYWYG)

jcmsplugin.exportcsvplugin.dc.export.file.of.filedocument.add.file.param.boolean

Ce paramètre s’applique si « Exporter physiquement les documents » est activé.

Paramétrage du lien d'export

Lien d'export - Activer le déplacement

jcmsplugin.exportcsvplugin.ea.ui.exportlink.effect.activate.boolean

Si activé, le lien d'export standard JPlateform est remplacé par le nouveau lien d’export CSV.

Si désactivé, un onglet supplémentaire est ajouté dans l’espace de travail.

Les administrateurs peuvent toujours accéder au lien dans l’administration technique de JPlateform.

Lien d'export standard JPlateform - Masquer

jcmsplugin.exportcsvplugin.eb.ui.exportlink.standardlink.hide.boolean

Permet de masquer le lien d’export standard affiché dans la liste des contenus.

Cette option est applicable si "Lien d'export - Activer le déplacement" est désactivée.

Paramétrage du lien d'export

Groupe autorisé à faire des exports de documents depuis une portlet explorer jcmsplugin.exportcsvplugin.fa.export.from.explorer.grp.id.jsp Permet de sélectionner un groupe unique autorisé à effectuer des exports depuis l'explorateur de document.

 

Enregistrement des nouvelles propriétés

Les changements de valeur des propriétés sont pris en compte directement lors de l'enregistrement sans avoir besoin de redémarrer l'application.

 

Exemple de paramétrage

Avec les paramétrages ci-dessous :

 exportCSV exemple1

exportCSV exemple2

 

DESCRIPTION

1

Sélection du type de publication à exporter (visible uniquement à l’utilisation du lien disponible dans l’administration technique)

2

Liste des données sélectionnées et ordre d’affichage de ces données dans le fichier csv (ordre modifiable via un glisser & déposer)

3

Adresse email réceptionnant le fichier d’export

4

Choix de ne pas exporter l’historique des publications

5

Choix de ne pas mettre à jour le modèle paramétré par défaut par celui-ci

6

Sélection des champs du contenu à récupérer dans le fichier csv

7

Sélection des dates du contenu à récupérer dans le fichier csv

8

Sélection des données de workflow à récupérer dans le fichier csv

9

Sélection des métadonnées du contenu à récupérer dans le fichier csv

 

Vous obtiendrez dans votre fichier csv généré le format d’affichage suivant :

 exportCSV exemple3

Extrait du fichier csv généré


FAQ

1. Le bouton d’export n’est pas visible dans la liste des contenus de l’espace de travail ?

Le bouton d’export du module n’est visible qu’après avoir sélectionner un type de publication particulier dans votre espace de travail. Notez qu’en fonction du paramétrage du module effectué, le lien d’export peut être affiché à la place du lien d’export natif JPlateform dans l’en-tête de liste des contenus, ou en tant qu’onglet complémentaire dans votre espace. Notez également que vous exporterez la liste des contenus de votre espace de travail qui vous est affichée après avoir sélectionné un type de contenu, et éventuellement après avoir filtrer sur un état du workflow et/ou sur une recherche textuelle.

2. Que se passe-t-il si aucun groupe n’est sélectionné comme étant autorisé à faire les exports ?

Dans ce cas, seuls les administrateurs techniques auront accès à l’export (depuis l’administration techniques de JPlateform).

3. Quels types de publications le module permet-il d’exporter ?

Il permet d’exporter les types de publication suivants : contenu, contenu utilisateur, portlet, formulaire.

4. Le lien de téléchargement du fichier d’export est-il disponible indéfiniment ?

Non, le lien de téléchargement n’est valable qu’une seule fois. Après votre premier téléchargement, le fichier est automatiquement supprimé, ceci afin d’éviter de surcharger votre serveur.

5. Comment obtenir le code ASCII d'un caractère ou inversement ?

Pour obtenir le code ASCII d'un caractère ou inversement, un convertisseur est intégré dans le module accessible depuis l'administration fonctionnelle, via le bloc "Organisation".
Vous avez la possibilité, via ce convertisseur, de retrouver le code ASCII associé à un caractère et vice versa.

Information

Version
  • 1.5
Stability
  • Stable
Compatibility
  • JCMS 9
Certified by Jalios
  • No
Price
  • Module payant
Support
  • Supporté par le revendeur
Author
  • WISEN
License
  • Propriétaire
Size
  • 1 KB
Updated
  • 3/14/17
Download
  • 22