Invocar uma subintegração usando uma tarefa "Para cada repetição"

Neste guia de início rápido, mostramos como criar uma integração que usa uma tarefa "Para cada repetição" para invocar uma subintegração. A subintegração recebe a entrada da integração principal e envia e-mails aos destinatários usando a tarefa "Enviar e-mail".

Criar a subintegração

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. Clique em Integrações no menu de navegação à esquerda para abrir a página Integrações.
3. Clique em CRIAR INTEGRAÇÃO.
4. Insira um nome e uma descrição para a integração.

   Para este guia de início rápido, insira o nome ForEachSendEmailSubIntegration e a descrição Quickstart sub-integration.

5. Selecione uma região para a integração.
   Observação:o menu suspenso Regiões lista apenas as regiões provisionadas no seu projeto do Google Cloud . Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para mais informações.
6. Clique em Criar para abrir o editor de integração.

Adicionar um gatilho de API na subintegração

Os acionadores são necessários para iniciar a sequência de tarefas que compõem uma integração. Neste guia de início rápido, você usa um gatilho de API para iniciar a integração.

Para adicionar e configurar o gatilho da API, siga estas etapas:

1. No editor de integração, clique em Gatilhos para ver a lista de gatilhos disponíveis.
2. Clique e posicione o elemento Gatilho da API no editor de integração.

Criar uma variável de entrada na subintegração

A subintegração usa uma variável para armazenar os detalhes recebidos no formato JSON da integração principal. Para criar uma variável de entrada, siga estas etapas:

1. Clique em (painel "Alternar") na barra de navegação do designer para abrir o painel Variáveis.
2. Clique em + Criar para criar uma variável.

3. No painel Criar variável, faça o seguinte:

   a. Nome: insira order_details.

   b. Tipo de dados: selecione JSON.

   c. Clique em Inferir do valor padrão.

   d. Em Valor padrão, insira o seguinte JSON.

     {
       "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"
     }
   

   Neste exemplo de objeto JSON, substitua YOUR_EMAIL_ID pelo ID do e-mail que você quer usar para testar a integração.

   e. Clique em Usar como entrada para integração.

   f. Clique em Criar.

Adicionar e configurar uma tarefa de mapeamento de dados

Com a tarefa Mapeamento de dados, é possível fazer atribuições de variáveis na sua integração, receber e definir propriedades de objetos JSON e aplicar funções de transformação aninhadas a valores. As variáveis usadas pela tarefa "Mapeamento de dados" podem ser de integração ou de tarefa.

Para adicionar e configurar uma tarefa de mapeamento de dados, siga estas etapas:

1. No editor de integração, clique em Tarefas para ver a lista de tarefas disponíveis.
2. Clique e posicione o elemento Mapeamento de dados no editor de integração.
3. Clique no elemento Mapeamento de dados no editor de integração para abrir o painel de configuração da tarefa.
4. Clique em Abrir editor de mapeamento de dados.
5. Configure a Entrada da seguinte maneira:
   1. Na seção Entrada, clique em Variável ou valor.
   2. Em "Variável", insira item e selecione order_details.items.
   3. Clique em Salvar.
   4. Adicione uma função de mapeamento a order_details.items. Clique no símbolo + ao lado de order_details.items. Na lista de funções, role a tela e selecione FOR_EACH(Any) -> JSON.
   5. Insira o parâmetro de entrada da função FOR_EACH. Clique em Variável ou valor e selecione ~obj1.
   6. Clique em Salvar.
   7. Adicione uma função de mapeamento a obj1. Clique em + na linha FOR EACH entre parênteses depois do elemento obj1 que você acabou de adicionar. Na lista de funções, role a tela e selecione GET PROPERTY(String) -> JSON.
   8. Clique em Variável ou valor e, em Valor, insira itemName.
   9. Clique em Salvar.
   10. Clique em + Adicionar uma função na linha depois de GET PROPERTY e selecione TO_STRING() -> String.
   11. Clique em + Adicionar uma função na última linha e selecione TO_STRING() -> String.
6. Configure a Saída da seguinte maneira:
   1. Crie uma variável de saída. Na seção Saída, clique em criar uma nova.
   2. No painel Criar variável, insira o nome items, mantenha os valores padrão para todos os outros campos e clique em Criar.
7. Verifique se a configuração de mapeamento de dados é semelhante à imagem a seguir.

   

8. Feche o Editor de mapeamento de dados para retornar ao editor de integração.

Adicionar e configurar uma tarefa "Enviar e-mail"

Para adicionar e configurar a tarefa Enviar e-mail para enviar um e-mail a cada um dos destinatários, siga estas etapas.

1. No editor de integração, clique em Adicionar uma tarefa/gatilho.
2. Acesse Tarefas e clique e coloque o elemento Enviar e-mail no editor de integração.
3. Clique no elemento de tarefa Enviar e-mail no editor de integração para abrir o painel de configuração da tarefa.

4. Defina os seguintes campos de Entrada da tarefa:

   1. Em Para, clique em Variável e selecione order_details.emailId.
   2. Assunto: insira o assunto do e-mail. Para este guia de início rápido, insira Order delivery notification.
   3. Corpo em texto simples: insira o seguinte texto:

   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$.
   

Conectar os elementos na subintegração

Agora que você adicionou e configurou as tarefas e os gatilhos necessários na subintegração, adicione uma conexão (borda) entre os elementos. Uma borda indica o fluxo de controle de um elemento para o próximo.

1. Adicione uma conexão do elemento gatilho da API ao elemento mapeamento de dados. Passe o cursor sobre um ponto de controle no elemento gatilho da API e arraste uma linha até um ponto de controle no elemento Mapeamento de dados.
2. Da mesma forma, adicione uma borda do elemento Mapeamento de dados ao elemento Enviar e-mail.

Testar e publicar a subintegração

1. Para testar essa subintegração, clique em Testar na barra de ferramentas do editor de integração e em Testar integração na caixa de diálogo Testar integração. A subintegração é executada com o valor padrão como entrada e envia um e-mail para o endereço especificado na tarefa "Enviar e-mail". Você vai receber uma mensagem de sucesso quando o teste for concluído.
2. Para publicar essa subintegração, clique em Publicar na barra de ferramentas do editor de integração.

Criar a integração principal

1. No menu de navegação, clique em Integrações para voltar à página Integrações.
2. Clique em CRIAR INTEGRAÇÃO.
3. Insira um nome e, se quiser, uma descrição para a integração. Para este guia de início rápido, insira o nome ForEachSendEmail e a descrição Quickstart main integration.
4. Selecione uma Região para a integração na lista de regiões compatíveis. Crie a integração principal na mesma região da subintegração.
5. Clique em Criar.

Adicionar um gatilho de API na integração principal

1. No editor de integração, clique em Acionadores para ver a lista de tarefas e acionadores disponíveis.
2. Clique e posicione o elemento Gatilho da API no editor de integração.

Criar uma variável de entrada na integração principal

Na integração principal, uma variável de entrada é usada para armazenar os dados transmitidos pelo loop "Para cada" à subintegração. Você pode criar essa variável agora ou na próxima etapa, quando adicionar e configurar a tarefa "For Each Loop". Para este guia de início rápido, crie a variável agora.

1. Clique em (painel "Alternar") na barra de navegação do designer para abrir o painel Variáveis.

2. No painel Criar variável, faça o seguinte:

   a. Nome: insira order_requests.

   b. Tipo de dados: selecione JSON.

   c. Clique em Inferir do valor padrão.

   d. Em Valor padrão, insira o seguinte JSON:

     [{
       "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"
     }]
   

   Neste exemplo de objeto JSON, substitua as duas ocorrências de YOUR_EMAIL_ID pelo ID do e-mail que você quer usar para testar a integração.

   e. Clique em Usar como entrada para integração.

   f. Clique em Criar.

Adicionar e configurar uma tarefa "Para cada repetição"

1. No editor de integração, clique em Tarefas.
2. Clique e posicione o elemento Para cada loop no editor de integração.
3. Clique no elemento de tarefa Para cada loop no editor de integração para abrir o painel de configuração da tarefa.
4. No painel de configuração, faça o seguinte:
   1. Listar a iterar: selecione a variável de entrada que você criou, order_requests.
   2. ID do gatilho da API: selecione o gatilho da API na subintegração. Para este guia de início rápido, selecione api_trigger/ForEachSendEmailSubIntegration_API_1.
   3. Nome da integração: selecione o nome da subintegração que você quer invocar. Para este guia de início rápido, selecione ForEachSendEmailSubIntegration.
   4. Mapeamento de subintegração do elemento de iteração: selecione order_details.

Conectar os elementos na integração principal

1. Adicione uma borda do elemento Gatilho de API ao elemento Para cada loop. Passe o cursor sobre um ponto de controle no elemento gatilho da API e arraste uma linha até um ponto de controle no elemento Para cada loop.

Testar e publicar a integração principal

A tarefa final é testar e publicar a integração principal.

1. Clique em Testar na barra de ferramentas do editor de integração e em Testar integração na caixa de diálogo Testar integração. Você vai receber uma mensagem de sucesso quando o teste for concluído.

2. Para publicar essa integração, clique em Publicar na barra de ferramentas do editor de integração.

   Após a conclusão, a integração enviará um e-mail para o endereço especificado na tarefa "Enviar e-mail". Confirme o recebimento da mensagem no seu cliente de e-mail.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.