For Each

A ferramenta For Each é um step que repete um conjunto de ações para cada elemento dentro de um subfluxo. A seguir, aprenda a adicioná-lo ao canvas e a configurar seu formulário.

Adicione o For Each ao canvas

  1. Clique no ícone ícone de ferramenta com sinal de mais no menu de edição à esquerda.

  2. Selecione o For Each para adicioná-lo ao canvas. Você pode usar a barra de pesquisa search steps icon para encontrá-lo.

  3. Arraste para o quadro do For Each os steps (exceto triggers) que farão parte do subfluxo.

Você pode inserir um For Each dentro de outro For Each. Dessa forma, seu fluxo de integração processará dados em estruturas com loops aninhados.

O ícone de alerta icone alerta do quadro For Each só desaparece se houver:

  • Ao menos um step no subfluxo;

  • A conexão de entrada, à esquerda;

  • A conexão de saída, à direita.

alerta for each

Para remover steps do subfluxo, sem excluí-los do canvas, há dois botões:

  • Detach: desvincula um único step do subfluxo. Selecione o step que deseja desvincular e clique no terceiro botão à direita.

  • Ungroup: desagrupa todos os steps que estão no subfluxo e deixa o quadro do For Each vazio. Selecione o quadro do For Each e clique no terceiro botão à direita.

Para excluir o For Each do canvas, selecione-o e clique no botão icone lixeira. Todos os steps dentro do subfluxo serão excluídos e as conexões removidas.

Para mover um step entre duas ferramentas de For Each, você deverá desanexá-lo do subfluxo inicial. Para isso, clique em X e arraste-o para o novo subfluxo.

Configure o formulário

  1. Selecione o For Each no canvas.

  2. Clique no ícone de edição icone lapis.

  3. Preencha os seguintes campos do formulário:

    • Name: insira um nome único para o For Each. Campo alfanumérico que permite caracteres especiais e espaços vazios, com limite de 20 caracteres.

    • Variable List: insira a lista de variáveis a serem executadas. Os valores devem ser um array (lista). Campo alfanumérico que permite caracteres especiais e espaços vazios, com limite de 1024 caracteres.

      Ao clicar no ícone de Properties icone de lista à direita, você pode:
      a. Selecionar variáveis previamente cadastradas.
      b. Criar expressões usando o Expression Builder.
    • Iteration Element: nome da estrutura que identifica os elementos dentro do For Each. Campo alfanumérico que permite caracteres especiais e espaços vazios, com limite de 250 caracteres. O nome cadastrado poderá ser visualizado em Properties ou no Data Mapping (FROM/TO) dos steps que estiverem no subfluxo do For Each.

  4. Configure o botão Ignore Errors: por padrão, o botão é desabilitado e você pode habilitá-lo.

    Habilitado switch Desabilitado switch off

    A execução continua, mesmo que haja erros no processo.

    A execução será interrompida imediatamente.

    Os logs apresentam o step com erro.

    Os logs mostram a execução até a última iteração.

    Steps após o For Each serão executados.

    Nenhum step após o For Each será executado.

    Caso seu fluxo contenha um For Each dentro de um For Each, as seguintes regras se aplicam ao botão Ignore Errors:

    For Each 1 (de fora) For Each 2 (de dentro) Resultado

    Ignore Errors desabilitado

    Ignore Errors desabilitado

    O fluxo é interrompido quando ocorre um erro.

    Ignore Errors habilitado

    Ignore Errors habilitado

    O fluxo NÃO é interrompido quando ocorre um erro.

    Ignore Errors habilitado

    Ignore Errors desabilitado

    Execução de toda a iteração do For Each 1 (de fora).

    Ignore Errors desabilitado

    Ignore Errors habilitado

    O fluxo NÃO é interrompido quando ocorre um erro.

  5. Clique em SAVE.

formulario for each
A quantidade de repetições é determinada pela quantidade de itens do array (lista).

Expression Builder

O componente Expression Builder permite que você crie expressões com parâmetros e variáveis através de funções e condições disponíveis dentro do componente. Assim, você pode ajustar a expressão conforme suas necessidades.

Siga os passos abaixo para acessar a tela do Expression Builder:

  1. Clique no ícone de Properties icone de lista, à direita do campo Variable List.

  2. Em seguida, clique no ícone icone de expressão no canto superior direito.

expression builder for each

A tela de Expression Builder contém as seguintes seções:

  • Properties: mostra os dados dos steps anteriores e as variáveis de ambiente. Você pode filtrar os atributos usando o campo de busca no topo da seção e clicando em icone lupa. Você pode selecionar mais de um atributo. Ao selecioná-lo, o atributo aparece no campo Expression.

  • Expression: campo para inserir os atributos de entrada ou criar uma expressão clicando no botão botao fx à direita. Apenas a função Concat está disponível para criar a expressão.

Ao selecionar dois ou mais atributos no campo Properties, será obrigatória a criação de uma expressão.

Para salvar as informações, clique em CONFIRM.

Thanks for your feedback!
EDIT
How useful was this article to you?