Entendendo as Regras de Filtro

Os filtros são o coração de uma visualização: eles definem quais tarefas aparecem. Cada regra de filtro compara um campo com um valor usando um operador — você pode combinar quantas regras quiser.

Como uma regra de filtro é montada

Campo           Operador    Valor
────────────    ────────    ────────────
Vence em        até         @today+3d
Status          é           Ativo
Atrasada        é           Sim

Leia cada linha como uma frase: “Vence até, no máximo, três dias a partir de hoje.” Você escolhe campo, operador e valor no editor de filtros (modo Avançado). No arquivo da visualização, as mesmas regras aparecem com nomes técnicos, como due_date · lte · @today+3d; as tabelas abaixo mostram os dois.

Referência de campos

O menu de campos tem três grupos: Campos, Campos Virtuais e — se você tiver criado algum — Atributos Personalizados.

Campos

Campos virtuais (calculados)

Esses campos não ficam no arquivo; são calculados a partir de outros campos. As chaves deles começam com @.

No arquivo da visualização, o mecanismo de visualizações também entende project, area, folder, defer_date (data de adiamento) e @effective_tags — útil quando um agente de IA escreve visualizações diretamente.

Atributos personalizados

Se você definiu atributos personalizados nos ajustes, eles aparecem no menu de campos em Atributos Personalizados. No YAML da visualização, eles se chamam attributes.chave — por exemplo, attributes.cliente (operador é, valor ACME) ou attributes.aceite com uma expressão de data como @today. A ordenação e o agrupamento também oferecem os atributos.

Operadores

Os operadores oferecidos dependem do campo. Todo campo conhece também está vazio e não está vazio (sem valor).

No arquivo da visualização, também está disponível starts_with (começa com, sem diferenciar maiúsculas e minúsculas).

Expressões de data

Como valor em filtros de data, você pode digitar uma expressão dinâmica em vez de uma data fixa (2026-03-01). A expressão é recalculada a cada execução da visualização.

Momentos individuais

Intervalos de datas

Os intervalos de datas são usados com o operador é — o app verifica, então, se a data está dentro do intervalo (incluindo o início e o fim). O dia em que a semana começa depende da região do seu dispositivo (no Brasil, domingo).

Combinar regras

Cada grupo de filtros começa com uma escolha de como as regras dele se combinam:

Com Regra, você adiciona uma condição; com Subgrupo, um grupo aninhado — por exemplo, um grupo OU dentro de um grupo E.

Modo simples e modo avançado

Simples — Em Configuração Rápida, os botões Hoje, Atrasada, Em Espera e Ativo definem filtro, agrupamento e ordenação de uma só vez. Logo abaixo, você escolhe individualmente:

• Tarefas: Todos, Ativo, Vence Hoje, Atrasada, Em Espera, Caixa de Entrada
• Agrupamento: Nenhum, Projeto, Área, Pasta, Status
• Ordenação: Vencimento, Fazer em (ambos com o mais próximo primeiro), Criação, Modificação (ambos com os mais recentes primeiro) ou Manual

Avançado — Você monta a árvore de filtros e divide a visualização em seções: partes com nome, cada uma com filtro, ordenação e agrupamento próprios. Com Adicionar Seção, você cria mais uma. Cada seção oferece ainda:

Se o filtro de uma seção verifica exatamente uma etiqueta, você pode arrastar tarefas entre essas seções e, com isso, trocar a etiqueta (veja Reorganizar Arrastando e Soltando).