Consulte os conectores compatíveis com o Application Integration.

Tarefa "Chamar integração"

A tarefa Integração de chamadas permite invocar ou chamar outras integrações criadas no seu projeto do Google Cloud.

A tarefa Integração de chamadas é útil em cenários em que você precisa definir várias pequenas integrações (subintegrações) que são controladas usando uma integração principal (integração pai). Depois de executar uma subintegração, também é possível ler a resposta da subintegração na integração principal.

Antes de começar

  • A tarefa Chamar a integração usa o acionador da API para identificar e chamar outras integrações e subintegrações. Portanto, você precisa garantir que as integrações que você quer chamar sejam configuradas usando o acionador de API. Para informações sobre como configurar um gatilho de API, consulte Gatilho da API.
  • Verifique se você anexou uma conta de serviço gerenciada pelo usuário à integração. Se a integração não tiver uma conta de serviço gerenciada pelo usuário configurada, a conta de serviço padrão (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) será usada para autenticação por padrão.
  • Verifique se a conta de serviço tem o papel do IAM Invocador do Application Integration. Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Configurar a tarefa "Integração de chamadas"

Para configurar a tarefa Chamar Integraçã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 aparece listando todas as integrações disponíveis no projeto do Google Cloud.

  3. Selecione uma integração ou clique em Criar integração para criar uma nova.

    Caso você esteja criando uma nova integração, siga estas etapas:

    1. Insira um nome e uma descrição no painel Criar integração.
    2. Selecione uma região para a integração.
    3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar.

    Isso abre a integração na página do editor de integração.

  4. Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas e conectores disponíveis.
  5. Clique e posicione o elemento Integração de chamadas no editor de integração.
  6. Clique no elemento de tarefa Chamar Integração no designer para ver o painel de configuração da tarefa Chamar Integração.
  7. Configure os seguintes detalhes da subintegração:
    1. ID do gatilho da API: digite o ID do gatilho da API da integração que você quer chamar. É possível chamar uma ou mais integrações com o mesmo código de gatilho.
    2. Executar todas as integrações com esse ID do gatilho da API: selecione essa opção para chamar todas as integrações que têm o mesmo ID do gatilho da API.

      Por exemplo, se a integração A e B tiverem o mesmo ID do gatilho da API, as duas integrações, A e B, serão executadas.

    3. Executar uma única integração: selecione essa opção para chamar apenas a integração especificada no campo Nome da integração. É possível acessar e mapear a resposta da subintegração configurando os campos detalhados em Variáveis de resposta da subintegração do mapa.

    4. Estratégia de execução: selecione os modos de execução para as subintegrações que você quer chamar.
      • SYNC: executa a subintegração no modo síncrono. Nesse modo, a integração principal aguarda a conclusão das sub integrações antes de continuar as tarefas downstream.

      • ASYNC: executa a subintegração no modo assíncrono. Nesse modo, a integração principal não aguarda a conclusão das sub integrações. Imediatamente após chamar as subintegrações, a integração principal executa as tarefas downstream.

        Se essa opção for selecionada, defina o Atraso da execução (em milissegundos). Quando definido, isso especifica o atraso até que a integração seja executada.

      As alterações nas propriedades são salvas automaticamente.

Variáveis de resposta de subintegração de mapa

A tabela a seguir descreve as propriedades de configuração para mapear variáveis entre a integração principal e as subintegrações:
Propriedade Descrição
Map to sub-integration input(s)

Mapeia valores da integração principal à subintegração. Esse campo usa valores na forma de pares de chave-valor, em que a chave é uma variável na integração principal e o valor é a variável de entrada correspondente na subintegração.

Por exemplo, se você quiser mapear a variável productID da integração principal para a variável de subintegração subIntProductID, selecione productID no campo variável de integração da qual mapear e digite subIntProductID no campo Subintegração de entrada a ser mapeada.

Map values to sub-integration output(s) Mapeia as variáveis de saída da subintegração com as variáveis de integração principais.

Clique em Saída da subintegração a ser mapeada e selecione a subintegração. Clique em Variável de integração para mapear e selecione a variável de integração principal correspondente.

Práticas recomendadas

Para informações sobre os limites de uso que se aplicam à tarefa Integração de chamadas, consulte Limites de uso.

Estratégia de solução de erros

A estratégia de solução de erros para uma tarefa especifica a ação a ser realizada se a tarefa falhar devido a um erro temporário. Para mais informações sobre como usar uma estratégia de tratamento de erros e conhecer os diferentes tipos de estratégias de tratamento de erros, consulte Estratégias de tratamento de erros.

Cotas e limites

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

A seguir