Consulte os conectores compatíveis com o Application Integration.

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

Neste guia de início rápido, mostramos como criar uma integração que usa uma tarefa "Para cada loop" 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. No menu de navegação, clique em Integrations. A página Lista de integrações é exibida.
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 projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
6. Clique em Criar para abrir o editor de integração.

Adicionar um gatilho de API na subintegração

Os gatilhos 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ê vai usar um gatilho de API para iniciar a integração.

Para adicionar e configurar o gatilho de 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 em JSON. da integração principal. Para criar uma variável de entrada, siga estas etapas:

1. Clique em (Alternar painel) na barra de navegação do designer para abrir o painel Variables.
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. Data Type: selecione JSON.

   c. Clique em Inferir do valor padrão.

   d. Em Valor padrão, digite 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 de e-mail que você quer usar para testar a integração.

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

   f. Clique em Criar.

Adicionar e configurar uma tarefa de Mapeamento de dados

Com a tarefa Mapeamento de dados, é possível realizar atribuições de variáveis na 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 de Mapeamento de dados podem ser variáveis de integração ou de tarefa.

Para adicionar e configurar uma tarefa de Mapeamento de dados, execute as seguintes etapas:

1. No editor de integração, clique em Tasks 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", digite 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 para baixo 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 para obj1. Clique em + na linha PARA CADA linha entre parênteses, após o elemento obj1 que você acabou de adicionar. Na lista de funções, role para baixo 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 após OBTER PROPRIEDADE 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 nova 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 em todos os outros campos e clique em Criar.
7. Verifique se a configuração do 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 as etapas abaixo.

1. No editor de integração, clique em Adicionar uma tarefa/acionador.
2. Acesse Tasks, clique e coloque o elemento Send Email 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 de tarefas.

4. Defina os seguintes campos de Task Input:

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

   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. Borda indica o fluxo de controle de um elemento para o próximo.

1. Adicione uma borda do elemento Gatilho de API ao elemento Mapeamento de dados. Passe o cursor sobre um ponto de controle no elemento Acionador de API, depois clique 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 depois 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ê verá 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 que a subintegração.
5. Clique em Criar.

Adicionar um gatilho de API na integração principal

1. No editor de integração, clique em Gatilhos para ver a lista de tarefas e gatilhos 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 que são transmitidos pela subintegração pela repetição "for cada". Você pode criar essa variável agora ou na próxima etapa, ao adicionar e configurar a tarefa "Para cada loop". Para este guia de início rápido, crie a variável agora.

1. Clique em (Alternar painel) na barra de navegação do designer para abrir o painel Variables.

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

   a. Nome: insira order_requests.

   b. Data Type: selecione JSON.

   c. Clique em Inferir do valor padrão.

   d. Em Valor padrão, digite 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 de e-mail que você quer usar para testar a integração.

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

   f. Clique em Criar.

Adicionar e configurar uma tarefa Para cada loop

1. No editor de integração, clique em Tarefas.
2. Clique e coloque o elemento For Cada Loop no editor de integração.
3. Clique no elemento de tarefa For Every 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 para iterar: selecione a variável de entrada que você criou, order_requests.
   2. ID do acionador de API: selecione o acionador de API na sua 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.

Conecte os elementos na integração principal

1. Adicione uma borda do elemento Gatilho de API ao elemento For cada loop. Passe o cursor sobre um ponto de controle no elemento Acionador de API, depois clique 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 depois em Testar integração na caixa de diálogo Testar integração. Você verá 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 cotas e limites, consulte Cotas e limites.