Set metadata
Met à jour la metadata libre d’un objet plateforme persisté, puis retourne l’objet rechargé après écriture.
Objet + metadata
Set metadata
Écriture explicite
Objet mis à jour
Vue d’ensemble
set_metadata est destiné aux informations libres de l’intégrateur. Une donnée dont Ormuz dépend pour son comportement doit rester dans un champ canonique de l’objet, pas dans metadata.
Exemple
Conserver sur une facture une référence de campagne ou un indicateur propre à votre système sans modifier le modèle métier canonique.
Paramètres 3
resource
Objet plateforme persisté dont les metadata doivent être mises à jour. Le node conserve le type concret de cet objet dans sa sortie.
metadata
Dictionnaire plat
common.metadata à écrire. Les valeurs sont limitées aux scalaires autorisés par le contrat metadata Ormuz.strategy
merge conserve les clés absentes de la requête et remplace les clés fournies ; replace remplace la map complète par celle fournie.Sorties 1
resource
Objet plateforme rechargé après la mise à jour de sa metadata.
Comportement
Valider l’objet et la map
Le node exige un objet plateforme persisté et applique les limites communes de common.metadata avant toute écriture.
Appliquer la stratégie
merge fusionne clé par clé ; replace remplace la map complète.
Relire l’objet
La sortie est l’objet canonique rechargé après l’écriture, afin que les nodes suivants utilisent son état actuel.
À retenir Écrire une donnée protégée dans une metadata déclarée normale constitue une frontière de déclassification et peut exiger un consentement explicite.
Limites et responsabilités
- Metadata est une map plate : objets imbriqués, tableaux et
nullne sont pas autorisés. - Ce node n’est pas un mécanisme de schéma métier extensible : utilisez un champ canonique lorsqu’une information pilote le comportement de la plateforme.
replacesupprime les clés absentes de la nouvelle map ; utilisezmergepour une mise à jour incrémentale.