Consulte os conectores compatíveis com a Application Integration.

Invocar uma subintegração usando uma tarefa For Every 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 Integrações. 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ê usa um acionador 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 Acionadores para visualizar a lista de acionadores 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 nova 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 do 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

A tarefa de mapeamento de dados permite realizar 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 variáveis 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 conferir 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 Save.
   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 Save.
   7. Adicione uma função de mapeamento para obj1. Clique em + em FOR EACH linha entre parênteses depois do 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 Save.
   10. Clique em + Adicionar uma função na linha após 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 nova variável de saída. Na seção Saída, clique em criar um novo.
   2. No painel Criar variável, insira o nome items, mantenha os valores padrão de 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 Tarefas, clique e coloque o elemento Enviar e-mail no editor de integração.
3. Clique no elemento de tarefa Send Email no editor de integração para abrir o painel de configuração da tarefa.

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, digite Order delivery notification.
   3. Corpo em texto simples: digite 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 aresta indica o fluxo de controle de um elemento para outro.

1. Adicione uma borda do elemento gatilho da API ao elemento do Mapeamento de dados. Passe o cursor sobre um ponto de controle no elemento gatilho da API. Em seguida, clique e arraste uma linha até um ponto de controle no elemento do 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 Test na barra de ferramentas do editor de integração e, em seguida, clique 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 êxito 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 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 passados pelo loop "Para cada" à subintegração. É possível criar essa variável agora ou na próxima etapa quando você 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 Every 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 de tarefas.
4. No painel de configuração, faça o seguinte:
   1. Lista para iteração: selecione a variável de entrada criada 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. Integration name: 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 da API ao elemento Para cada loop. Passe o cursor sobre um ponto de controle no elemento gatilho da API. Em seguida, 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 Test na barra de ferramentas do editor de integração e em Test integration na caixa de diálogo Test Integration. Você vai receber uma mensagem de êxito 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.