HelperStable

Exactly one

Transforme une collection en objet unique uniquement lorsque sa cardinalité vaut exactement un.

Collection typée
Exactly one
Collection
Résultat typé

Vue d’ensemble

Transforme une collection en objet unique uniquement lorsque sa cardinalité vaut exactement un.

Exemple

Après avoir filtré des factures par référence, exiger qu’une seule facture corresponde avant de poursuivre un traitement irréversible.

Paramètres 1

itemsRequisobject[]
Collection typée fournie par un binding. Le type concret des éléments est conservé ou unifié dans les sorties.

Sorties 1

itemobject
Élément unique de la collection, avec son type concret.

Comportement

La sortie conserve le type concret des éléments. Une liste vide ou contenant plusieurs éléments fait échouer le node.

À retenir Les opérations de collection conservent la classification des données portées par leurs éléments ; filtrer, trier ou concaténer une liste n’est pas une déclassification.

Limites et responsabilités

  • Utilisez ce node quand l’unicité est une garantie métier, pas simplement pour prendre arbitrairement le premier élément.
  • Une ambiguïté est traitée comme une erreur explicite du processus.