Consulte os conectores compatíveis com a 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:

No console do Google Cloud, acesse a página Application Integration.
Acessar o Application Integration
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.
Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se você estiver criando uma integração:
1. Digite um nome e uma descrição no painel Create Integration.
2. 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.
3. Selecione uma conta de serviço para a integração. Você pode 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.
  Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração na região selecionada.
4. Clique em Criar.
Isso abre a integração na página do editor de integração.
Na barra de navegação do editor de integração, clique em Tarefas para conferir a lista de tarefas disponíveis.
Clique e posicione o elemento Integração de chamadas no editor de integração.
Clique no elemento de tarefa Chamar Integração no designer para ver o painel de configuração da tarefa Chamar Integração.
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.
  
  Observação: se você selecionar essa opção, a resposta das subintegrações não estará disponível na integração principal. Se você quiser acessar a resposta das subintegrações, selecione a opção Executar uma única integração.
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

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. Observação: esse campo só aparece quando a opção Executar uma única integração é selecionada com a estratégia de execução SYNC.

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.