Consultez la liste des connecteurs compatibles avec Application Integration.

Appeler une sous-intégration à l'aide d'une tâche "Pour chaque boucle"

Ce guide de démarrage rapide vous explique comment créer une intégration qui utilise une tâche For chaque boucle pour appeler une sous-intégration. La sous-intégration récupère les données de l'intégration principale et envoie des e-mails aux destinataires à l'aide de la tâche "Send Email" (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 Liste des intégrations 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égration.

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

Des déclencheurs sont nécessaires pour démarrer la séquence de tâches constituant 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 détails reçus de l'intégration principale au format JSON. Pour créer une variable d'entrée, procédez comme suit:

1. Cliquez sur (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 Déduire 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"
     }
   

   Dans cet exemple d'objet JSON, remplacez YOUR_EMAIL_ID par l'ID d'adresse e-mail que vous souhaitez utiliser pour tester l'intégration.

   e. Cliquez sur Use as an input to integration (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 de mappage de données vous permet d'attribuer des 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 Tasks (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égrations 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. Dans la liste des fonctions, faites défiler la page vers le bas et sélectionnez FOR_EACH(Any) -> JSON (POUR_EACH(Any) -> JSON).
   5. Saisissez le paramètre de saisie 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 le signe + sur la ligne "POUR CHAQUE" entre parenthèses après l'élément obj1 que vous venez d'ajouter. Dans la liste des fonctions, faites défiler la page vers le bas et sélectionnez GET PROPERTY(String) -> JSON.
   8. Cliquez sur Variable ou valeur, puis dans le champ Valeur, saisissez itemName.
   9. Cliquez sur Enregistrer.
   10. Cliquez sur + Ajouter une fonction dans la ligne qui suit OBTENIR UNE 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 (Résultat), cliquez sur create a new one (Créer une sortie).
   2. Dans le volet Créer une variable, saisissez le nom items, conservez les valeurs par défaut de tous les autres champs, puis cliquez sur Créer.
7. Vérifiez que votre configuration de mappage de données est semblable à 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 Add a task/trigger (Ajouter une tâche/déclencheur).
2. Accédez à Tasks (Tâches) et placez l'élément Send Email (Envoyer l'e-mail) dans l'éditeur d'intégrations.
3. Cliquez sur l'élément de tâche Send Email (Envoyer un e-mail) dans l'éditeur d'intégrations pour ouvrir le volet de configuration de la tâche.

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

   1. À un ou plusieurs destinataires: 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 dans 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 (bordure) entre les éléments. Une arête indique le flux de contrôle d'un élément à l'autre.

1. Ajoutez une arête à partir de l'élément Déclencheur d'API à l'élément Mappage de données. Pointez sur un point de contrôle dans 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 entre l'élément Data Mapping et l'élément Send Email.

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 en entrée et envoie un e-mail à l'adresse spécifiée dans la tâche "Envoyer un e-mail". Un message indiquant que l'opération a réussi doit s'afficher à la fin du test.
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 Triggers (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 via la boucle "For chaque boucle" à la sous-intégration. Vous pouvez créer cette variable maintenant ou à l'étape suivante, lorsque vous ajouterez et configurerez la tâche Pour chaque boucle. Pour ce guide de démarrage rapide, créez la variable maintenant.

1. Cliquez sur (panneau d'activation) 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 Déduire 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 Use as an input to integration (Utiliser comme entrée pour l'intégration).

   f. Cliquez sur Créer.

Ajouter et configurer une tâche Pour chaque boucle

1. Dans l'éditeur d'intégrations, cliquez sur Tasks (Tâches).
2. Cliquez sur l'élément Pour chaque boucle et placez-le dans l'éditeur d'intégrations.
3. Cliquez sur l'élément de tâche Pour chaque boucle dans l'éditeur d'intégrations 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 du 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 à partir de l'élément Déclencheur API à l'élément Pour chaque boucle. Pointez sur un point de contrôle dans 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 Test dans la barre d'outils de l'éditeur d'intégrations, puis sur Tester l'intégration dans la boîte de dialogue Test Integration (Tester l'intégration). Un message indiquant que l'opération a réussi doit s'afficher à la fin du test.

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.