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
| Champ | Signification |
|---|
name | Nom de l’étiquette (unique par organisation). |
type | Genre : DATA (assignée automatiquement par les règles), BUSINESS (classification manuelle), ou MIXED. |
color | Couleur optionnelle pour l’interface. |
description | Optionnel. |
labels | Métadonnées libres optionnelles (tableau de chaînes). |
Une étiquette est appliquée à une entité via une assignation d’étiquette :
| Champ | Signification |
|---|
tagId | L’étiquette. |
resourceId + resourceType | L’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.
Une règle lie une étiquette à un ensemble de conditions (et optionnellement une portée) :
| Champ | Signification |
|---|
tagId | L’étiquette que cette règle assigne. |
name | Nom de la règle (également la clé de correspondance stable lors de l’upsert). |
description | Optionnel. |
conditions | Ce qui doit être vrai — voir Conditions. |
scope | Les entités à évaluer et la propagation — voir Portée & propagation. |
isActive | Si 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.
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.