Lógica de fluxo "for each"

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 3 min. de leitura
  • Aplique uma ou mais ações a cada registro em uma lista de registros.

    A lógica de fluxo Para cada aplica uma ou mais ações a uma lista de registros. O fluxo aplica as ações contidas na lógica de fluxo a cada registro na lista.
    Nota:
    Quando você define um valor de cápsula de dados de dentro de uma ramificação Para cada item da lógica de fluxo, o valor da cápsula de dados só está disponível para outras ações na mesma ramificação. Fazer referência a um valor de cápsula de dados que foi definido dentro de uma ramificação Para cada de fora da ramificação da lógica de fluxo produz um valor nulo.

    em um grande número de registros pode consumir muitos recursos, especialmente quando o bloco lógico de fluxo inclui ações complexas para cada iteração. Para evitar problemas de desempenho, desative o relatório usando a propriedade do sistema com.snc.process_flow.reporting.level. Para obter mais informações, consulte Propriedades do sistema Flow Designer.

    Entradas

    Entrada Descrição
    Itens
    Cápsula de dados de Lista ou Registros que especifica os registros a serem processados em sequência.
    • Cápsula de dados de matriz
    • Cápsula de dados da lista
    • Cápsula de dados de registros

    Por exemplo, você pode usar a lista de designados adicional para um registro de incidente. Para obter informações sobre cápsulas de dados, consulte Flow Designer dados.

    Nota:
    Se você quiser processar itens em uma ordem específica, deverá classificar os itens nesta entrada com antecedência. Por exemplo, use a opção Ordenar por para classificar os resultados de uma ação de registros de pesquisa.

    Saídas

    Saída Descrição
    [Nome da tabela] Registro Registro atual no loop.
    Nota:

    Para otimizar o desempenho, evite iterar em listas com mais de 1.000 registros. Para iterar em listas com mais de 1.000 registros, divida a lista em seções menores e use vários fluxos.

    Você pode aninhar um bloco de lógica de fluxo "for each" dentro de outro bloco de lógica de fluxo para repetir uma ação em uma série de registros. No entanto, evite loops "for each" aninhados que processam muitos registros. Os loops aninhados podem fazer com que o fluxo seja executado até que seja interrompido pela regra de cota de transação de fluxo, o que evita que os fluxos sejam executados por mais de uma hora. Para obter mais informações sobre cotas de transação, consulte cotas do Transactions.

    Por padrão, ao exibir os detalhes de execução de um fluxo, as últimas 50 iterações de ações de uma lógica de fluxo Para cada aparecem nos detalhes da etapa. Para exibir mais iterações de ação para uma lógica de fluxo Para cada nos detalhes da execução, altere o valor da propriedade a seguir em Automação de Processo > Administração do Fluxo > Propriedades: Número de iterações recentes a serem relatadas para loops Fazer até e Para cada. Por exemplo, se tivermos 100 iterações e o número for 5, relataremos as iterações 96 a 100. Se o número for -1, relataremos todas as iterações. Se o número for 0, relataremos 1 iteração.

    Enviar um e-mail para cada pessoa atribuída a um problema

    Este fluxo de amostra começa quando um registro de problema é criado. O fluxo usa a lógica de fluxo Para cada para enviar um e-mail para cada designado adicional listado no registro do gatilho. O campo Designado adicional do registro do problema de acionamento contém a lista de registros que você deseja processar.

    Quando o loop é criado, uma nova entrada aparece no painel de dados à direita chamada 1 - para cada. Nessa entrada, você vê uma cápsula de Dados de registro da lista de designados adicionais que contém as informações do usuário para os usuários nesse campo.

    Figura 1. Entradas usadas em para cada lógica de fluxo
    Uma ramificação da lógica de fluxo Para cada com uma ação Enviar e-mail.

    O ícone de adição (ícone de adição) abaixo desta ação de e-mail é usado para adicionar ações adicionais, como registro em log, ao loop.

    Detalhes da execução

    Figura 2. Detalhes de execução para um fluxo
    Detalhes de execução de exemplo para o fluxo.
    A guia de detalhes de execução de fluxo fornece informações de tempo de execução na lógica de fluxo.
    1. O cabeçalho mostra o estado, a hora de início e o tempo de execução da lógica de fluxo.
    2. Essa lógica de fluxo pode executar ações ou subfluxos várias vezes. Use as teclas de seta para percorrer cada uma dessas instâncias e ver seus valores.
    3. A seção Detalhes da configuração mostra quais registros o fluxo avaliou.
    4. Após a seção Para cada, estão as ações realizadas nela. Os valores dessas ações mudam conforme você percorre as ações que são realizadas por esta lógica de fluxo.