Tarefa "Para cada paralelo"

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

• 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 "Para cada paralelo"

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

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