Pour chaque (For Each)

L'activité « For Each » parcourt les tableaux et exécute un ensemble d'étapes définies pour chaque élément du tableau. Utilisez l'activité Pour chaque pour gérer les réponses d'API contenant des tableaux d'objets, tels que des listes d'utilisateurs, des commandes ou des enregistrements qui nécessitent un traitement individuel.

Comment agréger les données d'un tableau

Un cas d'utilisation courant de l'activité Pour chaque consiste à agréger les données de plusieurs appels d'API dans un tableau structuré à l'aide de l'activité Script .

L'activité Pour chaque collecte automatiquement la sortie de la dernière activité dans son flux Corps et la compile dans un tableau disponible dans sa propre sortie.

Utilisation de l'activité For Each

Pour ajouter une activité Pour chaque à votre workflow :

1. Sur votre canevas de conception de workflow d'API, sélectionnez l'icône plus (+). Le menu Ajouter une activité s'affiche.
2. Sélectionnez Boucle, puis PourChaque.
3. Dans le panneau Propriétés , configurez les champs suivants :
   • Dans—Utilisez l'éditeur d'expressions pour spécifier le tableau d'itération. En général, ce tableau provient d’une précédente réponse d’API.
   • Nom de l’élément : attribuez un nom de référence aux éléments du tableau (la valeur par défaut est currentItem). Utilisez cette référence pour accéder à chaque élément pendant l'itération.
4. Dans le corps de la boucle ForEach , ajoutez les activités pour traiter les éléments du tableau.
5. Ajoutez des activités aux branches Puis et Sinon selon vos besoins.
6. Déboguez le workflow pour exécuter l'activité et générer des champs de sortie pour une utilisation ultérieure.

Pour chaque exemple d’activité

L’exemple suivant parcourt un tableau d’objets employés, combine le prénom et le nom de famille de chaque employé et renvoie les résultats agrégés dans une réponse structurée.

Ouvrez la fenêtre de configuration de débogage , puis collez et enregistrez la syntaxe JSON suivante :

{
    "employees": [
        {
            "first_name": "Bobbie",
            "last_name": "Draper",
            "position": "administration",
            "email": "[e-mail]"
        },
                {
            "first_name": "James",
            "last_name": "Holden",
            "position": "manager",
            "email": "[e-mail]"
        }
    ]
}

1. Sur votre canevas de conception de workflow d'API, ajoutez une activité Pour chaque .
2. Configurez les champs Pour chaque comme suit :
   • Dans—Utilisez l'éditeur d'expressions pour référencer le tableau employees à partir de la configuration de l'exécution :

     $workflow.input.employees
     

   • Nom de l’élément : attribuez un nom de référence aux éléments du tableau (la valeur par défaut est currentItem). Utilisez cette référence pour accéder à chaque élément pendant l'itération.
3. Dans le Corps de la boucle Pour chaque , ajoutez une activité de type Script .
4. Pour l'activité de script , utilisez l' éditeur d'expressions pour créer un JSON qui combine les propriétés first_name et last_name en un objet :

   return {
       "name": $currentItem.first_name + " " + $currentItem.last_name
   }
   

5. Enregistrez la configuration.
6. À la fin du workflow, ajoutez une activité Réponse .
7. Configurez la réponse comme suit :
   • Type—Réussite
   • Détails : ouvrez l’éditeur d’expressions et écrivez ce qui suit :

     $context.outputs.For_Each_2
     

     Cette étape ajoute une validation au début du workflow pour confirmer qu'une transaction valide existe avant le traitement.
8. Déboguez le workflow pour exécuter l’activité.
9. Consultez le panneau Sortie pour examiner la réponse.