Campos com lista de opções

É possível utilizar integrações para criar listas fixas ou dinâmicas de opções em campos de formulários.

Visão geral

É possível utilizar integrações para criar listas fixas ou dinâmicas de opções em campos de formulários. Por exemplo:

Uma lista das cidades de uma UF;
Uma lista das pessoas ativas do Zeev;
Uma lista com as opções "Sim" e "Não";
Uma lista de prioridades: Alta, média, baixa;
Uma lista com os centros de custo da organização;
Uma lista com os CEPs do Brasil;
Etc.

Tipos de campos que suportam listas

Campo Lista de seleção (Múltipla escolha)

O campo "Lista de seleção" é um campo simples, utilizado principalmente para mostrar poucos registros, rapidamente visíveis às pessoas. Seu diferencial é que mais de uma opção pode ser escolhida ao mesmo tempo.

Importante: esse campo não pode ser usado em tabelas multivaloradas. Use um campo caixa de seleção em seu lugar.

Campo Lista de seleção única (Múltipla seleção)

O campo "Lista de seleção única" é um campo simples, utilizado principalmente para mostrar poucos registros, rapidamente visíveis às pessoas, permitindo a seleção de um único valor.

Importante: esse campo não pode ser usado em tabelas multivaloradas. Use um campo caixa de seleção em seu lugar.

Campo caixa de seleção

O campo caixa de seleção é bastante comum, simples de usar e indicado para uma quantidade intermediária de registros. Porém, se utilizado com uma fonte de dados com muitos registros, pode ser extremamente lento e prejudicial para a experiência das pessoas.

Campo sugestão

O campo sugestão é indicado quando a lista pesquisada possui um volume intermediário ou grande de registros. Nesse campo, a pessoa começa a digitar parte do nome a ser pesquisado e o sistema traz resultados intermediários e indicados para escolha.

Campo pesquisar e preencher

O campo "pesquisar e preencher" é indicado quando a lista pesquisada possui um volume intermediário ou grande de registros, e os itens possuem um identificador ou código único conhecido e fundamental. Exemplo:

CEP do endereço;
CPF da pessoa;
CNPJ da empresa;
Código único de identificação interno;

Nesse cenário, a pessoa deve preencher o valor total e completo da informação que quer pesquisar.

Tamanho da lista X Tipo de campo adequado

Ao criar e utilizar uma lista em um campo de formulário, você deve ter especial cuidado com o volume potencial de itens dessa lista.

De modo geral, a quantidade de itens retornados pela lista impactará na sua decisão de qual tipo de campo usar.

Utilizar um tipo de campo errado pode trazer sérios problemas para seu aplicativo:

Problemas de usabilidade: muitos itens em um tipo de campo inadequado poderão tornar quase impossível as pessoas encontrarem o item correto;
Problemas de performance: muitos itens em um tipo de campo inadequado poderão tornar o carregamento da página extremamente lento, prejudicando a experiência de uso do sistema;
Erros 429: se a sua lista vem de uma integração com outro sistema ou com o próprio Zeev, o uso do tipo de campo incorreto poderá ensejar o chamado erro 429: “too many requests” ou “muitas solicitações”, indica que você ultrapassou limites pré-contratados de solicitações por segundo, por minuto, por hora, por dia ou mesmo por mês de consulta a API.

A tabela abaixo traz a recomendação de qual campo utilizar baseado na quantidade de itens retornados pela fonte de dados:

Quantidade de itens da lista

Tipo de campo utilizar

Até 10 itens

Múltipla escolha (checkbox)

Múltipla seleção (radio)

De 10 a 50 itens

De 50 a 100 itens