Appearance
Operador de Lista · list_operator
Referência do nó
Kind:list_operatorCategoria:DadosPara que serve
Imagina que você tem uma caixa com 50 fichas de clientes e precisa encontrar só as que têm mais de R$ 1.000 em débito, ordenadas pela data mais recente, pegando só as 5 primeiras. O Operador de Lista faz isso com arrays do seu fluxo: recebe uma lista de itens e aplica filtros, ordenação, limite ou extração — devolvendo exatamente o que você precisa.
Quando usar
- Filtrar resultados de uma API (ex.: mostrar só produtos com estoque disponível)
- Pegar os N primeiros ou últimos itens de uma lista
- Ordenar uma lista por data, valor ou qualquer campo
- Extrair um único item específico de uma coleção
- Limitar o tamanho de uma lista antes de passar para um nó de iteração
Passo a passo
- Certifique-se de ter uma lista disponível no fluxo — vinda de um nó HTTP, Data Source ou de uma variável.
CAPTURAR: fluxo com nó HTTP retornando uma lista de itens conectado ao list_operator
- Arraste o nó **Operador de Lista** para o canvas e conecte à fonte da lista.
- Informe a **Variável de entrada** que contém a lista.
- Configure as operações que quer aplicar (filtragem, ordenação, limite, extração).CAPTURARCAPTURAR: painel do list_operator com filtro, ordenação e limite configurados
- Salve. A saída processada fica em
{{list_operator.result}}.
Operações disponíveis
Filtrar
Mantém só os itens que atendem a uma condição.
| Campo | O que preencher |
|---|---|
| Campo | Qual propriedade do item verificar (ex.: status) |
| Operador | igual a / diferente de / contém / maior que / menor que |
| Valor | O valor para comparar (pode usar variáveis {{ }}) |
Ordenar
Reorganiza os itens da lista.
| Campo | O que preencher |
|---|---|
| Campo | Propriedade usada para ordenar (ex.: data_criacao) |
| Direção | Crescente (A→Z, 0→9) ou Decrescente (Z→A, 9→0) |
Limitar
Corta a lista para N itens.
| Campo | O que preencher |
|---|---|
| Máximo de itens | Número inteiro — quantos itens manter |
Extrair item
Pega um único item da lista pelo índice.
| Campo | O que preencher |
|---|---|
| Índice | Posição do item (0 = primeiro, 1 = segundo, -1 = último) |
Exemplo
Cenário: você recebe uma lista de agendamentos do sistema e quer mostrar ao cliente os 3 próximos.
- Filtrar:
statusigual aconfirmado - Ordenar: por
data_horacrescente - Limitar: máximo 3 itens
A lista resultante vai para um nó de Template que monta a mensagem com os 3 horários disponíveis.
CAPTURARCAPTURAR: painel do list_operator com filtro status=confirmado, ordenação por data_hora crescente e limite de 3 itens, com o resultado parcial visível
Dica
Você pode encadear múltiplas operações no mesmo nó — primeiro filtra, depois ordena, depois limita. A ordem de execução segue a sequência em que as operações aparecem no painel.
Atenção
Se a lista de entrada estiver vazia, o nó retorna uma lista vazia sem erro. Coloque um nó IF/ELSE depois para verificar se {{list_operator.result}} tem pelo menos um item antes de continuar o fluxo.