Tarefa "Chamar integração"

Aviso: o Application Integration já está disponível para seu projeto do Google Cloud. Agora é possível usar a Apigee Integration e o Application Integration no mesmo projeto do Google Cloud. Saiba mais

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 ([e-mail]) 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. Na IU da Apigee, selecione sua organização da Apigee.
2. Clique em Desenvolver > Integrações.
3. Selecione uma integração existente ou clique em Criar integração.

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

   1. Digite um nome e uma descrição na caixa de diálogo Criar integração.
   2. Selecione uma Região para a integração na lista de regiões compatíveis.
   3. Clique em Criar.

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

4. Na barra de navegação do designer de integração, clique em +Adicionar uma tarefa/gatilho> Tarefas para conferir a lista de tarefas 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.

      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
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.

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.