Apresentação do campo Lista
O campo Lista oferece ao usuário uma lista suspensa de itens para selecionar. Os itens podem ser inseridos diretamente no campo ou vir de uma lista externa ou de uma lista avançada. Ele faz parte da categoria Escolhas e listas, junto com Escolha única, Escolha múltipla, Escolha ordenada e Referência.
Adicionar o campo a um formulário
Na tela de criação de formulário, seja o formulário novo ou já existente, o catálogo de campos, à esquerda, os organiza em nove categorias. Apenas uma categoria fica aberta por vez: clique no nome dela para abri-la. O campo Lista fica na categoria Escolhas e listas, na primeira posição. Ao passar o mouse sobre o campo, aparece uma breve descrição.
Há três formas de adicionar o campo:
Um clique em Lista: o campo é inserido logo após o campo selecionado. Se nenhum campo estiver selecionado, ele é adicionado no final do formulário.
Arrastar e soltar a partir do catálogo até o local desejado. Durante o movimento, as zonas de inserção aparecem em linhas pontilhadas.
O botão + que aparece abaixo do campo sobrevoado ou selecionado: ele abre um menu com uma pesquisa para inserir um campo exatamente nesse local.
Assim que é adicionado, o título do campo entra no modo de edição: digite o nome dele e confirme com a tecla Enter. Para renomeá-lo depois, clique duas vezes no nome. A Pré-visualização móvel é atualizada a cada modificação.
Acessar as opções do campo
Na área de edição, clique duas vezes no campo ou clique no ícone de lápis (Modificar). As opções são exibidas em forma de cartões.
Eles aparecem nesta ordem: Essencial, Opções da lista, Condições de visibilidade, Exibição e disposição e Recursos Avançados, seguidos do Identificador técnico.
Não há botão de validação: cada configuração é aplicada imediatamente e a indicação ✓ Modificado aparece a cada alteração. Para navegar nas opções:
Desfazer (a seta no topo) ou Ctrl+Z: volta atrás.
↑ e ↓ no cabeçalho: passam para o campo anterior ou seguinte, sem voltar ao formulário.
Voltar (a seta no canto superior esquerdo): sai das opções e volta ao formulário.
ℹ️ Bom saber
Apenas o botão Salvar grava definitivamente o formulário. Enquanto você não salvar, nada é enviado para os celulares.
Enquanto as opções estiverem abertas, o catálogo fica acinzentado. Feche-as para adicionar um novo campo.
Essencial
Este cartão reúne as configurações básicas do campo.
Título do campo: por padrão, ele tem o nome do tipo de campo ("Lista"), mas você pode modificá-lo.
Escolher um ícone (o botão à esquerda do título): exibe um ícone antes do título do campo, tanto no aplicativo móvel quanto na Entrada Web. Os ícones são organizados por temas (Estados e alertas, Setas e navegação, Pessoas e gênero etc.) e há uma pesquisa em inglês disponível. Nenhum ícone remove o ícone.
Entrada obrigatória: ao ativar esta opção, o usuário precisa preencher o campo antes de enviar o formulário. O asterisco exibido ao lado do título do campo, na área de edição, também permite ativá-la ou desativá-la.
Seleção múltipla: permite ao usuário marcar vários valores da lista. O Valor padrão passa então a aceitar vários itens.
Texto de ajuda exibido no celular: insira uma instrução destinada aos seus usuários. Durante o preenchimento, ela pode ser consultada tocando no ponto de interrogação exibido à direita do título do campo.
Opções da lista
Este cartão define a origem dos itens oferecidos. Dois modos estão disponíveis:
Inserir os itens: define as escolhas manualmente. A lista só pode ser utilizada neste formulário.
Associar a uma lista: os itens vêm de uma lista externa ou de uma lista avançada, reutilizável em outros formulários.
Associar a uma lista
Em Associação a uma lista, selecione a lista externa ou avançada cujos itens alimentarão o campo. Uma pesquisa permite encontrá-la rapidamente, e o tipo de cada lista (Lista externa ou Lista avançada) é indicado abaixo do nome dela.
Valor padrão: pesquise na lista o item exibido quando o formulário é aberto. Se a Seleção múltipla estiver ativada, você pode adicionar vários.
Filtrar os itens: restringe os itens oferecidos de acordo com as respostas de outros campos. Depois de ativar a opção, monte a regra em três partes: em Na lista, escolha a coluna da lista a comparar; em seguida, escolha o operador (é igual a, é diferente de, é menor que, é menor ou igual a, é maior que, é maior ou igual a, Contém, Não contém, está entre, não está entre); por fim, em No formulário, indique o valor de comparação: o valor do campo, o valor fixo ou o campo de usuário personalizado.
Para saber mais sobre as listas, consulte os tutoriais Descobrir as listas externas e Descobrir as listas avançadas.
Inserir os itens
Clique em Adicionar um item para criar um item e, em seguida, digite o texto dele. O número de itens é indicado ao lado de Itens. Em cada linha:
#: define um código diferente do texto. O código é o valor gravado; ele pode ficar vazio. Um novo clique em # oculta o código: ele passa então a ser igual ao texto.
A alça, à esquerda da linha, permite reordenar os itens arrastando e soltando.
A lixeira, à direita, exclui o item.
Acima dos itens, três botões facilitam o gerenciamento deles:
Copiar: copia os itens com seus códigos.
Colar: substitui a lista pelos itens copiados.
Esvaziar: exclui todos os itens da lista.
Em Valor padrão, escolha o item exibido quando o formulário é aberto. Por padrão, nenhum item está selecionado ("Nenhum").
⚠️ Importante
O campo precisa estar associado a uma lista externa ou avançada, ou conter pelo menos um item inserido. Enquanto isso não acontecer, uma mensagem de alerta é exibida no topo das opções.
Recomendamos definir códigos curtos quando os textos são longos: eles são mais simples de usar nas etiquetas.
Condições de visibilidade
Três modos são propostos:
Sempre visível: o campo sempre aparece durante o preenchimento.
Visível se: o campo só é exibido quando as condições que você definiu são atendidas.
Sempre oculto: o campo nunca é exibido durante o preenchimento, mas continua utilizável nas exportações.
Para o detalhe da configuração das condições, consulte o tutorial As condições de visibilidade.
Exibição e disposição
Este cartão personaliza a exibição do campo.
Cor do título: escolha entre as cores propostas. A primeira opção, riscada, corresponde à ausência de cor. A cor se aplica tanto no aplicativo móvel quanto na Entrada Web.
Tamanho do título do campo: mova o cursor entre Aa (menor) e Aa (maior). A pré-visualização indica o tamanho obtido em pixels (11 px por padrão). Esse tamanho se aplica apenas no aplicativo móvel.
Na mesma linha que o campo anterior: esta opção coloca o campo ao lado do anterior, apenas no aplicativo móvel. Ela exige que a opção que permite exibir vários campos em uma linha esteja ativada nas configurações do aplicativo móvel.
Recursos Avançados
Manter o valor de uma linha para a outra: o valor inserido é retomado automaticamente na linha seguinte da tabela. Esta opção só aparece quando o campo está dentro de uma tabela.
Sem duplicados na tabela: o usuário não pode inserir o mesmo valor duas vezes em linhas diferentes. Esta opção só aparece quando o campo está dentro de uma tabela.
Apenas leitura durante uma modificação: o campo continua visível, mas não pode mais ser modificado quando o dado é reaberto para edição.
Dado pessoal (LGPD): esta opção marca o campo como dado pessoal. No histórico de dados, o conteúdo dele fica então parcialmente oculto: apenas os 3 últimos caracteres permanecem visíveis, e os demais são substituídos por asteriscos. Um clique no ícone de olho exibe o dado por completo. Esta opção não torna o dado invisível: qualquer pessoa com acesso ao dado pode consultar o conteúdo completo dele.
Word: excluir a linha se estiver vazia: em uma exportação Word, o parágrafo que contém a etiqueta do campo é removido se o campo estiver vazio.
Para saber mais, consulte o tutorial Marcações/etiquetas Block e exclusão de parágrafo.
Identificador técnico e etiqueta
Abaixo dos recursos avançados, o campo Identificador técnico exibe o identificador do campo. Ele é utilizado como está nos cálculos e nas automações.
A etiqueta a ser utilizada nas suas exportações personalizadas aparece logo abaixo: ##lista2##, por exemplo. Um clique na etiqueta a copia.
As etiquetas são sempre delimitadas por duas cerquilhas (##). Para personalizá-las de acordo com as suas necessidades, consulte o tutorial Utilizar as etiquetas para personalizar as exportações.
Para escolher o que é exibido nas suas exportações (texto, código…), consulte o tutorial As etiquetas Lista e Escolha. Para exibir ou ocultar um conteúdo de acordo com o item selecionado, consulte o tutorial Etiquetas Block e Lista/Escolha.
💡 Dica
O identificador técnico, e portanto a etiqueta, só pode ser modificado enquanto o formulário não tiver sido salvo. Recomendamos personalizá-lo antes de salvar pela primeira vez.




