Consulte os conectores compatíveis com a integração de aplicativos.

Tarefa "Durante o loop"

A tarefa Repetição while permite fazer chamadas repetidas para uma subintegração a partir da 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ê 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 Override values from sub-integration output(s).

Observação:

• A tarefa Repetição while pode executar até 8.000 iterações. Essa restrição é válida mesmo que a condição configurada resulte em um loop infinito.
• 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.

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 repetição while.

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.
While loop condition	N/A	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/A	Valores a serem transmitidos 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 a sua integração principal tenha a variável productID, que você quer associar à variável de subintegração subIntProductID. Você seleciona productID na lista suspensa Variável de integração da qual mapear e insere subIntProductID no campo Entrada de subintegração para a qual mapear.
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. Insira a variável de saída da subintegração no campo Saída de subintegração da qual coletar e selecione 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.
Override values from sub-integration output(s)	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 da subintegração é executada como o ID de execução, as mensagens de erro e os valores de variável 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 que se aplicam à tarefa While 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.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.