Itens do Formulário (Admin) do K|Painel
1. O que é
A tela Cadastro de Itens do Formulário lista e edita os campos de um formulário específico, aberta por Ações → Itens do formulário na listagem de Formulários.
Cada item tem texto, ordem, tipo, largura, opções (quando aplicável), obrigatoriedade e status.
2. Pré-requisitos
- Formulário pai já cadastrado.
- Acesso Admin a formulários.
- Licença válida.
3. Variantes / ações
| Ação | Efeito |
|---|---|
| Voltar | Listagem de formulários |
| Pesquisar… | Filtra itens |
| Novo Item | Modal de inclusão |
| Exibir Inativos / Ocultar Inativos | Filtro |
| Lápis | Edição |
| Lixeira | “Deseja realmente excluir este Item?” |
Campos do modal: Item, Ordem, Observação, Tipo, Largura do campo, Opções (condicional), Obrigatório, Ativo.
4. Onde configurar
Caminho: Admin → Formulários → Ações → Itens do formulário.
4.1 Grade
| Cabeçalho | Conteúdo |
|---|---|
| Item | Texto do campo |
| Obrigatório (S/N) | Sim/Não |
| Status | Ativo / Inativo |
4.2 Modal
| Campo | Uso |
|---|---|
| Item | Rótulo do campo |
| Ordem | Sequência de exibição |
| Observação | Ajuda/texto |
| Tipo | Tipo de entrada |
| Largura do campo | Layout |
| Opções | Lista quando o tipo exige |
| Obrigatório / Ativo | Flags |
5. Procedimentos relacionados
| Necessidade | Doc |
|---|---|
| Formulário pai | kpainel-admin-Formularios.md |
| Regra que exige o formulário | kpainel-admin-Regras.md |
6. Publicação / validação
- Incluir itens ativos na ordem correta.
- Marcar obrigatórios necessários.
- Testar preenchimento no fluxo operacional.
7. Checklist de sustentação
| Sintoma | Verificar |
|---|---|
| Campo não aparece | Ativo; ordem; formulário correto |
| Validação falha | Flag Obrigatório |
| Opções vazias | Campo Opções no tipo adequado |
8. Fluxo resumido
- Abrir itens do formulário.
- Novo Item → preencher → Salvar.
- Validar na operação.
9. Pontos de atenção
- Itens são por formulário (
ID_FORM); não misture formulários. - Ajuste de regra (Bloqueio) depende do preenchimento desses itens.
