Passer au contenu principal
Les étiquettes classent vos entités ; les règles de tagging les assignent automatiquement. Les étiquettes alimentent les alertes et les déclencheurs de workflow, ce qui en fait la moitié « classifier » de ingérer → classifier → automatiser. Pour le guide utilisateur, voir Étiquettes & règles de tagging.

Modèle d’étiquette

ChampSignification
nameNom de l’étiquette (unique par organisation).
typeGenre : DATA (assignée automatiquement par les règles), BUSINESS (classification manuelle), ou MIXED.
colorCouleur optionnelle pour l’interface.
descriptionOptionnel.
labelsMétadonnées libres optionnelles (tableau de chaînes).
Une étiquette est appliquée à une entité via une assignation d’étiquette :
ChampSignification
tagIdL’étiquette.
resourceId + resourceTypeL’entité et son type : PRODUCT, BRAND, VARIANT, INVENTORY_ITEM.
Les assignations sont uniques sur (tagId, resourceId, resourceType, organizationId) — une étiquette ne peut être présente sur une entité qu’une seule fois.

Forme d’une règle de tagging

Une règle lie une étiquette à un ensemble de conditions (et optionnellement une portée) :
ChampSignification
tagIdL’étiquette que cette règle assigne.
nameNom de la règle (également la clé de correspondance stable lors de l’upsert).
descriptionOptionnel.
conditionsCe qui doit être vrai — voir Conditions.
scopeLes entités à évaluer et la propagation — voir Portée & propagation.
isActiveSi la règle s’exécute dans les évaluations automatisées.
{
  "name": "Auto-tag: Stockout in 7 days",
  "tagId": "<uuid>",
  "conditions": { "operator": "AND", "rules": [ /* … */ ] },
  "scope": { "entityType": "INVENTORY_ITEM" },
  "isActive": true
}
Une règle n’a pas de genre propre — elle hérite du type de son étiquette. Plusieurs règles peuvent cibler la même étiquette.

Comment les règles s’appliquent

Les étiquettes ne sont pas appliquées en direct à la modification ; elles sont (re)calculées par une exécution d’évaluation d’étiquette qui évalue les règles actives et crée/supprime les assignations en conséquence — voir Exécutions & exemples.