Exemple d'utilisation du client d'importation

1. Préparation

1. Télécharger la version la plus récente du client d’importation compatible avec la version de votre environnement Constellio à partir de la page suivante «Client d'importation»;
2. Extraire le contenu du fichier zip téléchargé 

2. Configuration du client d’importation

1. Naviguer dans le dossier « configurations » puis ouvrir le fichier « config.properties » dans un éditeur de texte;
2. Modifier les valeurs des paramètres « server.port » et « server.host » et y saisir les informations de votre environnement Constellio;
   Si votre environnement est en HTTPS, il faut également mettre la valeur de la configuration « auth.connectUsingSSL » à true; 
   Par exemple, pour un environnement Constellio accessible à l’adresse https://client.cloud.constellio.com/constellio/ sur le port 443, le fichier de configurations devrait être configuré ainsi : 

1. Inscrire le code de la collection Constellio dans laquelle les enregistrements doivent être importés au paramètre « import.collection » 
2. Les autres paramètres d’importation et exportation peuvent également être modifiés directement dans le fichier de configurations, mais il est recommandé de les saisir à partir de l’outil (Détaillé dans les sections 4 et 5)

3. Démarrer le client d’importation

1. Ouvrir le fichier « start-program.bat » pour démarrer le programme d’importation;
2. Inscrire votre nom d’utilisateur et mot de passe Constellio, puis cliquer sur « Entrée ». Il s’agit du même authentifiant que vous utilisez pour vous connecter à l’interface web Constellio;

4. Générer un gabarit d’importation à partir d’un répertoire

1. À partir du menu principal, saisir « 2 » pour naviguer vers le menu de l’utilitaire d’exportation de partage réseau;
2. Saisir « 2 » pour naviguer vers la page de configurations. Les configurations actuelles seront affichées. Si celles-ci semblent correctes, sautez directement à l’étape h;
3.  Saisir « 1 » pour modifier les configurations;
4. Saisir le chemin à la racine du partage réseau ou répertoire que vous voulez importer dans Constellio;
5. Saisir le code de l’unité administrative dans laquelle les dossiers et documents importés doivent être classés;
6. Si vous voulez utiliser une expression régulière pour détecter automatiquement les dossiers de votre partage réseau qui doivent correspondre à des rubriques dans Constellio, saisir « 1 » pour sélectionne l’option « Utiliser une expression régulière »;
7. Si vous ne voulez pas détecter automatiquement les rubriques, saisissez « 2 » pour sélectionner l’option « Utiliser une rubrique par défaut », puis inscrire le code de la rubrique dans laquelle tous les dossiers/documents de votre partage réseau doivent être classés, puis sauter directement à l’étape « i »;
8. Saisir l’expression régulière qui permet de d’identifier le « pattern » du titre de vos dossiers;Par exemple, pour que les dossiers suivants soient considérés comme des rubriques, il faudrait saisir l’expression régulière « ^[0-9]{2}-[0-9]{3} - .* »

i. Vérifier que toutes les configurations sont bonnes, puis saisir « 1 » pour sélectionner « Générer le fichier d’importation »;

j. Se rendre dans le répertoire où le fichier a été généré, puis ouvrir le fichier avec Excel;Valider les informations générées dans le fichier. L’onglet « folder » correspond à tous les dossiers et sous-dossiers de votre répertoire et l’onglet « document » correspond à tous les fichiers de votre répertoire.
Au besoin,  vous pouvez modifier les valeurs ou ajouter de nouvelles métadonnées à ce gabarit avant d’effectuer l’importation. 
Consulter la page sur les gabarits d’importation pour plus de détails à ce sujet. 

1. À partir du menu principal, saisir « 1 » pour naviguer vers la page de l’utilitaire d’importation;
2. Saisir « 2 » pour inscrire les configurations d’importation. Si l’importation a déjà été configurée précédemment, sautez directement à l’étape f;
3. Un menu permettant de définir le fichier de source et le fichier temporaire sont affichés. Saisir « 1 » naviguer vers le menu « Définir le fichier source »;

d. Vérifier que le fichier source correspond au gabarit généré à l’étape 4. S’il est différent, sélectionner « Utiliser un autre fichier », puis inscrire le chemin complet du gabarit à importer;
Attention :  Il faut inscrire le chemin complet du fichier, incluant le nom du fichier et son extension.

e. Saisir « 3 » pour revenir au menu de l’utilitaire d’importation;

f. Saisir « 1 » pour sélectionner l’option « Lancer l’importation des contenus », puis attendre la fin de l’importation.