Consulte os conetores suportados para a solução Application Integration.

Tarefa de integração de chamadas

A tarefa Integração de chamadas permite-lhe 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 precisa de definir várias integrações pequenas (subintegrações) que são controladas através de uma integração principal (integração principal). Depois de executar uma subintegração, também pode ler a resposta da subintegração na sua integração principal.

Antes de começar

  • A tarefa Integração de chamadas usa o acionador da API para identificar e chamar outras integrações e subintegrações. Por conseguinte, tem de garantir que as integrações que quer chamar estão configuradas através do acionador da API. Para obter informações sobre a configuração de um acionador de API, consulte o artigo Acionador de API.
  • Certifique-se de que anexou uma conta de serviço gerida pelo utilizador à sua integração. Se a sua integração não tiver uma conta de serviço gerida pelo utilizador configurada, é utilizada por predefinição a conta de serviço predefinida (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) para autenticação.
  • Certifique-se de que a sua conta de serviço tem a função do IAM Application Integration Invoker. Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Configure a tarefa de integração de chamadas

Para configurar a tarefa Integração de chamadas:

  1. Na Google Cloud consola, aceda à página Application Integration.

    Aceda à solução Application Integration

  2. No menu de navegação, clique em Integrações.

    A página Integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

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

    Se estiver a criar uma nova integração:

    1. Introduza 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. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
    4. Clique em Criar. A integração recém-criada é aberta no editor de integração.

  4. Na barra de navegação do editor de integração, clique em Tasks para ver a lista de tarefas e conetores disponíveis.
  5. Clique e coloque o elemento Integração de chamadas no editor de integrações.
  6. Clique no elemento da tarefa Integração de chamadas no estruturador para ver o painel de configuração da tarefa Integração de chamadas.
  7. Configure os seguintes detalhes da subintegração:
    1. ID do acionador da API: escreva o ID do acionador da API da integração que quer chamar. Pode chamar uma única integração ou várias integrações com o mesmo ID do acionador.
    2. Executar todas as integrações com este ID do acionador da API: selecione esta opção para chamar todas as integrações que têm o mesmo ID do acionador da API.

      Por exemplo, se a integração A e a integração B tiverem o mesmo ID do acionador, são executadas as integrações A e B.

    3. Executar uma única integração: selecione esta opção para chamar apenas a integração especificada no campo Nome da integração. Pode aceder e mapear a resposta da subintegração configurando os campos detalhados em Mapeie as variáveis de resposta da subintegração.

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

      • ASYNC: executa a subintegração no modo assíncrono. Neste modo, a integração principal não aguarda a conclusão das subintegrações. Imediatamente após chamar as integrações secundárias, a integração principal executa as tarefas a jusante.

        Se esta opção estiver selecionada, defina o Atraso de execução (em milissegundos). Quando definida, esta política especifica o atraso de tempo até a integração ser executada.

      Todas as alterações às propriedades são guardadas automaticamente.

Mapeie as variáveis de resposta da subintegração

A tabela seguinte 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 os valores da integração principal para a subintegração. Este campo aceita valores no formato 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 quiser mapear a variável productID da integração principal para a variável subIntProductID da subintegração, selecione productID no campo Variável de integração a partir da qual mapear e introduza subIntProductID no campo Entrada da subintegração para mapear.
Map values to sub-integration output(s) Mapeia as variáveis de saída da subintegração às variáveis da integração principal.

Clique em Saída da subintegração a partir da qual fazer o mapeamento e selecione a subintegração. Clique em Variável de integração a mapear e selecione a variável de integração principal correspondente.

Práticas recomendadas

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

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?