Consulte os conectores compatíveis com o Application Integration.

Tarefa "Para cada paralelo"

A tarefa Foreach paralelo permite executar outras integrações (subintegrações) a partir da integração principal. Como o nome da tarefa sugere, as sub integrações são executadas em paralelo.

Essa tarefa usa o ID do gatilho da API como uma alça para identificar as integrações a serem executadas. Por exemplo, se você especificar o ID do gatilho da API como api_trigger/APITriggerX, a tarefa executará todas as subintegrações com o ID do gatilho api_trigger/APITriggerX.

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

Antes de começar

Configurar a tarefa "Para cada paralelo"

Para configurar a tarefa Para cada paralelo, siga estas instruções:

  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. 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 da 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 de tarefa Para cada paralelo no editor de integração.
  6. Clique no elemento da tarefa Para cada paralelo no designer para abrir o painel de configuração da tarefa Para cada paralelo.
  7. Configure os campos restantes usando as propriedades de configuração para a tarefa, conforme detalhado nas tabelas abaixo.

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

Propriedades de configuração

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

Propriedades de entrada

Nome da propriedade Nome do parâmetro Tipo de dado Descrição
Seleção de matriz List to iterate Matriz do tipo string, inteira, dupla ou JSON. Lista de valores para os quais as subintegrações são executadas. Uma linha de execução de subintegração separada é executada para cada valor na lista, e todas as linhas de execução são executadas em paralelo.

É possível transmitir o valor iterado para a subintegração definindo o campo Onde mapear elementos individuais da matriz.

Também é possível transmitir valores adicionais da integração principal à subintegração no campo Mapear para mais entradas de subintegração.

Detalhes da subintegração API Trigger ID String ID do gatilho da subintegração publicada a ser executada.

Esse valor está disponível no campo ID do acionador do gatilho da API usado na subintegração.

Execution strategy N/A

SYNC: executa as subintegrações 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 as subintegrações no modo assíncrono. Nesse 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 downstream.
Run all integrations with this API Trigger ID N/A Executa todas as integrações que têm o mesmo ID de acionador da API.

Por exemplo, se a integração A e a integração B têm o mesmo ID do gatilho da API, as integrações A e B são executadas para cada item na Lista para iteração.

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 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. É possível usar a resposta das subintegrações configurando a seção Coletar 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 em que os elementos da matriz devem ser mapeados. Os elementos da matriz podem ser mapeados diretamente para uma variável de entrada de subintegração. Se uma única subintegração for selecionada, você poderá selecionar a variável de entrada de subintegração em uma lista suspensa.
Map to additional sub-integration input(s) String Opção adicional de mapeamento de subintegração.
  • Variável de integração a ser mapeada: o nome da variável na integração atual a ser transmitida para a variável de entrada da subintegração.
  • Entrada de subintegração a ser mapeada: o nome da variável de entrada de subintegração a ser mapeada.

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, suponha que a integração principal tenha a variável productID, que você quer mapear para a variável de subintegração subIntProductID. Para isso, selecione productID no campo Variável de integração a mapear e insira subIntProductID no campo Entrada de subintegração a ser mapeada.

Collect values from sub-integration output(s) String Se a estratégia de execução for síncrona (SYNC) e uma única subintegração (Executar uma única integração) estiver selecionada, as saídas da subintegração podem ser coletadas em variáveis de matriz na integração atual.
  • Saída de subintegração a ser coletada: o nome da variável de saída de subintegração a ser agregada.
  • Variável de integração a ser coletada: o nome da variável na integração atual para coletar as saídas agregadas.
Configuraçõ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 padrão é 50 (máximo de 10000).

Todas as subintegrações em uma coorte são executadas completamente antes da execução da próxima coorte de subintegrações.

Ignore failures Booleano

É possível especificar qualquer um dos seguintes valores:

  • Verdadeiro: a tarefa ignora as falhas de subintegração e executa todas as execuções.
  • Falso: a tarefa apresenta erros por falhas de subintegração e encerra todas as execuções.

Práticas recomendadas

Recomendamos as seguintes práticas recomendadas ao usar a tarefa Para cada paralelo:

  • Defina o tamanho da coorte com base em qualquer limitação de cota imposta pelas subintegrações.
  • Use uma estratégia de execução de SYNC quando quiser coletar a saída da subintegração para uso posterior.
  • Use uma estratégia de execução ASYNC quando sua subintegração puder ser executada por mais de 2 minutos.

Para informações sobre os limites de uso aplicáveis à tarefa Para cada paralelo, consulte Limites de uso.

Considerações

Em geral, não use uma estratégia de execução de SYNC se a subintegração levar mais de 2 minutos para ser executada ou se você planeja usar essa tarefa com tarefas naturalmente assíncronas, como a tarefa de Aprovação.

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