====== Présentation du procédé d'export ======

L'export présenté ici va permettre d'exporter l'ensemble des données et fichiers qui sont présentés au travers  de requête. 

Il repose sur l'utilisation de deux scripts:
  - export_ezged_prepare.py
  - export_ezged.py


====== Où trouver les scripts ? ======

Les scripts sont situé dans le dossier suivant:
<code>
<lecteur>:\nchp\usr\local\stable\ezged\bin\scripts\tools
</code>


====== Usage ======

===== Générer la configuration de l'export =====

La première étape consiste à générer le fichier de configuration (au format json) qui décrira quoi exporter.
On utilise pour cela le script **//export_ezged_prepare.py//**

Le script va parcourir les requpêtes définies dans EzGED et construire un fichier de configuration nommé //export_prepare.json//

On appel le script de la manière suivante:
<code>
python export_ezged_prepare.py
</code>

Dans ce fichier on trouvera des strings sous forme **[FSFILE_ONAME]** qui sera remplacé par le script //export_ezged.py//.
On peut modifier le nom du document et/ou le dossier de sorti en remplaçant les strings dans les **"[]"**

Le script export_ezged peut avoir comme paramètre un mode debug. Pour l'activer: **python export_ezged.py 1**
les documents exportés seront dans le path: nchp\var\spool\ezged\instance\export

===== Modifier la configuration =====

Pour modifier la configuration de l'export il faut ouvrir le fichier ezged_prepare.json qui a été généré via le script //export_ezged_prepare.py//

Ci-dessous un exemple de fichier de configuration.

<file json export_prepare.json>
{
    "export_dir": "D:\\nchp\\var\\spool\\foo\\instance\\export", 
    "queries": {
        "671": {
            "QRY_DESC": "Mes Documents a indexer", 
            "QRY_FILENAME": "[FSFILE_ONAME]", 
            "QRY_FILEPATH_TEMPLATE": "[year(one.ONE_DATE)]\\[LSTDOSONE_LIB]\\[LSTTYPDOCONE_LIB]\\", 
            "QRY_FLD": {
                "1": {
                    "alias": "", 
                    "desc": "Dossier", 
                    "ffqn": "LSTDOSONE_LIB", 
                    "misc": ""
                }, 
                "2": {
                    "alias": "", 
                    "desc": "Type de Document", 
                    "ffqn": "LSTTYPDOCONE_LIB", 
                    "misc": ""
                }, 
                "3": {
                    "alias": "", 
                    "desc": "Tiers", 
                    "ffqn": "LSTTIERSONE_LIB", 
                    "misc": ""
                }, 
                "4": {
                    "alias": "", 
                    "desc": "Titre", 
                    "ffqn": "ONE_LIB", 
                    "misc": ""
                }, 
                "5": {
                    "alias": "", 
                    "desc": "Date", 
                    "ffqn": "ONE_DATE", 
                    "misc": ""
                }, 
                "6": {
                    "alias": "", 
                    "desc": "Recherche", 
                    "ffqn": "ONE_TEXTE", 
                    "misc": ""
                }, 
                "7": {
                    "alias": "", 
                    "desc": "Annee", 
                    "ffqn": "", 
                    "misc": "year(one.ONE_DATE)"
                }
            }, 
            "QRY_MAINFFQN": "one.ONE_ID"
        }, 
        "681": {
            "QRY_DESC": "contrats", 
            "QRY_FILENAME": "[FSFILE_ONAME]", 
            "QRY_FILEPATH_TEMPLATE": "[CONTRATS_ID]\\[CONTRATS_NUM]\\[CONTRATS_DATE]\\", 
            "QRY_FLD": {
                "1": {
                    "alias": "", 
                    "desc": "ID", 
                    "ffqn": "CONTRATS_ID", 
                    "misc": ""
                }, 
                "2": {
                    "alias": "", 
                    "desc": "NUM", 
                    "ffqn": "CONTRATS_NUM", 
                    "misc": ""
                }, 
                "3": {
                    "alias": "", 
                    "desc": "DATE", 
                    "ffqn": "CONTRATS_DATE", 
                    "misc": ""
                }, 
                "4": {
                    "alias": "", 
                    "desc": "DATESCAN", 
                    "ffqn": "CONTRATS_DATESCAN", 
                    "misc": ""
                }, 
                "5": {
                    "alias": "", 
                    "desc": "RECHERCHE", 
                    "ffqn": "CONTRATS_RECHERCHE", 
                    "misc": ""
                }, 
                "6": {
                    "alias": "", 
                    "desc": "DISTRIBID", 
                    "ffqn": "CONTRATS_DISTRIBID", 
                    "misc": ""
                }, 
                "7": {
                    "alias": "", 
                    "desc": "CLIENTID", 
                    "ffqn": "CONTRATS_CLIENTID", 
                    "misc": ""
                }, 
                "8": {
                    "alias": "", 
                    "desc": "Export", 
                    "ffqn": "CONTRATS_EXPORT", 
                    "misc": ""
                }
            }, 
            "QRY_MAINFFQN": "contrats.CONTRATS_ID"
        }, 
    }
}
</file>

==== Les paramètres principaux ====


**export_dir**: le chemin racine de l'export

Pour chaque requête:

**QRY_DESC**: description de la requête qui servira à nommer le dossier d'export de cette requête.
**QRY_FILENAME**: un pattern de renommage des fichiers. Par défaut la configuration définit //[FSFILE_ONAME]// ce qui signifie que l'on utilise le nom d'origine du fichier.
**QRY_FILEPATH_TEMPLATE**: pattern du chemin (à partir du répertoire d'export de la requête) pour écrire les fichiers et métadonnées de chaque fiche descriptive.

===== Déclencher l'export =====

Après avoir ajusté le fichier de configuration si besoin, on procède au déclenchement de l'export en exécutant la commande suivante:

Si on souhaite activer le mode debug on l'appel comme ça:
<code>
python export_ezged.py 1
</code>