---
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