Filtragem de registros

Limite quais registros aparecem em uma tabela do portal usando condições de campo. Combina com a propriedade dos registros e com o controle de acesso baseado em funções.

Visão geral

Um filtro de registros decide quais registros de uma tabela uma função pode ver. Você define uma ou mais condições, como “Status igual a Ativo”, e os usuários do portal só veem os registros que as atendem.

Use-o quando uma função deve ver parte de uma tabela, e não a tabela inteira: só os projetos ativos, nenhum rascunho, ou só os registros da região do próprio usuário. Ele roda no servidor, então um registro que o filtro deixa de fora nunca é enviado ao navegador.

É uma configuração diferente da propriedade dos registros, que mostra a cada usuário só os registros que pertencem a ele. As duas funcionam juntas.

Quando usar

CenárioFiltro de registrosPropriedade dos registros
Mostrar só os projetos com status “Ativo” no portalSimNão
Mostrar a cada usuário só os próprios registrosNãoSim
Ocultar registros em rascunho de usuários externosSimNão
Restringir o acesso de leitura a um único valor de statusSimNão

Uma tabela pode ter os dois. O usuário então vê os registros que atendem às suas condições e que pertencem a ele.

A filtragem de registros é essencial em configurações com várias unidades. Veja os portais de gestão de estoque e os portais de operações de varejo para exemplos completos.

Configurar um filtro de registros

  1. 1

    Abra a aba Acesso da tabela

    No painel de administração do portal, escolha na barra de funções a função que você quer configurar, abra a página da tabela e fique na aba Acesso. A seção Filtro de registros é a última, abaixo de Acesso à tabela, Visibilidade dos registros e Campo de proprietário.

    Um filtro pertence à tabela, então vale para todas as páginas criadas a partir dessa tabela. Se a tabela tem mais de uma página, defina-o na principal: a aba Acesso de qualquer outra página leva você à página principal.

    A seção Filtro de registros na aba Acesso com uma condição: Status Igual a Open
    A seção Filtro de registros fica no fim da aba Acesso. Cada condição é um campo, um operador e um valor.
  2. 2

    Adicione uma condição

    Clique em Adicionar condição. Cada condição é um campo, um operador e, na maioria dos operadores, um valor. Adicione quantas precisar.

  3. 3

    Escolha um campo e um operador

    Escolha o campo a verificar. Todos os campos da tabela são oferecidos, sejam quais forem as permissões, exceto os campos de botão. Filtrar por um campo que os seus usuários não veem não tem problema: a verificação roda no servidor e o campo continua oculto.

    Os operadores dependem do tipo de campo (veja a tabela abaixo). Uma condição nova começa no primeiro operador dessa lista, que é Igual a quando o campo o tem.

  4. 4

    Informe um valor

    A forma de informar o valor depende do campo:

    • Seleção única (Single select): escolha uma das opções dele.
    • Caixa de seleção (Checkbox): escolha Marcado ou Desmarcado.
    • Texto, número e os demais: digite o valor.
    • Está vazio e Não está vazio não recebem valor.

    Você também pode comparar com a pessoa que está conectada. Ao lado do valor, mude Valor fixo para:

    • Usuário atual, para comparar com o próprio usuário conectado.
    • Campo do usuário atual e escolha um campo do registro de usuário dele. “Region igual à Region do próprio usuário” passa a ser uma condição só, que funciona para todos, em vez de um filtro por pessoa.

    Essas duas opções aparecem quando o portal tem uma tabela de usuários, e não para campos de caixa de seleção.

    Uma condição de filtro de registros com o menu de origem do valor aberto, oferecendo Valor fixo, Usuário atual e Campo do usuário atual
    Aponte uma condição para o próprio registro do usuário conectado, para que um só filtro funcione para todos.
  5. 5

    Escolha como as condições se combinam

    Quando há duas ou mais condições, um menu Atender a aparece acima delas. Escolha cada uma (AND) para mostrar os registros que atendem a todas as condições, ou qualquer uma (OR) para mostrar os registros que atendem a pelo menos uma. Uma única escolha vale para a lista inteira.

    Um filtro de registros com duas condições, Status Igual a Open e Priority Igual a High, e o menu Atender a definido como cada uma (AND)
    Com duas ou mais condições, escolha se um registro precisa atender a todas ou a qualquer uma.

Salve o portal. O filtro passa a valer na próxima vez que um usuário do portal carregar a tabela.

O que os seus usuários veem

Os usuários do portal veem uma lista mais curta, e nada mais muda. Não há mensagem dizendo que há um filtro ativo, e os controles para filtrar, buscar e ordenar só buscam dentro do que o filtro permite. Um registro que não passa pelo filtro também não pode ser aberto por essa função.

Uma tabela do portal mostrando só os relatórios cujo Status é Approved
Os usuários do portal só veem os registros que atendem ao filtro.

Operadores por tipo de campo

Os operadores oferecidos dependem do tipo de campo:

Tipo de campoOperadores
Texto de uma linha (Single line text), texto longo (Long text), e-mail (Email), URL, telefone (Phone)Igual a, Diferente de, Está vazio, Não está vazio, Contém
Número (Number), porcentagem (Percent), moeda (Currency), nota (Rating)Igual a, Diferente de, Está vazio, Não está vazio
Seleção única (Single select)Igual a, Diferente de, Está vazio, Não está vazio
Seleção múltipla (Multiple select), registros vinculados, campos de consulta (Lookup)Está vazio, Não está vazio, Contém
Caixa de seleção (Checkbox)Igual a (Marcado ou Desmarcado)
Data, data e horaEstá vazio, Não está vazio
Fórmula (Formula), campo de agregação (Rollup)Igual a, Diferente de, Está vazio, Não está vazio, Contém

O filtro de registros não aceita igualdade de datas nem filtragem por intervalo. Se os usuários do portal precisarem restringir por data por conta própria, os controles de filtro podem filtrar um campo de data por mês. Para uma condição fixa, filtre um campo auxiliar (como um “Status” de seleção única) ou sugira isso no roadmap público.

Se você não configurou funções, há um único conjunto de configurações para todos, então o filtro vale para todos os usuários do portal. Adicione funções depois para dar a cada função o próprio filtro.

Remover um filtro

Clique no x no fim da linha de uma condição para removê-la. Remova todas as condições e o filtro fica desligado: a tabela volta a mostrar todos os registros que a função pode ver de outra forma. Não há uma chave separada para ligar e desligar.

Interação com outros recursos

  • Controle de acesso baseado em funções. Cada função tem o próprio filtro de registros. Uma função “Administrador” pode ver todos os registros, enquanto uma função “Leitor” pode ficar presa a uma parte da mesma tabela.
  • Propriedade dos registros. Aplicada na mesma busca de dados que o filtro. Em uma tabela definida como Somente os próprios registros, os usuários do portal veem os registros que atendem às suas condições E que pertencem a eles. Em uma tabela definida como Todos (todos os registros), o filtro é a única coisa que reduz a lista.
  • Permissões de tabela. Se a tabela não está Ativada, o filtro não faz diferença. Os filtros só reduzem o que já está visível.
  • Filtros de página. Uma página pode reduzir ainda mais o que lista com o próprio filtro de página. Ele funciona por cima deste filtro e nunca consegue mostrar mais do que ele permite.
  • Campos excluídos. Se você excluir no Airtable um campo que uma condição usa, essa condição não corresponde a nada até você mudá-la. Com cada uma (AND), os usuários do portal com essa função não veem nenhum registro da tabela e não conseguem abrir nenhum; com qualquer uma (OR), as outras condições continuam valendo. Um filtro nunca mostra mais registros porque um campo sumiu.

Próximos passos