Get metadata value
Extrait une clé de metadata et affine son type pour rendre la valeur exploitable par des bindings typés.
Metadata + clé
Get metadata value
Lecture stricte
Valeur typée
Vue d’ensemble
La map metadata accepte plusieurs types scalaires. get_metadata_value rend le choix de type explicite afin qu’un processus ne propage pas une valeur libre là où un email, un montant ou une date sont attendus.
Exemple
Lire customer_reference comme string ou callback_url comme common.url avant de transmettre la valeur à un node dont le contrat exige ce type.
Paramètres 3
metadata
Map
common.metadata contenant la clé à lire.key
Clé exacte à extraire de la map metadata.
expected_type
Type scalaire attendu pour la valeur. Le node valide la valeur existante ; il ne convertit pas silencieusement une valeur incompatible.
Sorties 1
value
Valeur de la clé avec le type s électionné par
expected_type, après validation stricte.Comportement
Lire la clé
Le node exige que la clé existe dans la map.
Valider le type
La valeur est vérifiée contre expected_type sans coercition implicite.
Affiner le binding
La sortie adopte le type sélectionné pour les validations et suggestions en aval.
Limites et responsabilités
- Une clé absente fait échouer le node ; il n’existe pas de valeur de repli implicite.
- Une valeur incompatible avec
expected_typeest refusée plutôt que convertie. - Pour plusieurs clés, utilisez plusieurs lectures explicites ou préférez un vrai objet métier si le contrat devient structuré.