Visão geral
A tela Personalizar Layout do Formulário (dentro do card) serve para duas coisas no mesmo lugar:
- Criar e configurar colunas do formulário do kanban
- Definir o layout: quais campos aparecem, em qual aba e em qual ordem
Essa configuração vale para todos os cards daquele flow, não só para o card que você abriu.
Se o layout já foi configurado por essa tela, ela prevalece sobre o dicionário. Criar o campo só no dicionário não basta: o campo entra como oculto e não aparece no card até você torná-lo visível aqui.
Quem pode fazer e como abrir a tela
É preciso ser administrador do flow. No card, o botão Modo Edição só aparece para quem tem essa permissão.
- Abra um card do kanban.
- Clique em Modo Edição.
- No formulário do card, clique no ícone de lista (Configurar layout do formulário).
- Se houver alterações não salvas no formulário, salve antes de continuar.
Se o kanban tiver tabela secundária, o mesmo ícone aparece no Modo Admin.
Você chega na tela com as abas do formulário em cima, Campos ocultos à esquerda e Campos visíveis à direita.
1. Criar e configurar colunas
Nova coluna
- No canto das abas, clique na engrenagem e depois em Nova Coluna.
- Escolha o tipo:
- Coluna Padrão — texto, número, data, enumerador, etc.
- Conexão com outra entidade — vínculo com outra tabela.
- Preencha os dados e clique em Confirmar.
A coluna nova entra visível na aba que estiver selecionada.
Coluna padrão
- Nome do Campo: identificador técnico. Comece com
user_(ex.:user_motivo_sintetico). - Novo Label: nome exibido no formulário.
- Tipo do Campo: Texto (varchar), Número, Data, Hora, Data e Hora, Booleano, Enumerador ou Referência.
- Em texto (varchar): Tamanho, Especialização (Simples, Markdown ou Upload/Download) e Valor Padrão.
- Em enumerador: informe Nome (valor no banco) e Label (exibição) para cada opção.
- Em referência: escolha a tabela e, se precisar, os argumentos JSON.
Conexão com outra entidade
- Selecione a entidade de destino.
- Use uma coluna de referência já existente ou crie uma nova (nome técnico começando com
user_). - Defina o label da conexão (o que aparece no formulário).
Editar ou excluir uma coluna já criada
Na lista de campos (ocultos ou visíveis), clique no lápis.
Na tela de edição você altera o label, valor padrão, especialização e se a coluna está inativa. Nome e tipo não mudam depois de criada.
Excluir Campo remove a coluna (há confirmação). Só use se tiver certeza.
2. Configurar o layout das colunas no formulário
As duas listas
- Campos ocultos (esquerda): existem na tabela, mas não aparecem no formulário.
- Campos visíveis - [nome da aba] (direita): o que o usuário vê naquela aba.
Exemplo: se Motivo Sintético, Motivo Analítico e Detalhes estão à esquerda, e à direita só aparece CSM, o card mostra só o CSM — mesmo com os outros campos já criados no dicionário.
Mostrar, ocultar e ordenar
- Mostrar: no campo oculto, clique no + (ele vai para a aba selecionada) ou arraste da esquerda para a direita.
- Ocultar: no campo visível, clique no − ou arraste de volta para a esquerda.
- Ordem: setas para cima/baixo ou arraste na lista da direita.
- Outra aba: ícone de troca no campo visível e escolha a aba de destino.
Clique em Confirmar para gravar. Sem isso, a mudança não vale.
Voltar ao padrão descarta o layout customizado deste kanban e volta ao layout original do formulário.
Abas do formulário
Na faixa de abas (engrenagem e ícones em cada aba):
- Nova Aba: cria uma aba.
- Lápis na aba: renomeia (a aba Geral não se edita assim).
- Lixeira: exclui a aba. Os campos visíveis nela podem ir para Geral ou ficar ocultos.
- Reordenar Abas: define a ordem das abas no card.
Selecione a aba antes de mostrar um campo, para ele cair no lugar certo.
O campo não aparece no card?
- O layout deste kanban já foi salvo nesta tela?
- O campo está em Campos ocultos?
- Ele está visível, mas em outra aba?
- Você clicou em Confirmar depois de mostrar o campo?
Na dúvida, não recrie o campo no dicionário: abra o layout, mova o campo para visível na aba certa e confirme.