Ci-dessous, les différences entre deux révisions de la page.
Prochaine révision | Révision précédente | ||
export_ezged [2021/11/16 09:31] jeremy créée |
export_ezged [2023/03/17 09:56] (Version actuelle) |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | Utilisation des scripts pour exporter les queries. | + | ====== Présentation du procédé d'export ====== |
- | On doit utiliser le script //export_ezged_prepare.py//. | + | 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. |
- | Ce script va parcourir les queries et construire un fichier nommé //export_prepare.json// | + | |
- | dans ce fichier on trouvera des strings sous forme **[FSFILE_ONAME]** qui sera remplacé par le script //export_ezged.py//. | + | 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 **"[]"** | On peut modifier le nom du document et/ou le dossier de sorti en remplaçant les strings dans les **"[]"** | ||
Ligne 9: | Ligne 36: | ||
les documents exportés seront dans le path: nchp\var\spool\ezged\instance\export | 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> |