Utiliser la tâche Pour chaque boucle

Annonce : Application Integration est désormais disponible pour votre projet Google Cloud. Vous pouvez désormais utiliser Apigee Integration et Application Integration dans le même projet Google Cloud. En savoir plus

Ce tutoriel explique comment utiliser la tâche Pour chaque boucle pour la concaténation de chaînes. Dans ce tutoriel, vous allez créer deux intégrations : une intégration principale et une sous-intégration. L'intégration principale effectue une boucle dans un tableau de chaînes et, pour chaque élément du tableau, appelle la sous-intégration qui effectue la concaténation. Le résultat après l'exécution de l'intégration principale est une chaîne concaténée.

Pour compléter ce tutoriel, effectuez les tâches suivantes :

• Créer l'intégration principale
• Créer des variables dans l'intégration principale
• Créer la sous-intégration
• Créer des variables dans la sous-intégration
• Configurer la sous-intégration
• Configurer et exécuter l'intégration principale

Créer l'intégration principale

Pour créer une intégration, procédez comme suit :

1. Accédez à l'interface utilisateur d'Apigee et connectez-vous.
2. Sélectionnez votre organisation dans le menu déroulant en haut à gauche de l'UI.
3. Cliquez sur Développer > Intégrations.
4. Cliquez sur CRÉER.
5. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
   Remarque : Les noms d'intégration doivent répondre aux exigences suivantes :

   • Les noms doivent commencer et se terminer par une lettre ou un chiffre.
   • Les noms ne doivent pas contenir d'espaces, ni plus d'un tiret ou trait de soulignement d'affilée.
6. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
7. Cliquez sur Create (Créer) pour ouvrir le concepteur d'intégration.
8. Dans le concepteur d'intégrations, cliquez sur +Ajouter une tâche/un déclencheur > Déclencheur > Déclencheur d'API.
9. Faites glisser l'élément Déclencheur d'API vers le concepteur d'intégration.
10. Cliquez sur +Ajouter une tâche/un déclencheur > Tâches > Pour chaque boucle.
11. Faites glisser l'élément Pour chaque boucle vers le concepteur d'intégration.
12. Ajoutez une connexion (en périphérie) de l'élément Déclencheur d'API à l'élément Pour chaque boucle :
    1. Cliquez sur l'icône Duplication rattachée au côté de l'élément Déclencheur d'API.
    2. Tout en maintenant le pointeur de la souris enfoncé, faites glisser le pointeur de la souris vers une région de l'élément Pour chaque boucle.
    3. Relâchez le pointeur de la souris.

Créer des variables dans l'intégration principale

Créez les variables suivantes dans l'intégration principale :

• WordArray : tableau de chaînes. Les valeurs du tableau sont envoyées à la sous-intégration pour la concaténation.
• TempString : variable de chaîne temporaire.

Pour créer les variables, procédez comme suit :

1. Dans l'intégration principale, cliquez sur VAR dans la barre de menu.
2. Cliquez sur Ajouter +.
3. Dans la boîte de dialogue Créer une variable, définissez les propriétés suivantes :
   • Nom : saisissez WordArray.
   • Type de données : sélectionnez String Array.
   • Valeur par défaut : saisissez Hello, World, Apigee, Integrations.
4. Cliquez sur Créer.
5. Cliquez sur Ajouter +.
6. Dans la boîte de dialogue Créer une variable, définissez les propriétés suivantes :
   • Nom : saisissez TempString.
   • Type de données : sélectionnez String.
7. Cliquez sur Créer.
8. Cliquez sur OK pour fermer la boîte de dialogue Variables.

Créer la sous-intégration

Créez maintenant une sous-intégration (nouvelle intégration) qui concatène la chaîne.

Pour créer la sous-intégration, procédez comme suit :

1. Dans l'interface utilisateur Apigee, cliquez sur Développer > Intégrations.
2. Cliquez sur CRÉER.
3. Saisissez un nom et une description pour l'intégration, puis cliquez sur Créer.
4. Dans le concepteur d'intégrations, cliquez sur +Ajouter une tâche/un déclencheur > Déclencheur > Déclencheur d'API.
5. Faites glisser l'élément Déclencheur d'API vers le concepteur d'intégration.
6. Cliquez sur +Ajouter une tâche/un déclencheur > Tâches > Mappage des données.
7. Faites glisser l'élément Mappage des données vers le concepteur de l'intégration.
8. Ajoutez une connexion (en périphérie) de l'élément Déclencheur d'API à l'élément Mappage des données.

Créer des variables dans la sous-intégration

Créez les variables suivantes dans la sous-intégration :

• SubIntegrationInput : variable d'entrée de l'intégration. Lorsque la sous-intégration s'exécute, cette variable contient une valeur de la variable WordArray de l'intégration principale.
• SubIntegrationOutput : variable de sortie de l'intégration. Lorsque la sous-intégration termine une exécution, cette variable comporte la chaîne concaténée.
• SubIntegrationPreviousValue : variable d'entrée destinée à contenir la chaîne concaténée intermittente pour chaque boucle. La valeur pour cette variable est transmise depuis l'intégration principale.

Pour créer une variable, procédez comme suit :

1. Dans l'intégration principale, cliquez sur VAR dans la barre de menu.
2. Cliquez sur Ajouter +.
3. Dans la boîte de dialogue Créer une variable, définissez les propriétés suivantes :
   • Nom : saisissez VARIABLE_NAME.
   • Type de données : sélectionnez String.
4. Indiquez si la variable est une variable d'entrée ou de sortie :
   • Si vous créez la variable SubIntegrationInput ou SubIntegrationPreviousValue, sélectionnez Utiliser comme entrée pour l'intégration.
   • Si vous créez la variable SubIntegrationOutput, sélectionnez Utiliser comme sortie de l'intégration.
5. Cliquez sur Créer.

Répétez les étapes pour la création de chaque variable dans la sous-intégration.

Configurer la sous-intégration

Pour configurer la sous-intégration, procédez comme suit :

1. Cliquez sur l'élément Mappage des données pour afficher le volet de configuration.
2. Cliquez sur .
3. Dans l'éditeur de mappage de données :
   1. Faites glisser la variable SubIntegrationPreviousValue vers la colonne Entrée.
   2. Dans la variable SubIntegrationPreviousValue, cliquez sur Ajouter une fonction, puis sélectionnez CONCAT.
   3. Faites glisser la variable SubIntegrationInput vers la fonction CONCAT.
   4. Faites glisser la variable SubIntegrationOutput vers la colonne Sortie.
4. Fermez l'éditeur de mappage de données.
5. Cliquez sur Publier.

Configurer et exécuter l'intégration principale

Revenez maintenant à l'intégration principale et configurez-la pour appeler la sous-intégration.

Pour configurer l'intégration principale, procédez comme suit :

1. Ouvrez l'intégration principale dans le concepteur d'intégration.
2. Cliquez sur l'élément Pour chaque boucle pour afficher le volet de configuration de la tâche.
3. Définissez les propriétés suivantes dans le volet de configuration :
   • Liste à itérer : sélectionnez WordArray.
   • ID de déclencheur d'API : saisissez l'ID de déclencheur de la sous-intégration. Vous pouvez obtenir la valeur de l'ID du déclencheur à partir de l'élément Déclencheur d'API de la sous-intégration.
   • Nom de l'intégration : saisissez le nom de votre sous-intégration.
   • Mappage de sous-intégration d'éléments d'itération : sélectionnez SubIntegrationInput.
   • Mappage des paramètres de réponse de remplacement :
     • Dans le menu déroulant Sortie de sous-intégration depuis laquelle mapper, sélectionnez SubIntegrationOutput.
     • Dans le menu déroulant Variable d'intégration à remplacer, sélectionnez TempString.
   • Mapper avec une ou plusieurs entrées supplémentaires de sous-intégration :
     • Dans le menu déroulant Variable d'intégration depuis laquelle mapper, sélectionnez TempString.
     • Dans le menu déroulant Entrée de sous-intégration vers laquelle mapper, sélectionnez SubIntegrationPreviousValue.
4. Cliquez sur Publier.

Si l'intégration principale et la sous-intégration s'exécutent correctement, dans la boîte de dialogue de résumé de l'exécution, vous pouvez voir la chaîne concaténée HelloWorldApigeeIntegrations dans la variable TempString.