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
- 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 (
service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com
) 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
|
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 |
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
- 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.