Pular para o conteúdo principal

Listas de exibição (EntityGrid)

Todas as telas de lista do agents2.me — contatos, contas, oportunidades, conversas, usuários e canais — usam o mesmo motor de grade, o EntityGrid. Você configura a tela uma vez, dá um nome à combinação e reutiliza.

O que uma lista de exibição guarda​

ItemDescrição
NomeIdentifica a lista no seletor da tela
Colunas visíveisQuais campos aparecem, inclusive campos personalizados
Ordem das colunasA ordem em que elas aparecem, no modo tabela e no modo Kanban
FiltrosCampo, operador, valor e a lógica entre eles
ModoTabela ou Kanban
Configuração do KanbanAgrupar por, ordenar por e totalização

Toda tela nasce com uma lista Todos, imutável: é o ponto de partida e o caminho de volta se você se perder numa configuração.

Operadores de filtro​

Os operadores disponíveis dependem do tipo do campo — e só os que fazem sentido aparecem:

  • Texto — igual a, diferente de, contém, começa com, termina com, está vazio
  • Número e data — igual a, diferente de, maior que, menor que, maior ou igual, menor ou igual
  • Booleano — verdadeiro/falso (sem "maior que")
  • Seleção — os valores da lista de opções

Com mais de um filtro, a lógica é E (AND), OU (OR) ou Personalizada — nesse caso você escreve a expressão, por exemplo (1 AND 2) OR 3. Antes de salvar, o sistema valida a expressão e exige que todos os filtros sejam usados.

Modo Kanban​

Ao trocar para Kanban pela primeira vez, abre-se a configuração:

  1. Agrupar por — qualquer coluna do tipo seleção ou lista suspensa. É isso que cria as colunas do quadro.
  2. Ordenar por e direção — a ordem dos cartões dentro de cada coluna.
  3. Totalizar por e tipo de totalização — média, mínimo, máximo ou soma de campos numéricos, exibidos no cabeçalho de cada coluna.

Depois de configurado, o quadro abre direto. O menu de edição passa a mostrar os campos extras do Kanban.

Ações da lista​

AçãoO que faz
NovoCria uma lista escolhendo nome e campos, com ordem de exibição
ClonarCopia a lista atual como ponto de partida
EditarAltera nome, colunas e ordem
CompartilhamentoSomente para mim, para todos ou para quem tem o meu perfil
ExcluirRemove a lista (respeitando a permissão)
Resetar ordenaçãoVolta à ordenação padrão da tela
Resetar larguraReajusta as larguras das colunas automaticamente
AtualizarRecarrega os dados com os filtros atuais
BaixarExporta em CSV o que está sendo exibido — exige permissão de extração

Boas práticas​

  1. Uma lista por uso, não por pessoa: "Meus contatos sem dono", "Oportunidades em negociação deste trimestre".
  2. Compartilhe por perfil quando o critério for a função, não a pessoa.
  3. Evite listas com dezenas de colunas — o modo Kanban e o export ficam pesados.
  4. Filtros salvos também valem para os assistentes: as mesmas listas podem ser executadas por MCP (veja).