Listas
Centralize e reutilize opções nos seus campos de seleção
As Listas permitem criar conjuntos reutilizáveis de opções para campos de seleção dentro das categorias do ENSPACE. Em vez de cadastrar as mesmas opções manualmente em cada campo, você cria uma lista centralizada e a vincula onde for necessário.
As listas existem no nível do workspace, acima das categorias — uma mesma lista pode ser usada por campos de seleção em várias categorias diferentes.
Tipos de lista
O ENSPACE oferece três tipos de lista, cada um para um cenário diferente:
| Tipo | Melhor cenário | Exemplo |
|---|---|---|
| Lista Padrão | Opções simples sem relação hierárquica. | Status, prioridade, tipo de documento, departamentos. |
| Lista Aninhada | Estruturas organizadas em níveis hierárquicos. | Códigos CNAE, categorias de produto, regiões geográficas. |
| Lista Dependente | Campos relacionados onde um controla as opções do outro. | Estado → Cidade, Categoria → Produto, Departamento → Cargo. |
Use Lista Padrão quando precisar apenas de um conjunto direto de opções. Use Lista Aninhada quando existir relação hierárquica entre os dados. Use Listas Dependentes quando um campo precisar filtrar dinamicamente as opções de outro com base na seleção anterior.
Rótulo e valor
Cada opção de uma lista possui dois elementos:
- Rótulo — o texto exibido para o usuário no formulário (ex: "Administração").
- Valor — o identificador técnico utilizado pelo sistema internamente (ex:
administracao).
O usuário visualiza o rótulo, mas o ENSPACE utiliza o valor em filtros, condicionais, eventos de campo, automações, relatórios e exportações de dados.
Como vincular uma lista a um campo
Após criar uma lista (de qualquer tipo), você precisa vinculá-la a um campo de seleção em uma categoria para que as opções apareçam no formulário.
Crie um campo de seleção na categoria
Navegue até Configurações > Estrutura > Categorias, selecione a categoria desejada, acesse a aba Campos e clique em Criar. Selecione um dos tipos de campo compatíveis com listas:
| Tipo de seleção | Campo | Descrição |
|---|---|---|
| Única | Lista de Seleção Única | O usuário escolhe uma opção em um menu suspenso. |
| Única | Botões de Seleção Única | O usuário clica em um botão para escolher uma opção. |
| Múltipla | Caixas de Seleção | O usuário marca umas opções desejadas com checkboxes. |
| Múltipla | Lista de Seleção Múltipla | O usuário escolhe várias opções em um menu suspenso. |
Selecione a origem "Listas"
No campo Origem da Lista, selecione a opção Listas. Outras origens disponíveis (como Lista Personalizada, Integração, Membros do Workspace, Grupos de Membros e Índices de Correção Monetária) têm finalidades diferentes — para reutilizar uma lista centralizada, escolha sempre Listas.
Escolha a lista desejada
No campo Lista, selecione a lista pré-criada que deseja vincular (ex: "Áreas da empresa"). Todas as opções cadastradas na lista serão exibidas automaticamente no formulário quando o usuário for preencher o campo.
Configure opções adicionais do campo (se necessário)
Dependendo do tipo de campo, configurações adicionais ficam disponíveis:
- Caixa de Busca — habilita uma barra de busca dentro do dropdown, permitindo que o usuário filtre as opções digitando. Disponível para Lista de Seleção Única e Lista de Seleção Múltipla.
- Editável — permite que o usuário digite um valor que não está na lista. Disponível para Lista de Seleção Única.
- Múltiplas listas — permite vincular mais de uma lista ao mesmo campo. Disponível quando a origem é Listas.
Salve o campo
Clique em Salvar. O campo estará pronto para ser adicionado a um formulário da categoria.
Importação e exportação
Todas as listas permitem importação e exportação de opções em formato XLSX. Esse recurso é útil para listas grandes, migração entre ambientes ou manutenção em lote.
Na Lista Padrão, a importação substitui todas as opções existentes. Na Lista Aninhada, a importação segue uma estrutura de chaves hierárquicas que define a relação entre níveis. Consulte a documentação de cada tipo para detalhes sobre o formato do arquivo.
Boas práticas
- Reutilize listas sempre que as mesmas opções aparecerem em mais de um campo ou categoria.
- Mantenha valores técnicos padronizados em
snake_casepara facilitar o uso em automações e eventos. - Evite criar listas duplicadas — centralize as opções em uma única lista e vincule a vários campos.
- Não remova ou altere o valor técnico de opções já utilizadas em dados históricos, pois os itens existentes perderão a referência.
- Use Listas Dependentes para reduzir erros de preenchimento em campos relacionados (ex: Estado → Cidade).