Tarefa de loop while

A tarefa While Loop permite que você faça chamadas repetidas para uma subintegração da sua integração atual (principal) até que uma condição especificada seja atendida.

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

A tarefa também permite coletar a resposta de cada execução de subintegração e armazenar o valor na sua integração atual para uso em tarefas posteriores. Você pode usar qualquer uma das seguintes abordagens para coletar as respostas:

Agrupe a resposta de cada execução em uma variável de matriz, onde cada elemento da matriz contém 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 Override values from sub-integration output(s) .

Antes de começar

Certifique-se de ter anexado uma conta de serviço gerenciada pelo usuário à sua integração. Se a sua integração não tiver uma conta de serviço gerenciada pelo usuário configurada, a conta de serviço padrão ( service- PROJECT_NUMBER @gcp-sa-integrations.iam.gserviceaccount.com ) é usado para autenticação.
Certifique-se de que sua conta de serviço tenha a função IAM " Invocador de Integração de Aplicativos ". Para obter informações sobre como conceder funções a uma conta de serviço, consulte Gerenciar acesso a contas de serviço .

Propriedades de configuração

A tabela a seguir descreve as propriedades de configuração da tarefa While Loop .

Propriedade	Tipo de dados	Descrição
`API Trigger ID`	Corda	ID do gatilho da subintegração a ser executada. Este valor está disponível no campo ID do gatilho do gatilho da API na subintegração.
`Integration name`	Corda	Nome da subintegração a ser executada.
`While loop condition`	N / D	Condição para encerrar o loop. A subintegração é executada até que a condição seja atendida. Por exemplo, `$loopMetadata.current_iteration_count$< 10` .
`Map to sub-integration input(s)`	N / D	Valores a serem passados da integração atual para a subintegração. Os valores desta propriedade estão na forma de pares chave-valor, onde 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ê deseja mapear para a variável de subintegração `subIntProductID` ; você selecionaria `productID` no menu suspenso " Variável de integração a ser mapeada" e inseriria `subIntProductID` no campo "Entrada da subintegração a ser mapeada ".
`Collect values from sub-integration output(s)`	N / D	Reúna os resultados das execuções de subintegração. Sempre que a subintegração for executada, você pode armazenar a saída da subintegração em uma variável de matriz da integração atual. Insira a variável de saída da subintegração no campo "Saída da subintegração a ser coletada " e selecione a variável de matriz na integração atual no menu suspenso " Variável de integração a ser coletada em ". Cada elemento da matriz contém a resposta de uma execução de subintegração específica. Por exemplo, se a variável de matriz for `resultsArray` , `resultsArray[0]` terá a resposta da primeira execução e `resultsArray[1]` terá a resposta da segunda execução.
`Override values from sub-integration output(s)`	N / D	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 no menu suspenso "Saída da subintegração a ser mapeada " e selecione a variável correspondente na integração atual no menu suspenso " Variável de integração a ser substituída ". Você pode enviar a variável substituída na integração atual para a próxima execução de subintegração mapeando a variável na propriedade "Mapear para entradas adicionais de subintegração" . 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 contém os detalhes da execução da subintegração, como o ID de execução da subintegração, mensagens de erro e valores de variáveis passados durante a execução. Os metadados do loop contêm variáveis, incluindo 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 do Loop, você encontrará chaves duplicadas para a variável de saída, por exemplo, `Current Iteration Count` e `current_iteration_count` . Recomendamos que você use as variáveis que contêm o símbolo de sublinhado ( `_` ), pois as outras chaves estão sendo descontinuadas.

Melhores práticas

Para obter informações sobre os limites de uso que se aplicam à tarefa While Loop , consulte Limites de uso .

Estratégia de tratamento de erros

Uma estratégia de tratamento de erros para uma tarefa especifica a ação a ser tomada se a tarefa falhar devido a um erro temporário . Para obter 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 obter informações sobre cotas e limites, consulte Cotas e limites .

O que vem a seguir

Saiba mais sobre todas as tarefas e gatilhos .
Aprenda como testar e publicar uma integração .
Aprenda sobre tratamento de erros .
Saiba mais sobre logs de execução de integração .