Consulte os conetores suportados para a solução Application Integration.

Tarefa de ciclo de repetição

A tarefa While Loop permite-lhe fazer chamadas repetidas para uma subintegração a partir da sua integração atual (principal) até que uma condição especificada seja cumprida.

O ID do acionador da API e o nome da integração identificam a subintegração que quer executar.

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

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

Nota:

• A tarefa While Loop pode ser executada um máximo de 8000 iterações. Esta restrição mantém-se válida mesmo que a condição configurada resulte num ciclo infinito.
• O tamanho cumulativo dos dados recolhidos de cada execução da subintegração não pode exceder 50 MB. Se o tamanho exceder 50 MB, a integração falha e as tarefas a jusante não são executadas.

Antes de começar

• Certifique-se de que anexou uma conta de serviço gerida pelo utilizador à sua integração. Se a sua integração não tiver uma conta de serviço gerida pelo utilizador configurada, é utilizada por predefinição a conta de serviço predefinida ([e-mail]) para autenticação.
• Certifique-se de que a sua conta de serviço tem a função do IAM Application Integration Invoker. Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Propriedades de configuração

A tabela seguinte descreve as propriedades de configuração da tarefa Ciclo While.

Propriedade	Tipo de dados	Descrição
API Trigger ID	String	ID do acionador da subintegração a executar. Este valor está disponível no campo ID do acionador da API Trigger na subintegração.
Integration name	String	Nome da subintegração a executar.
While loop condition	N/A	Condição para terminar o ciclo. A subintegração é executada até que a condição seja cumprida. Por exemplo, $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s)	N/A	Valores a transmitir da integração atual para a subintegração. Os valores desta propriedade estão no formato 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, suponhamos que a sua integração principal tem a variável productID, que quer mapear para a variável de subintegração subIntProductID; selecionaria productID no menu pendente Variável de integração a partir da qual mapear e introduziria subIntProductID no campo Introdução da subintegração para mapear.
Collect values from sub-integration output(s)	N/A	Recolha os resultados das execuções da subintegração. Sempre que a subintegração é executada, pode armazenar a saída da subintegração numa variável de matriz da integração atual. Introduza a variável de saída da subintegração no campo Saída da subintegração a recolher e selecione a variável de matriz na integração atual no menu pendente Variável de integração a recolher. Cada elemento da matriz tem a resposta de uma execução de subintegração específica. Por exemplo, se a variável de matriz for resultsArray, resultsArray[0] tiver a resposta da primeira execução e resultsArray[1] tiver 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 numa variável da integração atual. Selecione a variável de saída da subintegração no menu pendente Saída da subintegração a partir da qual mapear e selecione a variável correspondente na integração atual no menu pendente Variável de integração a substituir. Pode enviar a variável substituída na integração atual para a próxima execução da subintegração mapeando a variável na propriedade Mapear para entradas de subintegração adicionais. Como resultado, 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 execuções de subintegração, como o ID de execução da subintegração, as mensagens de erro e os valores das variáveis transmitidos durante a execução. Os metadados do ciclo 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, encontra chaves duplicadas para a variável de saída, por exemplo, Current Iteration Count e current_iteration_count. Recomendamos que use as variáveis que contêm o símbolo de sublinhado (_), porque as outras chaves vão ser descontinuadas.

Práticas recomendadas

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

Estratégia de processamento de erros

Uma estratégia de processamento de erros para uma tarefa especifica a ação a realizar se a tarefa falhar devido a um erro temporário. Para obter informações sobre como usar uma estratégia de processamento de erros e conhecer os diferentes tipos de estratégias de processamento de erros, consulte o artigo Estratégias de processamento de erros.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais acerca do processamento de erros.
• Saiba mais sobre os registos de execução da integração.