Configuração de Formulários do K|Painel
Os Formulários são questionários configuráveis usados na operação (avisos e sala) e vinculados a regras do tipo Formulário. Cada formulário possui itens (campos) com tipo, ordem, largura e obrigatoriedade. Este artigo é destinado à equipe de TI responsável pela sustentação do K|Painel.
1. Antes de começar
- Acesso ao módulo Formulários.
- Licença do K|Painel válida.
- Ordem recomendada: criar o formulário → cadastrar os itens → vincular em Regras (quando necessário).
2. Como acessar
No menu do K|Painel, acesse Configurações → Personalização → Formulários. O título da tela é Cadastro de Formulários.
- Novo Formulário ou Ações → Editar: dados do formulário (nome, observação, ativo).
- Ações → Itens do formulário: campos do questionário.
3. Tipos de item
Ao cadastrar um item, o campo Tipo oferece estas opções (texto exibido na tela):
| Título | Seção ou cabeçalho no formulário operacional. |
| Check-Box | Caixa de seleção. |
| Texto | Campo de texto curto. |
| Campo de e-mail. | |
| Área de texto | Texto longo. |
| Lista de Valores | Lista suspensa; exige o preenchimento de Opções. |
| Botões de Opções (RadioButton) | Escolha única entre opções. |
4. Cadastro de formulários
Na listagem você pesquisa, cria novos formulários e alterna a exibição de inativos.
| Formulário | Nome do questionário. |
| Observações | Texto complementar (também entra na pesquisa). |
| Status | Ativo ou Inativo. |
| Ações → Itens do formulário | Abre o cadastro dos campos. |
| Exibir Inativos / Ocultar Inativos | Alterna a listagem padrão (somente ativos). |
A exclusão (ícone de lixeira) é uma inativação lógica — o registro não é apagado fisicamente.
Em Novo Formulário (ou edição), preencha o modal Cadastro de Formulário:
| Formulário | Obrigatório. Nome do formulário. |
| Observação | Texto informativo. |
| Ativo | Disponibilidade para uso e vínculo em regras. No cadastro novo, vem marcado. |
5. Cadastro de itens do formulário
Em Ações → Itens do formulário abre a tela Cadastro de Itens do Formulário. Use Novo Item para incluir campos.
| Item | Nome do campo no formulário operacional. |
| Obrigatório (S/N) | Sim ou Não. |
| Status | Ativo ou Inativo. |
No modal Cadastrar item de Formulário:
| Item | Obrigatório. Rótulo do campo na operação. |
| Ordem | Obrigatório. Posição de exibição. Deve ser no mínimo 1 (valor 0 ou negativo não é aceito). |
| Observação | Texto auxiliar (entra na pesquisa). |
| Tipo | Obrigatório. Tipo de controle (seção 3). |
| Largura do campo | Obrigatório. Escala de 1 a 12. |
| Opções | Aparece somente quando o tipo é Lista de Valores. Separe os valores por vírgula (ex.: Sim,Não,Talvez). |
| Obrigatório | Exige preenchimento na operação. |
| Ativo | Item em uso. No cadastro novo, vem marcado. |
6. Como publicar e validar
- Crie o formulário com Ativo marcado e salve.
- Cadastre todos os itens com Ordem ≥ 1 e Largura do campo definida.
- Se o tipo for Lista de Valores, preencha Opções.
- Se a checagem for necessária no fluxo da sala, vincule o formulário em Centro Cirúrgico → Regras (tipo Formulário). Veja Configurando Centros Cirúrgicos, Salas e Equipes.
- Valide o preenchimento no fluxo operacional do aviso (homologação).
7. Problemas comuns
| Formulário não aparece em Regras | Confirme se está Ativo. |
| Campo não aparece na operação | Item ativo? Ordem válida (≥ 1)? |
| Lista sem opções | Tipo = Lista de Valores e campo Opções preenchido? |
| Obrigatoriedade não exige | Checkbox Obrigatório marcado no item? |
| Formulário “sumiu” da listagem | Use Exibir Inativos; a exclusão é lógica. |
8. Pontos de atenção
- Ordem não aceita 0 ou negativo.
- Opções só aparece quando o tipo é Lista de Valores.
- Sem itens cadastrados, o formulário não tem utilidade operacional.
9. Configurações relacionadas
- Configurando Centros Cirúrgicos, Salas e Equipes — acesso a Regras por centro.
- Configuração de Regras do K|Painel — vínculo do formulário à checagem operacional.



