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 :
- Accédez à l'interface utilisateur d'Apigee et connectez-vous.
- Sélectionnez votre organisation dans le menu déroulant en haut à gauche de l'UI.
- Cliquez sur Développer > Intégrations.
- Cliquez sur CRÉER.
- Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
- Dans la liste des régions compatibles, sélectionnez une région pour l'intégration.
- Cliquez sur Create (Créer) pour ouvrir le concepteur d'intégration.
- Dans le concepteur d'intégrations, cliquez sur +Ajouter une tâche/un déclencheur > Déclencheur > Déclencheur d'API.
- Faites glisser l'élément Déclencheur d'API vers le concepteur d'intégration.
- Cliquez sur +Ajouter une tâche/un déclencheur > Tâches > Pour chaque boucle.
- Faites glisser l'élément Pour chaque boucle vers le concepteur d'intégration.
- Ajoutez une connexion (en périphérie) de l'élément Déclencheur d'API à l'élément Pour chaque boucle :
- Cliquez sur l'icône Duplication rattachée au côté de l'élément Déclencheur d'API.
- 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.
- 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.
- Dans l'intégration principale, cliquez sur VAR dans la barre de menu.
- Cliquez sur Ajouter +.
- 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
.
- Nom : saisissez
- Cliquez sur Créer.
- Cliquez sur Ajouter +.
- 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
.
- Nom : saisissez
- Cliquez sur Créer.
- 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 :
- Dans l'interface utilisateur Apigee, cliquez sur Développer > Intégrations.
- Cliquez sur CRÉER.
- Saisissez un nom et une description pour l'intégration, puis cliquez sur Créer.
- Dans le concepteur d'intégrations, cliquez sur +Ajouter une tâche/un déclencheur > Déclencheur > Déclencheur d'API.
- Faites glisser l'élément Déclencheur d'API vers le concepteur d'intégration.
- Cliquez sur +Ajouter une tâche/un déclencheur > Tâches > Mappage des données.
- Faites glisser l'élément Mappage des données vers le concepteur de l'intégration.
- 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.
- Dans l'intégration principale, cliquez sur VAR dans la barre de menu.
- Cliquez sur Ajouter +.
- 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
.
- Nom : saisissez
- 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.
- Cliquez sur Créer.
Configurer la sous-intégration
Pour configurer la sous-intégration, procédez comme suit :- Cliquez sur l'élément Mappage des données pour afficher le volet de configuration.
- Cliquez sur .
- Dans l'éditeur de mappage de données :
- Faites glisser la variable SubIntegrationPreviousValue vers la colonne Entrée.
- Dans la variable SubIntegrationPreviousValue, cliquez sur Ajouter une fonction, puis sélectionnez CONCAT.
- Faites glisser la variable SubIntegrationInput vers la fonction CONCAT.
- Faites glisser la variable SubIntegrationOutput vers la colonne Sortie.
- Fermez l'éditeur de mappage de données.
- 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 :
- Ouvrez l'intégration principale dans le concepteur d'intégration.
- Cliquez sur l'élément Pour chaque boucle pour afficher le volet de configuration de la tâche.
- 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.
- 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.