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

Para cada tarefa paralela

A tarefa For Each Parallel permite-lhe executar outras integrações (subintegrações) a partir da sua integração principal. Como o nome da tarefa sugere, as subintegrações são executadas em paralelo.

Esta tarefa usa o ID do acionador da API como um identificador para identificar as integrações a executar. Por exemplo, se especificar o ID do acionador da API como api_trigger/APITriggerX, a tarefa executa todas as subintegrações que têm o ID do acionador api_trigger/APITriggerX.

Depois de executar uma subintegração, também pode ler a resposta da subintegração na sua integração principal. Use esta tarefa para executar subintegrações como dependências da integração principal.

Antes de começar

Configure a tarefa Para cada paralelo

Para configurar a tarefa Para cada paralelo:

  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 de tarefa Para cada paralelo no editor de integração.
  6. Clique no elemento de tarefa Para cada paralelo no criador para abrir o painel de configuração da tarefa Para cada paralelo.
  7. Configure os campos apresentados através das propriedades de configuração da tarefa, conforme detalhado nas tabelas abaixo.

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

Propriedades de configuração

Esta secção descreve as propriedades de configuração da tarefa Para cada paralelo.

Propriedades de entrada

Nome da propriedade Nome do parâmetro Tipo de dados Descrição
Seleção de matriz List to iterate Uma matriz do tipo string, inteiro, duplo ou JSON. Lista de valores para os quais as subintegrações têm de ser executadas. É executada uma thread de subintegração separada para cada valor na lista e todas as threads são executadas em paralelo.

Pode transmitir o valor iterado para a subintegração definindo o campo Onde mapear elementos individuais da matriz.

Também pode transmitir valores adicionais da integração principal para a subintegração no campo Mapear para entradas de subintegração adicionais.

Detalhes da subintegração API Trigger ID String ID do acionador da subintegração publicada a executar.

Este valor está disponível no campo ID do acionador da API Trigger na subintegração.

Execution strategy N/A

SYNC: executa as subintegrações 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 as subintegrações no modo assíncrono. Neste modo, a integração principal não aguarda a conclusão das subintegrações. Imediatamente após chamar as subintegrações, a integração principal executa as tarefas a jusante.
Run all integrations with this API Trigger ID N/A Executa 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 da API, ambas as integrações A e B são executadas para cada item em Lista a iterar.

Nota: se selecionar esta opção, a resposta das subintegrações não fica disponível na integração principal. Se quiser usar a resposta das subintegrações, selecione a opção Executar uma única integração.

Run a single integration N/A Executa apenas a integração especificada no campo Nome da integração. Pode usar a resposta das subintegrações configurando a secção Recolher valores das saídas das subintegrações.

Em cada execução Where to map individual array elements String O nome da variável de entrada da subintegração onde os elementos da matriz devem ser mapeados. Os elementos do array podem ser mapeados diretamente para uma variável de entrada de subintegração. Se for selecionada uma única subintegração, pode selecionar a variável de entrada da subintegração numa lista pendente.
Map to additional sub-integration input(s) String Opção de mapeamento de subintegração adicional.
  • Variável de integração a mapear: o nome da variável na integração atual a ser transmitida à variável de entrada da subintegração.
  • Entrada da subintegração a mapear: o nome da variável de entrada da subintegração a mapear.

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, considere que a sua integração principal tem a variável productID, que quer mapear para a variável de subintegração subIntProductID. Tem de selecionar productID no campo Variável de integração a partir da qual mapear e introduzir subIntProductID no campo Introdução da subintegração a mapear.

Collect values from sub-integration output(s) String Se a estratégia de execução for síncrona (SYNC) e for selecionada uma única subintegração (Executar uma única integração), os resultados da subintegração podem ser recolhidos em variáveis de matriz na integração atual.
  • Saída da subintegração a partir da qual os dados vão ser recolhidos: o nome da variável de saída da subintegração a ser agregada.
  • Variável de integração para recolher em: o nome da variável na integração atual para recolher as saídas agregadas.
Definições de execução Integrations to execute at a time (parallel) Número inteiro Número máximo de execuções paralelas permitidas para subintegrações. O valor predefinido é 50 (10000 máximo).

Todas as subintegrações numa coorte são executadas completamente antes de ser executada a coorte seguinte de subintegrações.

Ignore failures Booleano

Pode especificar qualquer um dos seguintes valores:

  • Verdadeiro: a tarefa ignora as falhas de subintegração e executa todas as execuções.
  • Falso: a tarefa falha devido a falhas de subintegração e termina todas as execuções.

Práticas recomendadas

Recomendamos as seguintes práticas recomendadas quando usar a tarefa For Each Parallel:

  • Defina o tamanho do coorte com base nas limitações de quota impostas pelas suas subintegrações.
  • Use uma estratégia de execução SYNC quando quiser recolher o resultado da subintegração para utilização posterior.
  • Use uma estratégia de execução ASYNC quando a sua subintegração puder ser executada durante mais de 2 minutos.

Para informações sobre os limites de utilização que se aplicam à tarefa For Each Parallel, consulte Limites de utilização.

Considerações

Em geral, não use uma estratégia de execução SYNC se a sua subintegração demorar mais de 2 minutos a ser executada ou se planear usar esta tarefa em conjunto com tarefas naturalmente assíncronas, como a tarefa de aprovaçã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?