Vista Formulário

Referência de configuração: Formulário

Visão geral

A vista Formulário apresenta um formulário dinâmico para criar e editar registos. Os campos estão organizados em separadores e secções, com suporte para visibilidade condicional, validação e disposições personalizadas.

Esta vista é a interface principal para introdução de dados detalhada e edição de registos.

Estrutura do formulário

Os formulários estão organizados hierarquicamente:

Separadores

O nível superior de organização. Cada separador aparece como um cabeçalho clicável. Use separadores para distinguir diferentes aspetos de um registo — por exemplo, "Geral", "Detalhes", "Anexos".

Secções

Dentro de cada separador, os campos estão agrupados em secções. Cada secção pode ter uma etiqueta e contém um ou mais campos.

Linhas

As secções podem organizar os campos em linhas de uma ou duas colunas:

• Uma coluna — Cada campo ocupa a largura total
• Duas colunas — Os campos ficam lado a lado

Secções especiais

• Secção de barra de ferramentas — Uma linha de ferramentas com botões de ação
• Secção especial — Áreas de disposição personalizadas para conteúdo incorporado

Exibição dos campos

Cada campo do formulário é apresentado de acordo com o seu tipo de componente:

• Os campos Text Field aparecem como campos de texto
• Os campos Select aparecem como listas pendentes
• Os campos Date aparecem como seletores de data
• Os campos File aparecem como botões de carregamento
• Os campos Ligação a tabela aparecem como listas pendentes pesquisáveis
• Os campos Vista ligada aparecem como sub-vistas incorporadas
• Os campos Lista de tarefas aparecem como listas de tarefas interativas
• E assim por diante, para todos os 19 tipos de componente

Os campos obrigatórios são assinalados com um indicador visual. Os campos só de leitura mostram o seu valor mas não podem ser editados. Os campos ocultos são excluídos do formulário por completo. Num layout avançado (construtor de formulários), colocar um campo no layout torna-o sempre visível - a colocação explícita prevalece sobre o estado oculto do campo. No construtor há também um botão "Repor layout default" que limpa a configuração toda (tabs, secções, campos ocultos, painéis e regras) e volta ao layout automático; a alteração só é aplicada ao guardar.

Visibilidade condicional

Os campos podem ser mostrados ou ocultados com base nos valores de outros campos. Por exemplo:

• Mostrar "Morada de Entrega" apenas quando "Requer Entrega" estiver assinalado
• Mostrar "Percentagem de Desconto" apenas quando "Tem Desconto" estiver selecionado
• Mostrar "Data Personalizada" apenas quando "Tipo de Data" estiver definido como "Personalizada"

As condições de visibilidade são configuradas por campo, nas definições da vista de formulário. Cada regra tem uma ação:

• Mostrar SE: o campo só aparece quando a condição se cumpre.
• Ocultar SE: o campo desaparece quando a condição se cumpre.
• Obrigatório SE: quando a condição se cumpre, o campo continua visível e passa a obrigatório neste formulário; quando não se cumpre, fica como está configurado.

Os operadores e o editor do valor seguem o tipo da coluna escolhida, como nos filtros das vistas: uma data abre um seletor de data (com «Entre», «Hoje», «Já passou»…), uma lista de opções mostra as suas opções, um número compara como número e uma caixa de verificação usa «É verdadeiro» ou «É falso», sem valor.

Um campo pode depender do seu próprio valor; na lista aparece marcado com «· este campo». Por exemplo, «Mostrar SE Pedido não está vazio» no campo «Pedido» mantém-no escondido até o botão «Criar pedido» o preencher. Um valor que o utilizador apague à mão não esconde o campo a meio da edição.

A lista Depende de começa com duas entradas de contexto, antes das colunas do formulário:

• Utilizador atual: compara com a pessoa que está a preencher. Os operadores são «é», «não é» e «está em»; com «está em» escolhem-se várias pessoas da organização.
• Perfil: compara com o papel efetivo dessa pessoa no workspace (Proprietário, Administrador, Editor, Utilizador, Visualizador ou Quiosque). Um terminal de quiosque conta sempre como Quiosque.

Estas condições combinam-se com as restantes por AND/OR, tal como as condições sobre colunas. Ocultar um campo no formulário não o esconde dos dados: a tabela, a API e as exportações continuam a mostrar a coluna.

Validação

• Os campos obrigatórios têm de ter um valor antes de o registo poder ser guardado.
• Os campos únicos (campos de texto configurados para unicidade) são validados face a todos os registos existentes, com comparação opcional sem distinção de maiúsculas/minúsculas e sem espaços.
• As restrições de data podem limitar a apenas datas futuras ou impor um intervalo mín./máx.
• As restrições numéricas podem impor valores mín./máx.

Ao abrir um registo

Cada vista escolhe qual dos formulários da tabela abre em Adicionar e Editar, e com que tamanho: S, M, L (o tamanho de sempre), XL ou Ecrã inteiro. Em Predefinido abre o formulário predefinido da tabela. Num telemóvel o diálogo abre sempre como folha, por isso o tamanho só conta no computador; com Ecrã inteiro, o botão de ecrã inteiro do cabeçalho do diálogo deixa de aparecer.

Define-se no configurador de cada vista, em Comportamento › Formulário, cartão «Ao abrir um registo». Se o formulário escolhido for apagado, a vista volta em silêncio ao predefinido. Abrir o mesmo registo a partir de outro sítio (um chip de ligação noutra tabela, as notificações ou os workflows) mantém o formulário e o tamanho predefinidos.

Ações do formulário

A barra de ferramentas do formulário pode incluir botões de ação personalizados ligados a execuções de workflow. Estes aparecem no topo do formulário e disparam as automações configuradas ao serem clicados.

A barra oculta-se pelo botão no seu rebordo de baixo e volta pela entrada Mostrar barra de ferramentas do menu ⋯ do registo; marcada como Colapsada por defeito, abre já oculta; a própria barra e cada um dos seus itens aceitam as mesmas regras de visibilidade dos campos (Mostrar SE / Ocultar SE), no painel de propriedades da barra.