> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/produit/multigest/administration/module-dimport-standard.md).

# Module d'import standard

## Préambule

Le programme d'import de documents a été conçu pour importer dans MultiGest des documents de différentes provenances :

* Documents produits par des outils de prestation de numérisation
* Documents produits par un système type « eCopy »

Ce programme peut traiter différentes sources de données destinées à différentes destinations (armoires de MultiGest) grâce à la création de modèles d'import.

Tous ces imports sont tracés :

* Dans MultiGest par les logs de l'observateur d'évènements
* Dans les logs de traitement du module d'import

## Fonctionnement général

Deux modes de fonctionnements sont disponibles :

### Fonctionnement via l’IHM

L'IHM permet d'administrer les modèles d'import et de réaliser les traitements d'import :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-b15185dc6565dda49f57c97370415f84b491862f%2Fmg-admin-module-dimport-standard-02.webp?alt=media" alt=""><figcaption></figcaption></figure>

Les modèles créés sont enregistrés dans le répertoire d'installation du Module d'Import Standard (Ex : D:\GED\Import Standard) dans le sous-répertoire « Modèles ». Ces modèles sont des fichiers avec une extension « .mds ». **Ils ne doivent pas être supprimés**.

Les logs de traitement sont enregistrés dans le répertoire d'installation du Module d'Import Standard dans le sous-répertoire « Logs ».

### Fonctionnement en Mode Silencieux

Pour ce fonctionnement, le programme doit être exécuté avec des arguments passés en ligne de commande, soit depuis un fichier « bat », soit depuis un raccourci.

Ce mode peut être couplé aux tâches planifiées Windows pour un fonctionnement 100% automatique.

Exemple : ImportMgest.exe –M\[Nom du modèle] –U\[Utilisateur]

⚠️ Le mode automatique requiert des procédures qui permettent de s'assurer que l'on n'importe pas deux fois les mêmes documents.

## Description des sources de données

Les sources de données pouvant être importées avec ce programme peuvent être importées de deux manières.

### Fichier de description « csv » et documents

Les documents et le fichier csv sont placés dans le répertoire d'import.

Ce fichier csv doit posséder pour chaque ligne les données suffisantes pour décrire :

* Les données qui vont permettre de créer ou de rechercher l'index MultiGest pour auquel les documents seront associés
* L'emplacement du document lié à chaque ligne du csv

Ce fichier peut également contenir des métadonnées qui décrivent le classement du document dans le dossier où il sera importé. Ces métadonnées sont les suivantes :

* Sous-dossier de classement
* Sous-sous-dossier de classement
* Nom du fichier

### Documents seuls

Dans ce cas, c'est le nom du document qui précise les données qui vont permettre de créer ou de rechercher un dossier dans MultiGest.

### Documents produits par eCopy

Les documents produits par eCopy sont créés selon un format standard préconisé par EFALIA.

Chaque document produit est associé à un fichier csv portant le même nom que le document.

Ce fichier csv possède également des données pour créer ou rechercher l'index et peut contenir des métadonnées.

## Création et modification de modèles

Il faut cliquer sur ce bouton pour créer un nouveau modèle

<img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-2f6f1b6d12bf166bf956d6be1ff22b57ffb96526%2Fmg-admin-module-dimport-standard-03.jpeg?alt=media" alt="" width="24">

L'écran suivant permet de gérer ce modèle d'import. La définition d'un modèle se fait en deux étapes :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-425cbc8b34508276c972e03455a725567521976b%2Fmg-admin-module-dimport-standard-05.webp?alt=media" alt=""><figcaption></figcaption></figure>

### Zone d’informations générales du modèle

Cette zone permet de définir les options générales de l'import.

Tous les champs suivants sont obligatoires :

* Le nom du modèle
* L'armoire MultiGest de destination
* Le répertoire contenant les données à importer (Ex : D:\GED\IMPORT)

⚠️ Le chemin des armoires se renseigne automatiquement à la sélection de l'armoire. Selon le poste depuis lequel le programme est exécuté, ce chemin peut être modifié.

Suite aux renseignements des précédentes valeurs, il faut définir le mode de classement des documents importés (uniquement dans le cas des armoires en mode dossier).

* **Table de correspondance de classement (\*.csv)** : Cette table de reclassement est un fichier csv de 6 colonnes (avec séparateur « ; » et caractère de fin de ligne « ; »)
* Sous-dossier du document source
* Sous-sous-dossier du document source
* Nom du document source (sans extension)
* Sous-dossier du document destination
* Sous-sous-dossier du document destination
* Nom du document destination (sans extension)

Exemple d'un fichier de reclassement :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-64764fdc25a5ff9e11220305493c953ea9fb4d56%2Fmg-admin-module-dimport-standard-07.webp?alt=media" alt=""><figcaption></figcaption></figure>

* **Définition d'un classement par défaut** : il s'agit d'une chaine de caractères qui décrit le sous-dossier, sous-sous-dossier et nom du fichier (sans extension) qui correspond au plan de classement. Le séparateur est le « / ».

Exemple : 01- Administratif/01- Commerce/Facture

* **Reconnaissance de codes à barres MultiGest** : Cette option permet d'utiliser la fonctionnalité des codes à barres MultiGest
* **Déplacer les fichiers sources à la fin de l'import** : Cette option permet de déplacer les données importées dans le répertoire « History » créé automatiquement dans le répertoire d'import.

Pour chaque import, un répertoire « Import du JJ-MM-AAAA HH- MM-SS » est créé dans ce répertoire « History ».

⚠️ Cette option nécessite de contrôler l'espace disque disponible et de réaliser fréquemment des purges.

### Zone de description des données à importer

Les autres champs de cette interface permettent de décrire le type d'import et le type de fichier csv.

* **Source de données** :

**Fichier CSV** : un fichier « csv » accompagne les documents à importer. Ce fichier « csv » se trouve **toujours** dans le même répertoire que les documents.

**Nom du document** : le nom du document est construit avec des données qui seront utilisés pour l'import pour créer ou rechercher des dossiers MultiGest

**eCopy** : chaque document est accompagné d'un fichier « csv ». Le document et le fichier « csv » portent le même nom.

* **Type d'import** :

**Création uniquement** : pour chaque document, un index GED est créé à partir des données contenues dans le fichier « csv » ou dans le nom du document

**Matching uniquement** : les données du fichier « csv » ou contenues dans le nom du document vont permettre de chercher le dossier dans lequel le document doit être importé. Si la recherche ramène plusieurs dossiers, le document est rejeté

**Création et matching** : les données du fichier « csv » ou contenues dans le nom du document vont permettre de vérifier si le dossier existe déjà. S'il n'existe pas, il est créé.

Les champs **« séparateur »** et **« caractère de fin de ligne »** permettent d'extraire les données du fichier « csv » ou contenues dans le nom du document.

* Le champ **« La première ligne est un descripteur »** permet d'indiquer que la première ligne du fichier csv n'est pas à importer et sert seulement à décrire les colonnes du fichier « csv ».
* Il faut cliquer sur le bouton **« Description des données »** pour pouvoir paramétrer les correspondances.

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-6d6edeff8ac8e5fb757510a33a08272541c2c43b%2Fmg-admin-module-dimport-standard-09.webp?alt=media" alt=""><figcaption></figcaption></figure>

Dans un premier temps, il faut définir le nombre de colonnes du fichier « csv » ou contenues dans le nom du document.

Pour chaque champ, il s'agit d'indiquer quel rôle jouera ce champ lors de l'import :

Chemin relatif du ou des documents

Inutilisé

Sous-dossier de classement (mode dossier seulement)

Sous-sous-dossier de classement (mode dossier seulement)

Nom du fichier (mode dossier seulement)

Champ de l'armoire pour la création par défaut et pour le matching si la case à cocher **« Champ de matching »** est activée

## Lecture des logs de traitement

Pour chaque import, un fichier de log est créé dans le répertoire d'installation de l'import standard : « JJ-MM-AAAA HH-MM-SS.log »

Exemple d'un fichier de log :

<figure><img src="https://3557286639-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcnnXLnfB61CBUw4H9Fho%2Fuploads%2Fgit-blob-3a08a9ecbc2134464d08253dd0e6977c56345854%2Fmg-admin-module-dimport-standard-11.webp?alt=media" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://documentation.efalia.com/produit/multigest/administration/module-dimport-standard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
