Consultez les connecteurs compatibles avec Application Integration.

Appeler une sous-intégration à l'aide d'une tâche de boucle "for each"

Dans la console

Ce guide de démarrage rapide explique comment créer une intégration qui utilise une tâche de boucle "For each" pour appeler une sous-intégration. La sous-intégration utilise l'entrée de l'intégration principale et envoie des e-mails aux destinataires à l'aide de la tâche "Envoyer un e-mail".

Créer la sous-intégration

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Intégrations. La page Integrations s'affiche.
3. Cliquez sur Créer une intégration.
4. Saisissez un nom et une description pour l'intégration.

   Pour ce guide de démarrage rapide, saisissez le nom ForEachSendEmailSubIntegration et la description Quickstart sub-integration.

5. Sélectionnez une région pour l'intégration.
   Remarque : Le menu déroulant Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour en savoir plus, consultez la section Activer une nouvelle région.
6. Cliquez sur Créer pour ouvrir l'éditeur d'intégrations.

Ajouter un déclencheur d'API dans la sous-intégration

Les déclencheurs sont nécessaires pour lancer la séquence des tâches qui composent une intégration. Dans ce guide de démarrage rapide, vous allez utiliser un déclencheur d'API pour démarrer l'intégration.

Pour ajouter et configurer le déclencheur d'API, procédez comme suit:

1. Dans l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
2. Cliquez sur l'élément Déclencheur d'API et placez-le dans l'éditeur d'intégrations.

Créer une variable d'entrée dans la sous-intégration

La sous-intégration utilise une variable pour stocker les informations reçues au format JSON de l'intégration principale. Pour créer une variable d'entrée, procédez comme suit:

1. Cliquez sur (Afficher/Masquer le panneau) dans la barre de navigation du concepteur pour afficher le volet Variables.
2. Cliquez sur + Créer pour créer une variable.

3. Dans le volet Créer une variable, procédez comme suit:

   a. Nom : saisissez order_details.

   b. Type de données: sélectionnez JSON.

   c. Cliquez sur Inférer à partir de la valeur par défaut.

   d. Dans Valeur par défaut, saisissez le code JSON suivant.

     {
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
         },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
         }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
         }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
         },
       "expectedDelivery": "15 March 2023"
     }
   

   Dans cet exemple d'objet JSON, remplacez YOUR_EMAIL_ID par l'ID de messagerie que vous souhaitez utiliser pour tester l'intégration.

   e. Cliquez sur Utiliser comme entrée pour l'intégration.

   f. Cliquez sur Créer.

Ajouter et configurer une tâche de mappage de données

La tâche Mappage de données vous permet d'effectuer des attributions de variables dans votre intégration, d'obtenir et de définir les propriétés des objets JSON, et d'appliquer des fonctions de transformation imbriquées aux valeurs. Les variables utilisées par la tâche de mappage de données peuvent être des variables d'intégration ou des variables de tâche.

Pour ajouter et configurer une tâche de mappage des données, procédez comme suit:

1. Dans l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
2. Cliquez sur l'élément Mappage de données et placez-le dans l'éditeur d'intégrations.
3. Cliquez sur l'élément Mappage de données dans l'éditeur d'intégration pour ouvrir le volet de configuration de la tâche.
4. Cliquez sur Ouvrir l'éditeur de mappage de données.
5. Configurez l'entrée comme suit :
   1. Dans la section Entrée, cliquez sur Variable ou valeur.
   2. Dans "Variable", saisissez item, puis sélectionnez order_details.items.
   3. Cliquez sur Enregistrer.
   4. Ajoutez une fonction de mappage à order_details.items. Cliquez sur le symbole + à côté de order_details.items. Dans la liste des fonctions, faites défiler la page vers le bas et sélectionnez FOR_EACH(Any) -> JSON (POUR_CHAQUE(Tout) -> JSON).
   5. Saisissez le paramètre d'entrée de la fonction FOR_EACH. Cliquez sur Variable ou valeur, puis sélectionnez ~obj1.
   6. Cliquez sur Enregistrer.
   7. Ajoutez une fonction de mappage à obj1. Cliquez sur + dans la ligne FOR EACH entre parenthèses après l'élément obj1 que vous venez d'ajouter. Dans la liste des fonctions, faites défiler l'écran vers le bas et sélectionnez GET PROPERTY(String) -> JSON (GET PROPERTY(Chaîne) -> JSON).
   8. Cliquez sur Variable ou valeur, puis saisissez itemName dans Valeur.
   9. Cliquez sur Enregistrer.
   10. Cliquez sur + Ajouter une fonction dans la ligne après GET PROPERTY (OBTENIR LA PROPRIÉTÉ), puis sélectionnez TO_STRING() -> Chaîne.
   11. Cliquez sur + Ajouter une fonction dans la dernière ligne, puis sélectionnez TO_STRING() -> Chaîne.
6. Configurez la sortie comme suit :
   1. Créez une variable de sortie. Dans la section Sortie, cliquez sur Créer.
   2. Dans le volet Créer une variable, saisissez le nom items, conservez les valeurs par défaut pour tous les autres champs, puis cliquez sur Créer.
7. Vérifiez que votre configuration de mappage de données ressemble à l'image suivante.

   

8. Fermez l'éditeur de mappage de données pour revenir à l'éditeur d'intégration.

Ajouter et configurer une tâche Envoyer un e-mail

Pour ajouter et configurer la tâche Envoyer un e-mail afin d'envoyer un e-mail à chacun des destinataires, procédez comme suit.

1. Dans l'éditeur d'intégrations, cliquez sur Ajouter une tâche/un déclencheur.
2. Accédez à Tâches, puis cliquez sur l'élément Envoyer un e-mail et placez-le dans l'éditeur d'intégration.
3. Cliquez sur l'élément de tâche Envoyer un e-mail dans l'éditeur d'intégration pour ouvrir le volet de configuration de la tâche.

4. Définissez les champs Task Input (Entrée de la tâche) suivants:

   1. À: cliquez sur Variable, puis sélectionnez order_details.emailId.
   2. Objet: saisissez l'objet de l'e-mail. Pour ce guide de démarrage rapide, saisissez Order delivery notification.
   3. Corps en texte brut: saisissez le texte suivant:

   Hi $order_details.customerName$! Your order with Order Id: $order_details.orderId$ with items: $items$ has been successfully placed. Expected delivery by: $order_details.expectedDelivery$.
   

Connecter les éléments de la sous-intégration

Maintenant que vous avez ajouté et configuré les tâches et les déclencheurs requis dans la sous-intégration, ajoutez une connexion (arête) entre les éléments. Une arête indique le flux de contrôle d'un élément à un autre.

1. Ajoutez une connexion de l'élément Déclencheur d'API à l'élément Mappage des données. Pointez sur un point de contrôle de l'élément Déclencheur d'API, puis cliquez et faites glisser une ligne vers un point de contrôle de l'élément Mappage de données.
2. De même, ajoutez une arête de l'élément Mapper les données à l'élément Envoyer un e-mail.

Tester et publier la sous-intégration

1. Pour tester cette sous-intégration, cliquez sur Tester dans la barre d'outils de l'éditeur d'intégration, puis sur Tester l'intégration dans la boîte de dialogue Test d'intégration. La sous-intégration s'exécute avec la valeur par défaut comme entrée et envoie un e-mail à l'adresse e-mail spécifiée dans la tâche "Envoyer un e-mail". Un message de réussite devrait s'afficher une fois le test terminé.
2. Pour publier cette sous-intégration, cliquez sur Publier dans la barre d'outils de l'éditeur d'intégration.

Créer l'intégration principale

1. Dans le menu de navigation, cliquez sur Integrations (Intégrations) pour revenir à la page Integrations (Intégrations).
2. Cliquez sur Créer une intégration.
3. Saisissez un nom et éventuellement une description pour l'intégration. Pour ce guide de démarrage rapide, saisissez le nom ForEachSendEmail et la description Quickstart main integration.
4. Dans la liste des régions compatibles, sélectionnez une région pour l'intégration. Assurez-vous de créer l'intégration principale dans la même région que la sous-intégration.
5. Cliquez sur Créer.

Ajouter un déclencheur d'API dans l'intégration principale

1. Dans l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des tâches et des déclencheurs disponibles.
2. Cliquez sur l'élément Déclencheur d'API et placez-le dans l'éditeur d'intégrations.

Créer une variable d'entrée dans l'intégration principale

Dans l'intégration principale, une variable d'entrée permet de stocker les données transmises à la sous-intégration via la boucle For Each. Vous pouvez créer cette variable maintenant ou à l'étape suivante lorsque vous ajouterez et configurerez la tâche de boucle "for each". Pour ce guide de démarrage rapide, créez la variable maintenant.

1. Cliquez sur (Afficher/Masquer le panneau) dans la barre de navigation du concepteur pour afficher le volet Variables.

2. Dans le volet Créer une variable, procédez comme suit:

   a. Nom : saisissez order_requests.

   b. Type de données: sélectionnez JSON.

   c. Cliquez sur Inférer à partir de la valeur par défaut.

   d. Dans Valeur par défaut, saisissez le code JSON suivant:

     [{
       "orderId": "1",
       "customerName": "Harry Ford",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "New York",
         "country": "USA",
         "zipcode": "103487"
       },
       "items": [{
         "itemid": "111-222-333",
         "itemName": "Smartphone",
         "itemPrice": 999.0,
         "quantity": 1.0
       }, {
         "itemid": "444-555-666",
         "itemName": "Mobile Cover",
         "itemPrice": 49.0,
         "quantity": ""
       }],
       "paymentDetails": {
         "mode": "COD",
         "status": ""
       },
      "expectedDelivery": "15 March 2023"
     }, {
       "orderId": "2",
       "customerName": "Tim Harvey",
       "emailId": "YOUR_EMAIL_ID",
       "shippingAddress": {
         "city": "Los Angeles",
         "country": "USA",
         "zipcode": "210738"
       },
       "items": [{
         "itemid": "222-333-444",
         "itemName": "Laptop",
         "itemPrice": 5999.0,
         "quantity": 1.0
      }],
       "paymentDetails": {
         "mode": "Online Payment",
         "status": "Success"
       },
       "expectedDelivery": "21 Feb 2023"
     }]
   

   Dans cet exemple d'objet JSON, remplacez les deux occurrences de YOUR_EMAIL_ID par l'ID de messagerie que vous souhaitez utiliser pour tester l'intégration.

   e. Cliquez sur Utiliser comme entrée pour l'intégration.

   f. Cliquez sur Créer.

Ajouter et configurer une tâche de boucle "for each"

1. Dans l'éditeur d'intégrations, cliquez sur Tâches.
2. Cliquez sur l'élément Pour chaque boucle et placez-le dans l'éditeur d'intégration.
3. Cliquez sur l'élément de tâche Pour chaque boucle dans l'éditeur d'intégration pour ouvrir le volet de configuration de la tâche.
4. Dans le volet de configuration, procédez comme suit :
   1. Liste à itérer: sélectionnez la variable d'entrée que vous avez créée, order_requests.
   2. ID de déclencheur d'API: sélectionnez le déclencheur d'API dans votre sous-intégration. Pour ce guide de démarrage rapide, sélectionnez api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Nom de l'intégration: sélectionnez le nom de la sous-intégration que vous souhaitez appeler. Pour ce guide de démarrage rapide, sélectionnez ForEachSendEmailSubIntegration.
   4. Mappage de sous-intégration d'éléments d'itération: sélectionnez order_details.

Connecter les éléments de l'intégration principale

1. Ajoutez une connexion de l'élément Déclencheur d'API à l'élément Boucle For Each. Pointez sur un point de contrôle de l'élément Déclencheur d'API, puis cliquez et faites glisser une ligne vers un point de contrôle de l'élément Boucle For Each.

Tester et publier l'intégration principale

La dernière tâche consiste à tester et à publier l'intégration principale.

1. Cliquez sur Tester dans la barre d'outils de l'éditeur d'intégrations, puis sur Tester l'intégration dans la boîte de dialogue Tester l'intégration. Un message de réussite devrait s'afficher une fois le test terminé.

2. Pour publier cette intégration, cliquez sur Publier dans la barre d'outils de l'éditeur d'intégrations.

   Une fois l'opération exécutée avec succès, l'intégration envoie un e-mail à l'adresse spécifiée dans la tâche "Envoyer un e-mail". Confirmez la réception de l'e-mail dans votre client de messagerie.

Quotas et limites

Pour plus d'informations sur les quotas et les limites, consultez la section Quotas et limites.