> For the complete documentation index, see [llms.txt](https://kb.stoque.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.stoque.com.br/zeev/como-construir-processos/como-criar-formularios/fontes-de-dados-e-campos-multiplos.md).
# Campos com lista de opções
## Visão geral
É possível utilizar [integrações ](/zeev/integracoes/como-criar-integracoes.md#visao-geral)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.
Campo Lista de seleção com 3 opções
{% hint style="warning" %}
Importante: esse campo não pode ser usado em [tabelas multivaloradas](/zeev/como-construir-processos/como-criar-formularios/como-criar-tabelas-multivaloradas.md). Use um campo [caixa de seleção](#campo-caixa-de-selecao) em seu lugar.
{% endhint %}
### 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.
Campo Lista de seleção única com 2 opções
{% hint style="warning" %}
Importante: esse campo não pode ser usado em [tabelas multivaloradas](broken://pages/-MDtcMGBKBejKhMfb-Qz). Use um campo [caixa de seleção](#campo-caixa-de-selecao) em seu lugar.
{% endhint %}
### 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](#tamanho-da-lista-x-tipo-de-campo-adequado), pode ser extremamente lento e prejudicial para a experiência das pessoas.
Caixa de seleção com 4 opções
### 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 sugestão com diversas opções para busca
{% hint style="info" %}
As informações exibidas na caixa de dialogo do campo Sugestão, são as informações configuradas no nodo de texto da integração.
{% endhint %}
### 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:
1. CEP do endereço;
2. CPF da pessoa;
3. CNPJ da empresa;
4. 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:
Vejamos alguns exemplos reais abaixo, e, com base na expectativa média de itens retornados, qual o melhor tipo de campo a ser usado:
| Lista | Melhor tipo de campo |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sim ou não |
|
| UF | [Caixa de seleção](#campo-caixa-de-selecao) |
| Cidades | [Sugestão](#campo-sugestao) |
| CEP | [Pesquisar e preencher](#campo-pesquisar-e-preencher) |
### Demonstração prática
Veja no vídeo abaixo como criar campos com lista de opções:
{% embed url="" %}