Tarefa "Para cada loop"

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 Para Cada loop permite fazer chamadas repetidas para uma subintegração a partir da integração atual (principal). A tarefa itera na variável de matriz configurada e chama a subintegração para cada elemento na matriz. O número de vezes que a subintegração é chamada é igual ao tamanho da variável da matriz.

O ID do gatilho da API e o Nome da integração identificam a subintegração que você quer executar.

A tarefa também permite coletar a resposta de cada execução de subintegração e armazenar o valor na integração atual para uso em tarefas downstream. É possível usar qualquer uma das abordagens a seguir para coletar as respostas:

• Agrupe a resposta de cada execução em uma variável de matriz, em que cada elemento da matriz tem a resposta de uma execução específica. Para agrupar as respostas, configure a propriedade Collect values from sub-integration output(s).
• Agregue as respostas de todas as execuções em uma única variável. Para agregar as respostas, configure a propriedade Response parameter override mapping.

Observação:

• A tarefa Para cada loop pode executar no máximo 8.000 iterações.
• O tamanho cumulativo dos dados coletados em cada execução de subintegração não pode exceder 50 MB. Se o tamanho exceder 50 MB, a integração falhará e as tarefas downstream não serão executadas.
• Se uma integração na tarefa Para cada loop falhar, a tarefa inteira falhará e as tarefas downstream não serão executadas. Para evitar falha em toda a integração, especifique uma Estratégia de execução para a tarefa no painel de configuração de mesclagem. Consulte Mesclar para mais detalhes.

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.

Propriedades de configuração

A tabela a seguir descreve as propriedades de configuração da tarefa Para cada loop.

Propriedade	Tipo de dado	Descrição
API Trigger ID	String	ID do acionador da subintegração a ser executada. Esse valor está disponível no campo ID do acionador do gatilho da API usado na subintegração.
Integration name	String	Nome da subintegração a ser executada.
List to iterate	Matriz do tipo Booleana, String, Integer, Double ou JSON.	Lista de valores para os quais as subintegrações são executadas. A subintegração é executada para cada valor na lista, um após o outro. Para transmitir o valor iterado à subintegração, defina a propriedade Mapeamento de subintegração do elemento de iteração. Nesta propriedade, especifique a variável na subintegração à qual o valor iterado precisa ser mapeado.
Iteration element sub-integration mapping	N/A	Variável na subintegração à qual o elemento iterado atual precisa ser atribuído.
Map to additional sub-integration input(s)	N/A	Valores adicionais a serem transferidos da integração atual para a subintegração. Os valores dessa propriedade estão na forma de pares de chave-valor, em que a chave é uma variável na integração atual e o valor é a variável de entrada correspondente na subintegração. Por exemplo, suponha que sua integração principal tenha a variável productID, que você quer mapear para a variável de subintegração subIntProductID; você selecionaria productID na Variável de integração a ser mapeada na lista suspensa e selecionaria subIntProductID na lista suspensa Entrada de subintegração a ser mapeada.
Collect values from sub-integration output(s)	N/A	Agrupe os resultados das execuções de subintegração. Toda vez que a subintegração é executada, é possível armazenar a saída dela em uma variável de matriz da integração atual. Selecione a variável de saída da subintegração na lista suspensa Saída de subintegração da qual coletar e a variável de matriz na integração atual na lista suspensa Variável de integração na qual coletar. Cada elemento da matriz tem a resposta de uma execução de subintegração específica. Por exemplo, se a variável da matriz for resultsArray, resultsArray[0] terá a resposta da primeira execução e resultsArray[1] terá a resposta da segunda execução.
Response parameter override mapping	N/A	Leia a variável de saída de uma execução de subintegração e armazene-a em uma variável da integração atual. Selecione a variável de saída da subintegração na lista suspensa Saída da subintegração da qual mapear e selecione a variável correspondente na integração atual na lista suspensa Variável de integração a ser modificada. É possível enviar a variável modificada na integração atual para a próxima execução de subintegração mapeando a variável na propriedade Mapear para entradas de subintegração adicionais. Como resultado, você pode agregar cumulativamente as respostas das execuções de subintegração.
Loop metadata	Matriz JSON	A variável de saída que tem os detalhes de execução das subintegrações, como ID da execução de subintegração, mensagens de erro e valores de variáveis transmitidos durante a execução. Os metadados de loop contêm variáveis que incluem as seguintes variáveis de saída: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element e failure_message. Aviso:nos metadados de loop, você vai encontrar chaves duplicadas para a variável de saída, por exemplo, Current Iteration Count e current_iteration_count. Recomendamos usar as variáveis que contêm o símbolo de sublinhado (_), porque as outras chaves vão ser descontinuadas.

Práticas recomendadas

Para informações sobre os limites de uso aplicáveis à tarefa Para cada loop, 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.