Consultez la liste des connecteurs compatibles avec Application Integration.

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

Ce guide de démarrage rapide vous explique comment créer une intégration qui utilise une tâche "Pour chaque boucle" afin d'appeler une sous-intégration. La sous-intégration récupère les données saisies dans 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 Integrations (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 lancer 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 (Toggle panel) (Panneau d'activation) 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 des données

La tâche de mappage des 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 de 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 des tâches.
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. Faites défiler la liste des fonctions vers le bas et sélectionnez FOR_EACH(Any) -> 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. Faites défiler la liste des fonctions vers le bas, puis sélectionnez OBTENIR LA PROPRIÉTÉ(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 Output (Sortie), cliquez sur create a new one (en créer une).
   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 des tâches.

4. Renseignez les champs Task Input 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 à l'autre.

1. Ajoutez une arête de l'élément Déclencheur d'API à l'élément Mappage de 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 Mappage des 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égrations, puis sur Tester l'intégration dans la boîte de dialogue Tester l'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égrations.

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 est utilisée pour 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 ajoutez et configurez la tâche "Pour chaque boucle". Pour les besoins de 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 Default Value (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 d'adresse e-mail que vous souhaitez utiliser pour tester l'intégration.

   e. Cliquez sur Utiliser comme entrée de 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égrations pour ouvrir le volet de configuration des tâches.
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. Integration name (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 dans l'intégration principale

1. Ajoutez une arête depuis l'élément Déclencheur d'API à l'élément Pour chaque boucle. Passez la souris 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 Pour chaque boucle.

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.