Consulte os conectores compatíveis com a integração de aplicativos.

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 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. No menu de navegação, clique em Integrações. A página Integrações será exibida.
3. Clique em CRIAR INTEGRAÇÃO.
4. Digite 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 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 Gatilhos para conferir a lista de opções 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. Tipo de dados: 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 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, acessar 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", 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 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 a tela 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 para 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/gatilho.
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 Entrada da tarefa:

   1. Para destinatários: 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: 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 e 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 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 Integrations para voltar à página Integrations.
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 conferir 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 transmitidos pela repetição para cada elemento para a 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, digite este 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 posicione o elemento Para cada loop no editor de integração.
3. Clique no elemento da 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. Lista a ser iterada: selecione a variável de entrada que você criou, solicitações_de_pedido.
   2. ID do acionador da API: selecione o acionador 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 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 o assunto, consulte Cotas e limites.