Appelez une sous-intégration pour envoyer un e-mail

À l'aide de la tâche "Pour chaque boucle", appelez une sous-intégration qui reçoit les entrées de l'intégration principale pour envoyer des notifications par e-mail.

Exemple de code: sous-intégration

{
  "triggerConfigs": [{
    "label": "API Trigger",
    "startTasks": [{
      "taskId": "1"
    }],
    "properties": {
      "Trigger name": "SubIntegrationSendEmailDemo_API_1"
    },
    "triggerType": "API",
    "triggerNumber": "1",
    "triggerId": "api_trigger/SubIntegrationSendEmailDemo_API_1"
  }],
  "taskConfigs": [{
    "task": "EmailTask",
    "taskId": "1",
    "parameters": {
      "Cc": {
        "key": "Cc",
        "value": {
          "stringArray": {
          }
        }
      },
      "TextBody": {
        "key": "TextBody",
        "value": {
          "stringValue": "$EmailContent$"
        }
      },
      "Bcc": {
        "key": "Bcc",
        "value": {
          "stringArray": {
          }
        }
      },
      "AttachmentPath": {
        "key": "AttachmentPath",
        "value": {
          "stringArray": {
          }
        }
      },
      "To": {
        "key": "To",
        "value": {
          "stringArray": {
            "stringValues": ["$Recipients$"]
          }
        }
      },
      "BodyFormat": {
        "key": "BodyFormat",
        "value": {
          "stringValue": "text"
        }
      },
      "EmailConfigInput": {
        "key": "EmailConfigInput",
        "value": {
          "jsonValue": "{\n  \"@type\": \"type.googleapis.com/enterprise.crm.eventbus.proto.EmailConfig\"\n}"
        }
      },
      "Subject": {
        "key": "Subject",
        "value": {
          "stringValue": "$Email_Subject$"
        }
      }
    },
    "taskExecutionStrategy": "WHEN_ALL_SUCCEED",
    "displayName": "Send Email"
  }],
  "integrationParameters": [{
    "key": "EmailContent",
    "dataType": "STRING_VALUE",
    "defaultValue": {
      "stringValue": ""
    },
    "displayName": "EmailContent",
    "inputOutputType": "IN"
  }, {
    "key": "Recipients",
    "dataType": "STRING_VALUE",
    "defaultValue": {
      "stringValue": ""
    },
    "displayName": "Recipients",
    "inputOutputType": "IN"
  }, {
    "key": "Email_Subject",
    "dataType": "STRING_VALUE",
    "defaultValue": {
      "stringValue": ""
    },
    "displayName": "Email_Subject",
    "inputOutputType": "IN"
  }]
}

Exemple de code: intégration principale

{
  "triggerConfigs": [{
    "label": "API Trigger",
    "startTasks": [{
      "taskId": "1"
    }],
    "properties": {
      "Trigger name": "ForEachLoopDemo_API_1"
    },
    "triggerType": "API",
    "triggerNumber": "1",
    "triggerId": "api_trigger/ForEachLoopDemo_API_1"
  }],
  "taskConfigs": [{
    "task": "SubWorkflowForEachLoopV2Task",
    "taskId": "1",
    "parameters": {
      "iterationElementMapping": {
        "key": "iterationElementMapping",
        "value": {
          "stringValue": "EmailContent"
        }
      },
      "aggregatorParameterMapping": {
        "key": "aggregatorParameterMapping"
      },
      "triggerId": {
        "key": "triggerId",
        "value": {
          "stringValue": "api_trigger/SubIntegrationSendEmailDemo_API_1"
        }
      },
      "loopMetadata": {
        "key": "loopMetadata",
        "value": {
          "stringArray": {
            "stringValues": ["$`Task_1_loopMetadata`$"]
          }
        }
      },
      "disableEucPropagation": {
        "key": "disableEucPropagation",
        "value": {
          "booleanValue": false
        }
      },
      "listToIterate": {
        "key": "listToIterate",
        "value": {
          "stringValue": "$ListOfEmailContent$"
        }
      },
      "workflowName": {
        "key": "workflowName",
        "value": {
          "stringValue": "SubIntegrationSendEmailDemo"
        }
      },
      "requestParameterMapping": {
        "key": "requestParameterMapping",
        "value": {
          "jsonValue": "{\n  \"@type\": \"type.googleapis.com/enterprise.crm.eventbus.proto.ParameterMap\",\n  \"entries\": [{\n    \"key\": {\n      \"literalValue\": {\n        \"stringValue\": \"Recipients\"\n      }\n    },\n    \"value\": {\n      \"literalValue\": {\n        \"stringValue\": \"Recipients\"\n      }\n    }\n  }, {\n    \"key\": {\n      \"literalValue\": {\n        \"stringValue\": \"Email_Subject\"\n      }\n    },\n    \"value\": {\n      \"literalValue\": {\n        \"stringValue\": \"Email_Subject\"\n      }\n    }\n  }]\n}"
        }
      },
      "overrideParameterMapping": {
        "key": "overrideParameterMapping"
      }
    },
    "taskExecutionStrategy": "WHEN_ALL_SUCCEED",
    "displayName": "For Each Loop"
  }],
  "integrationParameters": [{
    "key": "`Task_1_loopMetadata`",
    "dataType": "JSON_VALUE",
    "displayName": "`Task_1_loopMetadata`",
    "isTransient": true,
    "producer": "1_1"
  }, {
    "key": "Recipients",
    "dataType": "STRING_VALUE",
    "defaultValue": {
      "stringValue": ""
    },
    "displayName": "Recipients",
    "inputOutputType": "IN"
  }, {
    "key": "Email_Subject",
    "dataType": "STRING_VALUE",
    "defaultValue": {
      "stringValue": ""
    },
    "displayName": "Email_Subject",
    "inputOutputType": "IN"
  }, {
    "key": "ListOfEmailContent",
    "dataType": "STRING_ARRAY",
    "defaultValue": {
      "stringArray": {
        "stringValues": ["\"Content 1\"", "\"Content 2\"", "\"Content 3\"", "\"Content 4\""]
      }
    },
    "displayName": "ListOfEmailContent",
    "inputOutputType": "IN"
  }]
}

Exemple de flux d'intégration

Les images suivantes illustrent un exemple de mise en page de l'éditeur d'intégration correspondant à cet exemple de code d'intégration.

Sous-intégration

image montrant l'exemple de flux de sous-intégration

Intégration principale

image montrant l'exemple de flux d'intégration principale

Importer et exécuter l'exemple d'intégration

Pour importer et exécuter l'exemple d'intégration, procédez comme suit:

Enregistrez l'exemple d'intégration sur votre système au format .json.
Dans la console Google Cloud, accédez à la page Application Integration.
Accéder à Application Integration
Dans le menu de navigation, cliquez sur Integrations (Intégrations). La page Liste des intégrations s'affiche.
Sélectionnez une intégration existante ou créez-en une en cliquant sur Créer une intégration.
Si vous créez une intégration :
1. Saisissez un nom et une description dans la boîte de dialogue Créer une intégration.
2. 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.
3. Sélectionnez un compte de service pour l'intégration. Vous pouvez modifier ou mettre à jour les détails du compte de service d'une intégration à tout moment à partir du volet Integration summary (Résumé de l'intégration) dans la barre d'outils de l'intégration.
  Remarque:L'option permettant de sélectionner un compte de service ne s'affiche que si vous avez activé la gouvernance de l'intégration pour la région sélectionnée.
4. Cliquez sur Créer.
Cela entraîne son ouverture dans l'éditeur d'intégrations.
Dans l'éditeur d'intégration, cliquez sur Menu d'importation/de téléchargement, puis sélectionnez Importer l'intégration.
Dans la boîte de dialogue de l'explorateur de fichiers, sélectionnez le fichier que vous avez enregistré à l'étape 1, puis cliquez sur Ouvrir.
Une nouvelle version de l'intégration est créée à l'aide du fichier importé.
Dans l'éditeur d'intégration, cliquez sur Test.
Cliquez sur Tester l'intégration. Cette opération permet d'exécuter l'intégration et d'afficher le résultat de l'exécution dans le volet Test Integration (Tester l'intégration).