Arthur Ria
90 lines
5.2 KiB
Markdown
90 lines
5.2 KiB
Markdown
---
|
|
title: "uGNA Data Export (WMS Configuration → Git)"
|
|
type: operation
|
|
sources:
|
|
- sources/archives/Export_donnees_uGNA.md
|
|
related:
|
|
- operations/git-workflow.md
|
|
- operations/gna-services-license.md
|
|
- operations/first-deployment.md
|
|
- operations/deployment-existing-app.md
|
|
last_compiled: "2026-04-17"
|
|
---
|
|
|
|
# uGNA Data Export (WMS Configuration → Git)
|
|
|
|
## Overview
|
|
|
|
Procédure interne Mecalux EasyWMS France pour **exporter la configuration / les données du WMS** (paramètres, profils, master data, etc.) depuis une VM via **uGNA Console**, et les commiter dans le Git du projet (dossier `..\test`).
|
|
|
|
À exécuter **systématiquement** avant tout commit dès qu'une nouvelle configuration, transporteur, paramètre ou autre master data a été ajouté(e) ou modifié(e) sur la VM. C'est l'une des trois étapes pré-commit (avec l'export custom app et la sauvegarde GNA si BOO modifiés) listées dans [git-workflow](git-workflow.md#étape-préalable--exporter-les-modifications).
|
|
|
|
Source : Confluence EasyWMS France — *Export des données via uGNA* (v5, 18/10/2023).
|
|
|
|
## ⚠️ Prérequis : VM à jour
|
|
|
|
> ⚠️ Si on exporte depuis une VM **qui n'est pas à jour** par rapport au Git, on risque d'exporter des données qui auraient pu être **supprimées** (régression silencieuse). **Pull** + redéploiement de la branche avant tout export.
|
|
|
|
## Procédure d'export
|
|
|
|
1. Ouvrir une **Invite de commandes** (CMD, **pas** PowerShell) **en administrateur**
|
|
2. Exécuter :
|
|
|
|
```
|
|
"C:\Program Files (x86)\Mecalux\uGNA\uGNAConsole.exe" -Z:abc,account,accounttype,adjustreason,agency,alias,carrierselectionconfiguration,company,containerlocktype,countprofiles,cuttingprofile,deliveriescarrier,divtype,hazzardclass,kit,locationlocktype,logisticprofile,outboundclass,outboundordercancelconfiguration,owner,inboundclass,packagingstages,parameter,pickingstationconfig,printerstationconfig,product,productfamily,productlocation,productype,putawayprofile,putawayrestriction,putawaystrategy,receptionprofile,replenishmentstrategy,shippingprofile,ShippingProfileAssignmentStrategy,shiptemplate,stockassignstrategy,stockassignstrategyV2,stockclassificationbyzone,stockstatus,suppliertype,supplier,transactiontype,uom
|
|
```
|
|
|
|
3. Récupérer les fichiers XML générés dans :
|
|
|
|
```
|
|
C:\Program Files (x86)\Mecalux\uGNA\Export
|
|
```
|
|
|
|
4. Copier ces fichiers dans le dossier **`..\test`** de la branche Git du projet
|
|
5. **Commit + push** le dossier `..\test` mis à jour
|
|
|
|
## Liste des entités exportées
|
|
|
|
L'option `-Z:` accepte une liste séparée par virgules. La commande standard ci-dessus couvre 41 entités, regroupées ci-dessous par domaine :
|
|
|
|
| Domaine | Entités |
|
|
|---|---|
|
|
| Master data — Owners / Accounts | `owner`, `account`, `accounttype`, `company` |
|
|
| Master data — Items | `product`, `productfamily`, `productype`, `productlocation`, `alias`, `uom` |
|
|
| Master data — Suppliers / Carriers | `supplier`, `suppliertype`, `agency`, `deliveriescarrier`, `carrierselectionconfiguration` |
|
|
| Master data — Kits & Hazards | `kit`, `hazzardclass`, `divtype` |
|
|
| Profils | `logisticprofile`, `receptionprofile`, `putawayprofile`, `shippingprofile`, `cuttingprofile`, `countprofiles` |
|
|
| Stratégies | `putawaystrategy`, `putawayrestriction`, `replenishmentstrategy`, `stockassignstrategy`, `stockassignstrategyV2`, `ShippingProfileAssignmentStrategy`, `stockclassificationbyzone` |
|
|
| Classes & ABC | `inboundclass`, `outboundclass`, `abc` |
|
|
| Stations & Workstations | `pickingstationconfig`, `printerstationconfig`, `packagingstages`, `shiptemplate` |
|
|
| Locks & status | `containerlocktype`, `locationlocktype`, `stockstatus` |
|
|
| Configurations diverses | `parameter`, `transactiontype`, `outboundordercancelconfiguration`, `adjustreason` |
|
|
|
|
> Pour la liste exhaustive des entités exportables (notamment pour des **exports spécifiques**), consulter la doc Confluence dédiée : [uGNA](https://easywmsfrance.atlassian.net/wiki/spaces/EF/pages/25788478).
|
|
|
|
## Common errors
|
|
|
|
### Erreur de droits d'écriture sur le dossier cible
|
|
|
|
Si l'export échoue avec une erreur d'écriture sur `C:\Program Files (x86)\Mecalux\uGNA\` :
|
|
|
|
1. **Clic droit** sur le dossier `C:\Program Files (x86)\Mecalux\uGNA` → **"Propriétés"**
|
|
2. Onglet **"Sécurité"**
|
|
3. Sélectionner votre utilisateur → **"Modifier"**
|
|
4. Cocher **"Contrôle total"** dans la colonne **"Autoriser"**
|
|
5. **"Appliquer"** puis **"OK"**
|
|
6. Relancer la commande d'export
|
|
|
|
### Autres pièges
|
|
|
|
- **PowerShell utilisé au lieu de CMD** → la commande peut casser sur les guillemets / l'option `-Z:`. Toujours utiliser **invite CMD en admin**.
|
|
- **Données exportées contiennent des entrées supprimées** → la VM n'était pas à jour vs Git. Pull + redéploiement avant export.
|
|
- **Oubli du commit/push après export** → l'export reste local. Toujours stager le dossier `..\test` et pousser sur la branche.
|
|
|
|
## Related
|
|
|
|
- [Git Workflow (Git Flow)](git-workflow.md) — étape pré-commit "export uGNA"
|
|
- [GNA, Services & License](gna-services-license.md) — sauvegarde des fichiers BOO du GNA (`GNAGetDataForGit.ps1`), processus distinct de l'export uGNA
|
|
- [First Deployment](first-deployment.md) — l'arborescence `..\test` est consommée à la première installation (`Data: test/`)
|
|
- [Deploy Existing Application](deployment-existing-app.md) — les exports uGNA sont rechargés à chaque redéploiement
|