Aller au contenu

Explication

Concepts essentiels

Distinguez modèle, type d’entité, instance, propriété, relation et action.

2 min
ConceptSignificationExemple Client–Commande
Modèle métierDéfinitions partagées d'un domaineClients, commandes et règles de livraison
Type d'entitéStructure réutilisableClient et Commande
InstanceEnregistrement d'un typeClient CLI-001, nommé ACME France
PropriétéValeur portée par une instancenom, montant, devise
RelationLien métier entre des entitésClient passe Commande
ActionOpération définie pour un usagePréparer une intervention autorisée

Les interfaces techniques emploient aussi ObjectType pour un type d'objet et LinkType pour un type de lien. Une propriété de référence ne suffit pas, à elle seule, à expliquer la cardinalité et le cycle de vie d'une relation métier.

Type ou instance ?

Créer le type Client définit des champs ; cela ne crée aucun client réel. Créer l'instance CLI-001 renseigne ces champs pour une occurrence. Dans le Modeler, sélectionnez Client puis ouvrez Instances pour faire cette distinction.

Changer la définition d'une propriété peut affecter les formulaires, les intégrations et les données existantes. Ajouter une contrainte n'est pas une correction automatique de toutes les anciennes instances. Vérifiez l'impact d'une évolution.

Propriété ou relation ?

Utilisez une propriété pour une valeur sans identité propre : le montant de la commande. Précisez son unité et sa devise. Utilisez une relation lorsque la cible est un concept que vous devez identifier et consulter : le Client auquel appartient la Commande.

Un nom de client stocké comme texte dans une commande ne permet pas de distinguer deux homonymes. Préférez une correspondance reposant sur un identifiant stable.

Définition, données et preuve

Le schéma indique ce qui est attendu. L'instance donne une valeur réelle. La provenance explique d'où vient cette valeur. Un document peut apporter une règle ou une justification sans être automatiquement transformé en instance.

Pour vérifier votre compréhension, retrouvez CLI-001, ouvrez sa fiche et identifiez : son type, ses propriétés renseignées, sa provenance et ses liens. Si aucun lien vers une commande n'existe, ne déduisez pas qu'il existe à partir du seul nom.

Continuez avec le quickstart interface ou le guide de conception.

Cette page vous a-t-elle permis d’atteindre votre objectif ?