Client d'importation

1. Client d'importation

1.1 Présentation de l'outil

Le client d'importation est un programme externe à Constellio qui permet d'importer des fichiers et autres enregistrements dans Constellio.

L'outil utilise les gabarits d'importation au format .xlsx pour effectuer l'importation. Il permet également d'automatiquement générer un gabarit importable à partir d'un partage réseau.

1.2 Téléchargement

2. Guide d'utilisation

Pour démarrer le programme, cliquez sur « start-program.bat » et connectez-vous avec votre identifiant Constellio.

2.1 Configuration

Avant de démarrer le programme, l'adresse du serveur, ainsi que le port doivent être définis dans le fichier « configurations/config.properties » aux propriétés « server.host » et «server.port ».

Ces informations seront demandées à l'ouverture du programme si elles ne sont pas définies dans le fichier de configuration.

Pour se connecter en HTTPS, mettre la valeur de la propriété auth.connectUsingSSL à « true » dans le fichier de configuration.

2.2 Importation

La partie « Importation » permet d'importer des dossiers et documents dans Constellio à partir d'un gabarit d'importation au format Excel (.xlsx) qui peut être généré à partir de l'outil d'exportation ou créé manuellement (voir la documentation Constellio).

Le gabarit du client d'import comporte une colonne supplémentaire « content » qui correspond au chemin du fichier à importer comme contenu pour chaque document. Important : Ne pas utiliser la fonction « Hyperlien » dans Excel, mais plutôt copier le chemin complet vers le fichier en format texte.

• ex : C:\Users\Constellio\Desktop\constellio\monFichierAImporter.docx 

Les informations suivantes doivent être définies dans le fichier de configuration : 

• import.filePath : Le chemin complet du gabarit d'importation (template.xlsx)
• import.collection : Le code de la collection Constellio où les enregistrements doivent être importés.

2.3 Exportation

La partie « Exportation » permet de générer un gabarit d'importation à partir d'un partage réseau local. Il est possible d'utiliser une expression régulière pour détecter les dossiers du partage réseau qui correspondent à une rubrique pour remplir la colonne correspondante avec les bons codes. Il est également possible d'utiliser une rubrique et une unité administrative par défaut pour les modifier manuellement dans le fichier Excel avant l'importation.

Les entêtes du gabarit sont générés à partir du fichier TEMPLATE dans le dossier /bin/. CE FICHIER NE DOIT PAS ÊTRE MODIFIÉ.

Les règles de conservation correspondent à la première règle pour la catégorie. Si aucune règle n'est trouvée pour une catégorie, le champ du gabarit d'importation sera laissé vide et les données devront être corrigées manuellement.

Les informations suivantes peuvent être définies dans le fichier de configuration : 

• export.root_path : Le chemin racine du partage réseau à exporter.
• export.use_category_regex : Si on doit utiliser la détection automatique des rubriques (true ou false).
• export.category_regex : L'expression régulière à utiliser pour la détection automatique des rubriques.
• export.administrative_unit : L'unité administrative par défaut.
• export.default_category : La rubrique par défaut.

Les informations d'exportation seront demandées lors de la première ouverture de l'outil et peuvent ensuite être modifiées à partir du menu « Configurations » ou directement dans le fichier « config.properties ».

3. Exemple d'utilisation du client d'importation

Rendez-vous sur ce lien pour avoir accès à un exemple d'utilisation du client d'importation.