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

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. No menu de navegação, clique em Integrações. A página Integrations aparece.
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 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ê vai usar um acionador de API para iniciar a integração.

Para adicionar e configurar o acionador da 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 (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 JSON a seguir.

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

A tarefa de mapeamento de dados permite 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, 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 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 a obj1. Clique em + na linha FOR EACH 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 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 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 e enviar um e-mail para 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 no elemento Enviar e-mail e coloque-o 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. Para os 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: 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 borda do elemento Gatilho da API ao elemento Mapeamento de dados. Passe o cursor sobre um ponto de controle no elemento Acionador de API. Em seguida, 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 Test Integration. 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". Uma mensagem de sucesso vai aparecer 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 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, ao 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 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 "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 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 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 Testar na barra de ferramentas do editor de integração e, em seguida, em Testar integração na caixa de diálogo Testar integração. Uma mensagem de sucesso vai aparecer 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.