┌──────────────────────────────────────────────┐
│ Packages │
│ → Ce sont des "dossiers" où tu ranges │
│ toutes tes personnalisations GraphQL. │
│ (Comme un classeur pour tes développements)│
└───────────────┬──────────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Data Models │
│ → C’est le plan qui décrit quelles données │
│ (champs, objets) tu veux exposer via │
│ l’API. (Comme la fiche d’identité de tes │
│ données) │
└───────────────┬──────────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Node Bindings │
│ → C’est le lien entre ton plan (Data Model) │
│ et les vraies données dans X3 (tables, │
│ vues, scripts). (Comme le câble qui relie │
│ la théorie à la pratique) │
└───────────────┬──────────────────────────────┘
│
▼
┌──────────────────────────────────────────────┐
│ Binding Dictionary │
│ → C’est la liste de tous les liens créés │
│ entre tes modèles et les données réelles. │
│ (Comme un sommaire ou une carte de tes │
│ connexions) │
└───────┬─────────────┬────────────────────────┘
│ │
▼ ▼
┌──────────────────────────────┐ ┌──────────────────────────────┐
│ Operations │ │ Enum Exceptions │
│ → Ce sont les actions │ │ → Ce sont les adaptations │
│ spéciales que tu ajoutes │ │ pour les listes de choix │
│ à l’API (créer, modifier, │ │ (ex : statuts, types), │
│ supprimer) via des │ │ pour que les noms soient │
│ programmes ou imports. │ │ clairs et adaptés à tes │
│ (Comme des boutons │ │ besoins. (Comme renommer │
│ personnalisés) │ │ une option dans un menu) │
└──────────────────────────────┘ └──────────────────────────────┘
Résumé simplifié des rôles (depuis 2024 R1)
Packages : Le dossier où tu ranges toutes tes personnalisations. Un code d’activité
par package
Pour les noms des packages ne doivent pas commencer par un numéro
si jamais on a un problème sur un package lorsqu’on debug => Penser à
désactiver le package pour générer les autres package
Tous les éléments doivent appartiennent au même Module (vente par exemple)
il y a une vérification de Module parle système
Data Models : Le plan qui décrit les données à exposer.( commence par API pour
les modèles standards )
Node Bindings : Le lien entre ton plan (Data Models ) et les vraies données
X3(Tables et Views
Scripts,JSON Imports Templates, Windows, Enum Exceptions).
=> apr
le Validation bouton déclenche la régénération du Binding metadata complet
(Validation global)
C'est metadata ce que dans X3 Dev Pack utilise pour générer le code TypeScript
à l'intérieur de notre
NodeJS Package , contenant Nodes notre Properties .
Binding Dictionary : La carte de tous tes liens.
Operations : Les actions spéciales (mutations) que tu ajoutes.
Enum Exceptions : Les adaptations pour les listes de choix (pour que ce soit plus
clair côté API).
Astuce de compréhension :
Imagine que tu construis une maison (ton API) :
Packages = Le classeur de tes plans et modifications.
Data Models = Les plans de chaque pièce.
Node Bindings = Les câbles qui relient les plans aux vraies pièces.
Binding Dictionary = La carte de tous les câbles.
Operations = Les interrupteurs ou boutons spéciaux que tu ajoutes.
Enum Exceptions = Les étiquettes personnalisées sur les interrupteurs.