Veja os conectores suportados para integração de aplicativos.
Tarefa Para Cada Loop
A tarefa "For Each Loop" permite fazer chamadas repetidas para uma subintegração a partir da sua integração atual (principal). A tarefa itera sobre a variável de array configurada e chama a subintegração para cada elemento do array. O número de vezes que a subintegração é chamada é igual ao tamanho da variável de array.
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
Response parameter override mapping.
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 For Each 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. |
List to iterate | Uma matriz do tipo Boolean, String, Integer, Double ou JSON. | Lista de valores para os quais a subintegração deve ser executada. A subintegração é executada para cada valor da lista, um após o outro. Você pode passar o valor iterado para a subintegração definindo a propriedade de mapeamento de subintegração do elemento Iteração . Nessa propriedade, especifique a variável na subintegração para a qual o valor iterado deve ser mapeado. |
Iteration element sub-integration mapping | N / D | Variável na subintegração para a qual o elemento iterado atual deve ser atribuído. |
Map to additional sub-integration input(s) | N / D | Valores adicionais 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 |
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. Selecione a variável de saída da subintegração no menu suspenso "Saída da subintegração a ser coletada " e 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 |
Response parameter override mapping | 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 das subintegrações, como 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 . |
Melhores práticas
Para obter informações sobre os limites de uso que se aplicam à tarefa For Each 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 .