Flux auxiliaires

Les flux auxiliaires permettent une gestion et une exécution plus efficaces des flux parents, comme un flux piloté par événement d'application ou un flux de point de terminaison API.

Les flux auxiliaires sont utiles dans plusieurs scénarios :

  • Vous réutilisez une série d'étapes plusieurs fois dans un seul flux ou à travers plusieurs flux. En déplaçant cette série d'étapes dans leur propre flux auxiliaire, vous n'avez qu'à créer un seul flux qui peut être appelé plusieurs fois. Exécutez ces étapes à partir d'autres flux à l'aide des fonctions Appeler un flux ou Appeler un flux de façon asynchrone.

  • Vous voulez traiter une liste un élément à la fois. Par exemple, vous pouvez exécuter une série d'étapes sur chaque élément de la liste à l'aide de la fonction Pour chaque. Ou, vous pouvez transformer une liste en une nouvelle liste à l'aide de la fonction Mapper.

  • Vous voulez décomposer un gros flux en parties plus petites et plus faciles à gérer.

Utiliser des flux auxiliaires avec des fonctions de liste

Les flux auxiliaires sont utiles pour les fonctions de liste parce qu'ils vous permettent de traiter des éléments individuels dans une liste.

Les flux auxiliaires peuvent avoir :

  • Des entrées qui correspondent au type d'élément dans la liste

  • Des fonctions qui effectuent une tâche sur chaque élément

  • Un retour (trouvé dans la catégorie Contrôle).

Par exemple, vous pouvez convertir un objet en liste d'objets, où chaque paire de clés et de valeurs est convertie en un objet qui comporte à la fois les clés propertyname et propertyvalue. Ce modèle est courant dans les API cloud. où vous préfixez la chaîne propertyname avec la chaîne de texte custom:. Vous pouvez le faire avec un flux auxiliaire. Il accepte une clé, une valeur et une constante préfixe. La constante est la même pour toutes les itérations car le flux parent transmet cette constante au flux d'assistance. Le flux auxiliaire retourne un objet ayant deux clés.

Ce flux, lorsqu'utilisé avec object.map, peut convertir cet objet simple :

{"this":"that","up":"down","left":"right"}

Il retourne le résultat dans une liste plus utile :

[
	{
		"propertyname":"custom:this",
                
		"propertyvalue":"that"
                
	},
                
	{
                
		"propertyname":"custom:up",
                
		"propertyvalue":"down"
                
	},
                
	{
                
		"propertyname":"custom:left",
                
		"propertyvalue":"right"
                
	}
]

Sorties des flux auxiliaires

Chaque carte de flux auxiliaire a les sorties suivantes :

Champ Définition
Entrées pour ce flux Utilisez l'option Cliquez ou glissez pour créer pour ajouter des champs personnalisés. Donnez à chacun un nom et un type de données (comme Text ou Number). Chaque champ personnalisé que vous créez correspond à une entrée attendue par tout flux qui appelle votre flux auxiliaire.
contexte Les sorties de cette section se voient attribuer automatiquement des valeurs chaque fois que le flux s'exécute.
Index Cette sortie numérique se voit attribuer une valeur lorsqu'une fonction qui boucle à travers les éléments d'une liste (comme les fonctions Pour chaque ou Mapper) appelle le flux auxiliaire. La valeur d'Index correspond à la position de l'élément dans la liste (en commençant par zéro) à mesure que cette instance du flux traite la liste.
Appelant

Les clés de l'objet Appelant vous indiquent :

  • Quel flux a appelé le flux auxiliaire (id et name)
  • Quelle exécution particulière du flux a effectué l'appel (execution_id)
  • À quelle étape particulière du flux il a été appelé (method, qui est un ID unique).

Lorsque le flux auxiliaire est exécuté manuellement, alors id et execution_id sont null. Ce fait est particulièrement utile à des fins de débogage.
Erreur La sortie objet se voit attribuer une valeur lorsque le flux est appelé pour la gestion des erreurs. Voir Définir la gestion des erreurs.

La valeur d'Erreur correspond à l'objet d'erreur brut retourné par l'application ou l'action qui a causé l'erreur.

Par exemple, un objet possède souvent des clés qui incluent message, statusCode et execution. La dernière clé est l'identifiant unique de l'exécution du flux qui a causé l'erreur. Vous pouvez ensuite l'utiliser pour construire une URL pointant vers l'historique d'exécution qui montre les détails du flux ayant mené à l'erreur.
ID d'exécution ID unique de l'instance du flux.