Export CSV
Choisissez les données que vous souhaitez exploiter et exportez les en toute simplicité !
Les bénéfices
Ce module permet aux utilisateurs de sélectionner et d'exporter avec facilité une partie ou la totalité des contenus, contenus utilisateur, formulaires et portlets de votre plateforme dans un fichier au format CSV. Si vous souhaitez conserver les liens entre vos publications, récupérer les catégories associées ou encore les fihiers atttachés à vos contenus, quelques paramètres à activer et le tour est joué.
En offrant une interface d'exportation avancée et intuitive, ce module offre ainsi une solution complète pour extraire et structurer vos données en vue d'une utilisation ultérieure.
Les fonctionnalités
Les fonctionnalités clés de ce module sont :
- Exportation polyvalente : ce module permet l'exportation de contenus variés, tels que les contenus et contenus utilisateurs, les formulaires, les portlets, ainsi que les fichiers associés ;
- Exportation au format CSV : les données sont exportées dans un format CSV (Comma-Separated Values), largement reconnu et compatible avec de nombreux logiciels. Les fichiers CSV exportés peuvent être ouverts et traités dans des applications de tableur, des bases de données et d'autres outils ;
- Génération d'arborescence de dossiers : l'exportation de documents génère une arborescence de dossier basée sur la structure de catégories du document ;
- Gestion complète des fichiers : exportez en toute confiance les fichiers associés en conservant l'intégrité de la structure d'arborescence ;
- Interface d'export avancée : ce module offre une interface d'exportation conviviale et intuitive, permettant aux utilisateurs de sélectionner les données à exporter avec précision ;
- Définition de template d'export : il vous est possible de définir un modèle d'export par type de contenu qui reprendra automatiquement votre configuration d'export
- Accès depuis back office et front office : les contributeurs et administrateurs habilités peuvent accéder à l'interface d'export depuis l'espace d'administration ou le front office.
Le module intègre également plusieurs paramètres permettant notamment :
- de définir le positionnement du lien d’export
- de définir les utilisateurs habilités à exporter
- de définir la données à exporter pour certains types de champ, exemples :
- pour l'état de worklow : possiblité d'exporter l'ID ou le libellé
- pour un rédacteur : possiblité d'exporter le prénom et nom ou l'identifiant
- pour les catégories : possibilité d'exporter l'ID ou le titre
- d'exporter les fichiers attachés à vos contenus (média et document)
- de nettoyer automatiquement les zones de texte riches (wysiwyg)
L'interface d'export est accessible pour tout contributeur et/ou administrateur habilité depuis le back office et front office de JPlatform à différents niveaux de votre plateforme :
- Depuis l’espace d’administration pour les administrateurs
- Depuis les espaces de travail pour les contributeurs
- Depuis vos explorateurs de documents (portlet explorer) pour tout membre habilité
Captures d'écran
Les clients aiment
FAQ
Pour obtenir le code ASCII d'un caractère ou inversement, un convertisseur est intégré dans le module accessible depuis l'administration fonctionnelle :
Vous avez la possibilité de retrouver le code ASCII associé à un caractère et vice versa :
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.
Il permet d’exporter les types de publication suivants : contenu, contenu utilisateur, portlet, formulaire.
Dans ce cas, seuls les administrateurs techniques auront accès à l’export (depuis l’administration techniques de JCMS).
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 JCMS 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 :
Informations détaillées
Prérequis techniques
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.
Configuration du module
Ajouter ce module avec le gestionnaire de modules depuis l’administration technique et redémarrer JPlatform.
Une fois le module installé, assurez-vous que les propriétés du module sont correctement paramétrées pour votre plateforme.
Exemple de paramétrage
Avec les paramétrages ci-dessous :
N° |
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 :
- Nom technique jcmsplugin.exportcsvplugin.aa.export.grp.id.jsp
- Description 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).
- Nom technique jcmsplugin.exportcsvplugin.ac.export.mail.from
- Description Il s’agit de l’adresse mail de l’émetteur pour les envois par mail des exports CSV.
- Nom technique jcmsplugin.exportcsvplugin.ad.multi.export.boolean
- Description Permet de lancer plusieurs exports CSV par session pour limiter la charge du serveur dans le cas d’export complexe.
- Nom technique jcmsplugin.exportcsvplugin.ae.export.max.line
- Description Permet de limiter le nombre de lignes par fichier CSV avant de passer à un autre fichier.
- Nom technique jcmsplugin.exportcsvplugin.af.multivalues.separator
- Description Permet de préciser le séparateur de champ à valeur multiple utilisé dans le fichier d’export CSV.
- Nom technique jcmsplugin.exportcsvplugin.ag.clean.ascii.boolean
- Description 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 ».
- Nom technique jcmsplugin.exportcsvplugin.ah.ascii.to.conserve
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.ai.csv.separator
- Description Valeur par défaut « ; »
- Nom technique jcmsplugin.exportcsvplugin.ak.ui.modal.autoheight.boolean
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.al.ui.modal.manualheight
- Description Permet de figer la hauteur de la fenêtre de l’interface d’export en pixels.
- Nom technique jcmsplugin.exportcsvplugin.an.ui.field.size.jsp
- Description 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).
- Nom technique jcmsplugin.exportcsvplugin.ba.export.default.model.fields
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.bb.category.pub.export.jsp
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.bc.group.pub.export.jsp
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.bd.linked.pub.export.jsp
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.be.member.pub.export.jsp
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.bf.worflow.status.export.jsp
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.bg.human.bool.value.boolean
- Description Permet de choisir, pour les booléens, le format d'export. Si oui, la valeur exportée sera OUI ou NON suivant la langue de l'utilisateur. Si non, ce sera la valeur technique TRUE ou FALSE
- Nom technique jcmsplugin.exportcsvplugin.ca.clean.wiki.wysiwyg.field.boolean
- Description Permet de nettoyer les champs wysiwyg automatiquement pour récupérer uniquement le texte brut (retrait des mises en forme, image, lien, etc.).
- Nom technique jcmsplugin.exportcsvplugin.cb.rewrite.link.wiki.wysiwyg.field.boolean
- Description ermet de remplacer les liens vers des contenus JPlatform 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é
- Nom technique jcmsplugin.exportcsvplugin.cc.remove.link.wiki.wysiwyg.field.boolean
- Description Permet de supprimer tous les liens des champs wiki et wysiwyg qui ne pointent pas vers un contenu JCMS. 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é.
- Nom technique jcmsplugin.exportcsvplugin.cd.excel.cell.multi.column.boolean
- Description Permet de découper les zones wiki et wysiwyg en plusieurs colonnes pour limiter le nombre de caractères par cellule dans Excel.
- Nom technique jcmsplugin.exportcsvplugin.ce.excel.cell.max.char
- Description 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é.
- Nom technique jcmsplugin.exportcsvplugin.da.export.file.of.filedocument.boolean
- Description Permet de récupérer les fichiers physiques (word, excel, power point, pdf…) attachés aux FileDocument et liés aux publications exportées.
- Nom technique jcmsplugin.exportcsvplugin.db.export.file.of.filedocument.update.path.boolean
- Description 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ée
- Nom technique jcmsplugin.exportcsvplugin.dc.export.file.of.filedocument.add.file.param.boolean
- Description Ce paramètre s’applique si « Exporter physiquement les documents » est activé.
- Nom technique jcmsplugin.exportcsvplugin.ea.ui.exportlink.effect.activate.boolean
- Description Si activé, le lien d'export standard JCMS 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 JCMS.
- Nom technique jcmsplugin.exportcsvplugin.eb.ui.exportlink.standardlink.hide.boolean
- Description 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.
- Nom technique jcmsplugin.exportcsvplugin.fa.export.from.explorer.grp.id.jsp
- Description Permet de sélectionner un groupe unique autorisé à effectuer des exports depuis l'explorateur de document.
Corrections
- Amélioration des performances de la modale d'export lorsque l'on souhaite exporter une importante volumétrie
Évolutions
- Ajout la possibilité des télécharger le résultat de l'export depuis les pages "Etat des exports de l'espace de travail" (Administration de l'espace de travail) et "Etat des exports du site" (Espace d'administration)
Évolutions
- Ajout la possibilité des télécharger le résultat de l'export depuis les pages "Etat des exports de l'espace de travail" (Administration de l'espace de travail) et "Etat des exports du site" (Espace d'administration)
Corrections
- Prise en compte des propriétés "Paramétrage du format de fichier en sortie" pour les extradata
Évolutions
- Ajout dans "Administration de l'espace de travail" du lien "Etat des exports de l'espace de travail" et dans "Espace d'administration" du lien "Etat des exports du site". Cela permet de connaître en temps réel l'état d'avancement des exports
Évolutions
- Possibilité via la propriété du module "Format du titre du fichier" de choisir le format du titre du fichier lors de l'export physique d'un document
Corrections
- Correctif afin de prendre en compte les paramètres de la requête d'un PortletExplorer lors d'un export via un PortletExplorer utilisant le Gabarit par défaut
Corrections
- Correctif afin de prendre en compte l'affinage par espace de travail lors d'un export via un PortletExplorer utilisant le Gabarit par défaut
Évolutions
- Pouvoir réaliser des exports depuis la liste générée via l'éditeur de Publication (work/queryWork.jsp?types=Article&workspaceFilter=false)
- Affiche un message d'avertissement lorsque le type sélectionné ne remonte aucun résultat
Évolutions
- Retrait de la limitation du nombre de contenus exportés depuis un PortletExplorer pour les contenus stockés en base de données
- Prise en compte de l'ordre d'affichage du PortletExplorer lors de l'export
- Prise en compte de l'ordre d'affichage du back-office lors de l'export
Corrections
- Correction anomalie (noSuchMethodException au démarrage de certaines application en fonction des versions de JDK installées) provoquée par ExportCsvUtil --> Méthodes appelées avec un paramètre de type Boolean (objet) alors que c'est un boolean (primitif) qui était attendu.
Évolutions
- Ajout d'un nouveau champ à l’export :
- Nombre de vues
- Renommage d'un champ :
- Nombre de vues DEVIENT Nombre de lecteurs
Évolutions
- Exporter les sous-catégories depuis le PortletExplorer avec son nouveau gabarit suivant le paramétrage du champ "Navigation par catégories exactes"
- Navigation par catégories exactes == OUI
- Export uniquement de la catégorie courante
- Navigation par catégories exactes == NON
- Export de la catégorie courante et de ses sous-categories
- Navigation par catégories exactes == OUI
Cette version améliore la fonctionnalité :
- Export via la sélection d'une ou plusieurs catégories
Évolutions
- Ajout de 3 nouveaux champs à l’export :
- Nombre de vues
- Nombre de commentaires
- Nombre de votes.
Évolutions
- Possibilité de faire des exports de documents depuis le nouveau gabarit des portlets explorateur (style application)
- Possibilité de restreindre l'export des publications à certains pstatus (non plis en compte pour l'export depuis les portlets explorateur)
- Renommer les fichiers exportés avec le nom du FileDocument depuis l'export de documents du backoffice d'un espace de travail ainsi que depuis les portlets explorateur
Évolutions
- Ajout de la possibilité d'exporter les documents depuis l'explorateur de documents.
- Le fichier d'export conserve l'ensemble de l'arborescence de catégorie de cet explorateur généré sous forme de dossiers.
Évolutions
- Ajout de la personnalisation pour la donnée Espace de travail
Corrections
- Correctif pour les types héritant de FileDocument.
Évolutions
- Ajout de la fonctionnalité d'export des fichiers associés aux Documents jPlatform par espace de travail
Évolutions
- Possibilité de personnalisation du format d'export des booléens
- Possibilité de personnalisation du séparateur du fichier CSV
Corrections
- Correctif pour que le résultat de l'export soit téléchargeable qu'on soit redirigé vers le Leader ou le Réplica.
Possibilité de personnalisation du format des dates exportées.
