Login
      Contenu x
      Client d'importation
      • 19 Dec 2023
      • 3 Minutes à lire
      • Contributeurs
      • Impression
      • Sombre
        Clair
      • PDF
      Contenu

      Client d'importation

      • Mis à jour le 19 Dec 2023
      • 3 Minutes à lire
      • Contributeurs
      • Impression
      • Sombre
        Clair
      • PDF
      Article Summary

      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

      VersionNouvelles fonctionalitésVersion de Constellio supportéeTéléchargement
      2.10
      • L'authentification s'effectue maintenant à partir de Constellio dans le navigateur
      • Support de l'authentification avec Oauth2
      • Ajout d'une mécanique de reprise pour reprendre les importations non-terminées
      • Retrait de la limite d'expiration des jetons d'authentification(oauth2 seulement)

      		11.1.8+https://constellio.cloud.constellio.com/constellio/dl?id=00000906232
      2.9
      • Ajout de la configuration "import.withConnectionTimeout" pour désactiver les timeout lors de l'importation
      • Correction d'un problème pour l'importation de gabarits Excel qui contiennent des lignes vides

      		10.0.3+
      		https://constellio.cloud.constellio.com/constellio/dl?id=00000613671
      2.8
      • Comptabilité avec les options d'importation « cellRange » et « keepExtraWhitespace ».
      • Stabilité amélioré.
      		10.0.3+https://constellio.cloud.constellio.com/constellio/dl?id=00000527379
      2.7
      • Comptabilité avec la version 10.
      • Amélioration des messages d'erreur.
      		10.0.3+https://constellio.cloud.constellio.com/constellio/dl?id=00000527061
      2.6.1
      • Ajout de la configuration « import.withConnexionTimeout ». pour permettre à la connexion de ne jamais expire durant le téléversement.
      		9.2https://constellio.cloud.constellio.com/constellio/dl?id=00000608671
      2.6
      • Augmentation du temps d'ouverture de la session
      • Amélioration à la gestion d'erreurs d'expiration de délai d'attente lors de l'importation.
      • Ajout des métadonnées, dates de création et modification des documents lors de la génération d'un fichier d'importation..
      		9.2+
      9.1.0.7
      8.2.1.96      		Constellio-importExportScript_v2.6.zip
      2.5
      • Correction d'un problème pour la lecture de chemins qui contiennent des accents.
      • Correction d'un problème de mémoire vive lors du téléversement de gros fichiers.
      		9.2+
      9.1.0.7
      8.2.1.969      		Constellio-importExportScript_v2.5.zip
      2.4.1
      • Prévalidation des métadonnées.
      • Exportation de partage réseau.
      		9.2+
      9.1.0.7
      8.2.1.969      		Constellio-importExportScript_v2.4.1.zip
      2.3.1
      • Importation de fichiers.
      • Importation d'enregistrements.
      • Exportation de partage réseau.
      • Authentification en SSL.
      		9.1
      8.2.1.968      		Constellio-importExportScript_v2.3.1.zip

      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. 

      Cet article vous a-t-il été utile ?
      What's Next
      Change password!
      Changing your password will log you out immediately. Use the new password to log back in.
      Change profile
      Success!
      First name must have atleast 2 characters. Numbers and special characters are not allowed.
      Last name must have atleast 1 characters. Numbers and special characters are not allowed.
      Enter a valid email
      Enter a valid password
      Your profile has been successfully updated.
      Logout