Login
      Contenu x
      Client d'importation
      • 04 Feb 2025
      • 4 Minutes à lire
      • Contributeurs
      • Impression
      • Sombre
        Clair
      • PDF
      Contenu

      Client d'importation

      • Mis à jour le 04 Feb 2025
      • 4 Minutes à lire
      • Contributeurs
      • Impression
      • Sombre
        Clair
      • PDF
      Résumé de l’article

      Client d'importation

      Le client d'importation est un programme externe à Constellio qui permet d'importer en lot des copies des fichiers et leurs dossiers dans Constellio.  

      À noter que les fichiers seront ensuite à retirer de l'emplacement d'origine afin de limiter les doublons. Le client n'agit pas comme un outil de synchronisation, mais bien comme un outil d'importation. 

      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. Téléchargement

      Afin d'utiliser le client d'importation, veuillez télécharger le programme exécutable via le lien suivant. 

      VersionNouvelles fonctionnalitésVersion de Constellio supportéeTéléchargement
      3.0- Simplification du fichier de configuration
      - Ajout d'une interface pour sélectionner les dossiers à exporter
      - Sélection multiple des dossiers pour l'exportation
      - Améliorations à la mécanique de détection de rubriques
      - Améliorations à la navigation dans les menus de l'application et ajout de couleurs
      - Ajout d'une configuration pour ignorer certains types de fichiers lors de l'exportation
      - Ajout d'une option pour sélectionner des dossiers à ignorer lors de l'exportation
      		12+https://internal.constellio.me/constellio/dl?id=00001030002

      2. Utilisation du client d'importation

      2.1 Étapes d'utilisation du client d'importation 

      1.  Télécharger le client d'importation
      2.  Extraire les fichiers du client d'importation
      3.  Générer les fichiers de configuration
      4.  Extraire les fichiers de configuration téléchargés 
      5. Remplacer le fichier de configuration dans le répertoire "configurations" du client d'importation"
      6. Exécuter l'application du client d'importation

      2.2 Configuration du client d'importation

      Avant de pouvoir importer des enregistrements dans Constellio, il est nécessaire de configurer le client afin de définir l'endroit où les contenus seront envoyés. Pour se faire; 

      1. Aller dans le Pilotage; 
      2. Cliquer sur Importer les enregistrements; 
      3.  Cliquer sur Configuration du client d'importation;
      4.  Compléter les champs de Configuration de l'exportation / importation
      5. Au besoin, compléter les Configurations avancées
      6.  Générer le fichier de configuration du client d'importation
      7. Extraire le fichier "importClientProperties"
      8. Couper le contenu du fichier 
      9. Ouvrir le dossier "configurations" du client d'importation
      10. Coller le contenu préalablement coupé afin de remplacer les fichiers
      11. Le client d'importation est maintenant prêt à être utilisé.

      2.2.1 Configuration de l'exportation / importation

      ÉlémentDescription
      Collection d'importationIndiquer dans quelle collection les enregistrements seront importés.
      Unité administrative par défautIndiquer quelle sera l'unité administrative par défaut entrée dans le fichier d'importation.
      Type de détection de rubriquesIndiquer de quelle manière les rubriques du plan de classification seront entrées dans le fichier d'importation
      • Utiliser une rubrique par défaut : Permet de sélectionner une rubrique qui sera assignée à tous les enregistrements à importer.
      • Détecter les rubriques automatiquement : Permet de sélectionner ou entrer manuellement une expression régulière afin de reconnaitre les rubriques dans le partage réseau. 

      2.2.2 Configuration avancées

      Utilisation des configurations avancées
      Attention, il n'est généralement pas recommandé de modifier les configurations système. Il est préférable d'utiliser les valeurs par défaut dans la plupart des cas. 
      ÉlémentDescription
      Ignorer les fichiers manquants lors du téléversement des fichiersPermet de continuer l'importation si des fichiers sont présents dans le gabarit, mais absent dans le partage réseau. Cette figure de cas créera des fiches de métadonnées vides dans Constellio. 
      Abandonner le téléversement d'un fichier après 5 minutes d'attenteUn fichier ne sera pas importé s'il y a plus de 5 minutes d'attente.
      Type d'authentificationPermet de choisir la manière dont l'utilisateur sera authentifié dans Constellio lors de l'utilisation du Client d'importation.
      Extensions de fichier à ignorerPermet d'entrer l'extension de fichiers qui ne seront pas à importer dans Constellio.

      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 au besoin.

      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 rubrique, le champ du gabarit d'importation sera laissé vide et les données devront être corrigées manuellement.

      2.3.1 Détection automatique des rubriques

      Si l'option "Détecter les automatiquement les rubriques" est activée, le client d'importation tentera d'identifier les dossiers locaux qui correspondent à des rubriques de classification dans Constellio.

      • Les dossiers détectés comme des rubriques ne seront pas importés en tant que dossiers dans Constellio.
      • Les dossiers enfants aux dossiers détectés comme des rubriques seront classés dans la rubrique correspondante dans Constellio
      • Des rubriques correspondant aux codes détectés doivent déjà exister dans Constellio
      Note
      Un dossier qui contient directement des documents ou dont le dossier parent n’est pas détecté comme une rubrique ne sera pas détecté comme étant une rubrique, même si son titre correspond à l’expression régulière sélectionnée.


      2.4 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 

      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.

      4. Note de version

      VersionNouvelles fonctionnalitésVersion de Constellio supportéeTéléchargement
      2.10.1
      • Utilisation des certificats de sécurité reconnus par le poste Windows de l'utilisateur
      		11.1.8+https://internal.constellio.me/constellio/dl?id=00000987372
      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://internal.constellio.me/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://internal.constellio.me/constellio/dl?id=00000613671
      2.8
      • Comptabilité avec les options d'importation « cellRange » et « keepExtraWhitespace ».
      • Stabilité amélioré.
      		10.0.3+https://internal.constellio.me/constellio/dl?id=00000527379
      2.7
      • Comptabilité avec la version 10.
      • Amélioration des messages d'erreur.
      		10.0.3+https://internal.constellio.me/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://internal.constellio.me/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
      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