Consulte os conectores compatíveis com o Application Integration.
Tarefa "Para cada loop"
A tarefa Para Cada loop permite fazer chamadas repetidas para uma subintegração a partir da integração atual (principal). A tarefa itera na variável de matriz configurada e chama a subintegração para cada elemento na matriz. O número de vezes que a subintegração é chamada é igual ao tamanho da variável da matriz.
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
Response parameter override mapping.
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 Para cada loop.
| 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. |
List to iterate
|
Matriz do tipo Booleana, String, Integer, Double ou JSON. | Lista de valores para os quais as subintegrações são executadas. A
subintegração é executada para cada valor na lista, um após o outro.
Para transmitir o valor iterado à subintegração, defina a propriedade Mapeamento de subintegração do elemento de iteração. Nesta propriedade, especifique a variável na subintegração à qual o valor iterado precisa ser mapeado. |
Iteration element sub-integration mapping |
N/A | Variável na subintegração à qual o elemento iterado atual precisa ser atribuído. |
Map to additional sub-integration input(s)
|
N/A | Valores adicionais a serem transferidos 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 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.
Selecione a variável de saída da subintegração na lista suspensa Saída de subintegração da qual coletar
e 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 |
Response parameter override mapping
|
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 das subintegrações, como ID
da execução de subintegração, mensagens de erro e valores de variáveis 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.
|
Exemplos
As seções a seguir fornecem exemplos detalhados de como configurar e usar a tarefa Para cada loop em cenários específicos. Estes exemplos ilustram as etapas de configuração para diferentes casos de uso:
- Iterar e transmitir cada elemento
- Coletar saídas de subintegração
- Agregar resultados com substituição de resposta
- Transmitir outras entradas
Iterar e transmitir cada elemento
Suponha que você tenha uma integração principal com uma variável de matriz chamada productIds que contém valores como ["P1", "P2", "P3"]. Para chamar uma subintegração chamada GetProductDetails para cada ID do produto, configure a tarefa Para cada repetição da seguinte maneira:
- Defina Lista a ser percorrida como
productIds. - Defina Mapeamento de subintegração do elemento de iteração para mapear o elemento atual de
productIdspara uma variável emGetProductDetails, por exemplo,subIntProductId.
Cada execução de GetProductDetails recebe um ID de produto de productIds.
Coletar saídas de subintegração
Como no exemplo anterior, suponha que GetProductDetails retorne um objeto JSON em uma variável de saída chamada productInfo.
Para coletar todas as saídas productInfo de cada execução de subintegração e armazená-las como elementos em uma variável de matriz na integração principal:
- Configure Coletar valores das saídas das subintegrações.
- Selecione
productInfoem Saída de subintegração da qual coletar. - Selecione uma variável de matriz na integração principal, por exemplo,
allProductDetails, em Variável de integração em que coletar.
Depois que o loop for concluído, allProductDetails será uma matriz em que cada elemento é o JSON productInfo de uma execução de subintegração.
Agregar resultados com substituição de resposta
Suponha que você tenha uma integração principal que chama uma subintegração (por exemplo, GetProductDetails) para cada item em uma lista e queira calcular o preço total de todos os itens. Para somar um valor numérico retornado por cada execução de subintegração:
- Verifique se a subintegração retorna um valor em uma variável de saída
itemPrice. - Inicialize a variável
totalPricecomo0na integração principal. - Configure o Mapeamento de modificação de parâmetros de resposta:
- Mapeie
itemPrice(da subintegração) paratotalPrice(na integração principal).
- Mapeie
- Na seção Mapear para mais entradas de subintegração:
- Mapeie
totalPrice(da integração principal) para uma variável de entrada na subintegração, por exemplo,currentTotal.
- Mapeie
- Na lógica da subintegração, adicione o preço do item atual ao
currentTotalrecebido da integração principal. Em seguida, retorne essa nova soma na variável de saída chamadaitemPrice. Esse processo cria uma agregação cumulativa.
Transmitir outras entradas
Se a subintegração GetProductDetails precisar de um código currency da integração principal, faça o seguinte:
- Na seção Mapear para mais entradas de subintegração:
- Mapeie a variável de integração principal
currencyCodepara a variável de entrada de subintegraçãosubIntCurrency.
- Mapeie a variável de integração principal
- Esse
currencyCodeé transmitido para todas as execuções da subintegração.
Confira os seguintes exemplos de integração para guias práticos e exemplos executáveis dos conceitos discutidos nas seções anteriores:
- Invocar uma subintegração usando uma tarefa "Para cada repetição"
- Exemplo de integração de e-commerce
Práticas recomendadas
Para informações sobre os limites de uso aplicáveis à tarefa Para cada 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.