Selecionar itens

O nó Selecionar itens (Selector) escolhe um item, ou vários itens, de uma lista. Você escolhe como selecionar: por posição, por intervalo, aleatoriamente, por uma regra sobre um campo ou por nome. O Selecionar itens envia os itens escolhidos para a saída Selecionados e todos os outros itens para a saída Restantes. Ele é executado na hora, não chama nenhum modelo e não custa créditos.

Quando usar

• A mesma escolha alimenta vários nós. Um Selecionar itens substitui a mesma configuração em várias conexões.
• Você quer um item aleatório de uma lista e quer repetir a mesma escolha depois, com uma seed.
• Você quer o item cujo campo tem um valor específico, como o personagem chamado hero, ou todos os itens com pontuação de 15 ou mais.
• Você quer enviar os itens que não escolheu para outro lugar, pela saída Restantes.
• Você quer percorrer uma lista curta em ciclo com um número vindo de outro nó.

Início rápido

Entradas e saídas

Juntas, Selecionados e Restantes sempre cobrem todos os itens de entrada, e nenhum item fica nas duas. O Selecionar itens divide pela posição, não pelo valor, então os itens duplicados caem no lado certo. Por exemplo, com a, b, a, c e um intervalo de 2 a 3, Selecionados é b, a e Restantes é a, c.

Modos

Item

O Índice conta a partir de 1. Escreva um número como 3, ou conte a partir do fim com last e last-1, last-2 e assim por diante. Um índice além do fim da lista usa o item válido mais próximo. Um índice que não pode ser lido usa o primeiro item.

Intervalo

De e Até são ambos incluídos e contam a partir de 1. Um Passo negativo anda para trás, de um De maior até um Até menor. Os itens escolhidos continuam na ordem original da lista: em a, b, c, d, de last até 1 com passo -2 escolhe b, d. Um passo de 0 conta como 1. Um intervalo que avança com passo negativo, ou que recua com passo positivo, não escolhe nada.

Lista

A Expressão mistura posições únicas e intervalos, separados por vírgulas, por exemplo 1, 3..5, last. Os itens escolhidos ficam na ordem original da lista, seja qual for a ordem em que você os escreve, e uma posição escrita duas vezes é escolhida uma vez só. Outros exemplos: 1..5, 1..10:2 para um item a cada dois e 1..last-1 para todos os itens, menos o último. Uma parte que não pode ser lida faz o nó escolher todos os itens.

Aleatório

A Quantidade é o número de itens a sortear, e o padrão é 1. Cada item é sorteado no máximo uma vez, e uma quantidade maior que a lista escolhe a lista inteira. Com uma Seed, a mesma seed e a mesma lista sempre geram a mesma escolha. Sem seed, cada execução sorteia de novo.

Módulo

O módulo escolhe um item dividindo o Divisor pelo tamanho da lista. O resto é a posição, contada a partir de 0. Por exemplo, um divisor de 5 em uma lista de 3 itens deixa resto 2, que é o terceiro item. Use-o para percorrer uma lista curta em ciclo com um número que muda, vindo de outro nó. Um divisor que não é um número usa o primeiro item.

Predicado

O predicado mantém os itens cujo Campo passa em um teste. Deixe o Campo vazio para testar o item inteiro. O Operador é um destes: é igual a, é diferente de, maior que, menor que, maior ou igual, menor ou igual, contém, não contém, começa com, termina com, corresponde à regex, existe e não existe. Com Correspondência definida como Primeiro, o Selecionar itens escolhe só a primeira correspondência; com Todos, escolhe todas as correspondências. Uma regra que não corresponde a nada envia todos os itens para Restantes.

Chave nomeada

A chave nomeada é a forma curta do predicado para uma busca por nome: ela escolhe o primeiro item cujo Campo é igual ao Valor. Quando nada corresponde, Selecionados fica vazio e todos os itens vão para Restantes.

Usar um valor de outro nó

Quatro campos aceitam o rótulo de outro nó entre chaves, como {CharacterName}. Quando o Selecionar itens é executado, as chaves são substituídas pelo valor desse nó.

Todos os outros campos são lidos exatamente como foram digitados. Leia mais em Variáveis de prompt.

Quando uma configuração está errada

O Selecionar itens nunca interrompe um workflow por causa de uma configuração. Cada problema tem um resultado seguro:

O nó só falha em um erro inesperado e, nesse caso, mostra a mensagem de erro.

Selecionar itens ou uma configuração de conexão

Toda conexão também pode escolher itens com o modo Item, ou com as abas de intervalo e de lista dos modos Cada item e Conjunto. Os dois contam as posições do mesmo jeito. Em uma conexão, os itens mantêm a ordem em que você os escolhe: de last até 1 com passo -1 inverte a lista, e uma posição escrita duas vezes é passada duas vezes.

Leia Listas e lotes para ver todos os modos de conexão.

Créditos

O Selecionar itens é gratuito em todas as edições.

Dicas

• Execute o próximo nó por escolha. Selecionados sempre envia uma lista. Mude a conexão que sai de Selecionados para Cada item para executar o próximo nó uma vez por item escolhido.
• Confira as contagens. A Última execução mostra quantos itens foram para Selecionados e para Restantes, que é o jeito mais rápido de testar uma regra.
• Filtre muitos, escolha um. Para manter todos os itens que atendem a várias condições, use o Filtrar lista. Para escolher um item ou uma fatia, use o Selecionar itens.