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

Antes de começar

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.

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