13. Nommage des balises XML

Adapter parfaitement le langage SOOKSOOK au langage de l’ERP

Le nommage des balises XML est une étape essentielle dans la construction d’un flux d’intégration ERP.

Contrairement à une idée reçue, le plus important dans un XML n’est pas seulement la donnée…
👉 c’est la manière dont elle est nommée et structurée.

Chaque système cible (SAP, Oracle, middleware, API interne…) attend :

• des noms précis

• des formats spécifiques

• des conventions strictes

👉 Une mauvaise balise = un flux rejeté.

---

Principe général

Dans SOOKSOOK, chaque donnée terrain (ex : priorité, machine, description…) doit être associée à une balise XML.

Mais cette balise :

❌ n’est pas imposée
✔ est entièrement paramétrable

👉 Cela permet d’adapter le flux à n’importe quel système cible.

---

Objectif du nommage

Le nommage des balises permet de :

• garantir la compatibilité avec l’ERP

• respecter les standards techniques

• faciliter l’intégration automatique

• éviter les erreurs de traitement

👉 C’est un point critique de réussite de l’intégration.

---

13.1 Adapter le nom des balises au système cible

🔹 Principe

Chaque ERP possède son propre “langage”.

👉 Il ne suffit pas d’envoyer une donnée,
👉 il faut l’envoyer avec le bon nom.

---

🔹 Exemples concrets

Cas 1 – SAP

SOOKSOOK :

• priorité

SAP attend :

• PRIOR

---

Cas 2 – Oracle

SOOKSOOK :

• machine

Oracle attend :

• ASSET_ID

---

Cas 3 – Middleware

SOOKSOOK :

• texte long

Middleware attend :

• DESCRIPTION_LONG

---

👉 Même donnée, noms différents.

---

🔹 Explication

Le système SOOKSOOK agit comme un traducteur intelligent :

👉 langage terrain → langage ERP

---

13.2 Définition du nom exact des balises

🔹 Principe

Chaque balise peut être configurée précisément dans l’interface.

👉 Tu définis :

• le nom exact

• la casse (majuscule/minuscule)

• le format

---

🔹 Exemple

ou

👉 dépend du système cible.

---

🔹 Importance

Certains systèmes sont très stricts :

• PRIOR ≠ prior

• PLANT ≠ SITE

👉 une erreur de nom = rejet du flux

---

13.3 Modification et adaptation dynamique

🔹 Principe

Le système permet de modifier les balises à tout moment.

👉 sans modifier le code
👉 sans redéployer

---

🔹 Cas d’usage

• changement de standard ERP

• migration SAP → autre système

• évolution des règles internes

---

🔹 Exemple

Avant :

Après :

👉 modification simple via interface

---

🔹 Avantage

✔ grande flexibilité
✔ adaptation rapide
✔ aucun impact sur les utilisateurs terrain

---

13.4 Adaptation multi-sites / multi-clients

🔹 Principe

Chaque site ou client peut avoir ses propres règles.

👉 Le même champ SOOKSOOK peut être envoyé différemment selon le contexte.

---

🔹 Exemple

Site FOS

---

Site DUNKERQUE

---

👉 même donnée → structure différente

---

🔹 Intérêt

✔ gestion multi-sites
✔ gestion multi-clients
✔ adaptation sans duplication

---

13.5 Nommage spécifique selon les flux

🔹 Principe

Un même système peut gérer plusieurs types de flux :

• maintenance

• sécurité

• production

• inspection

👉 Chaque flux peut avoir ses propres balises.

---

🔹 Exemple

Flux maintenance

---

Flux sécurité

---

👉 logique totalement adaptable

---

13.6 Normalisation et bonnes pratiques

🔹 Règles recommandées

Pour garantir un système robuste, il est conseillé de :

✔ utiliser des noms cohérents
✔ éviter les variations inutiles
✔ documenter les balises
✔ respecter les standards ERP

---

🔹 Exemple de standard

• majuscules pour SAP

• underscore pour middleware

• camelCase pour API

---

🔹 Objectif

👉 rendre le système lisible, maintenable et fiable

---

13.7 Impact sur l’intégration ERP

Le nommage des balises a un impact direct sur :

• la réception du fichier

• l’interprétation des données

• la création des objets ERP

---

🔹 Cas d’erreur

❌ balise incorrecte → flux rejeté
❌ balise inconnue → ignorée
❌ mauvaise structure → erreur système

---

🔹 Cas correct

✔ balise conforme → intégration automatique
✔ données reconnues → objet créé

---

Vision globale

Le nommage des balises est la couche de traduction entre :

👉 le terrain (SOOKSOOK)
et
👉 le système ERP

---

👉 SOOKSOOK permet :

• de s’adapter à tous les systèmes

• de parler leur langage

• de garantir l’intégration

---

Conclusion du chapitre

Le nommage des balises XML n’est pas un détail technique.

👉 C’est un élément stratégique.

Il permet :

✔ la compatibilité
✔ la flexibilité
✔ la fiabilité
✔ l’évolutivité

---

👉 Grâce à cette logique, SOOKSOOK devient :

💥 un traducteur universel entre le terrain et les systèmes ERP