A tela de Formulários permite criar estruturas reutilizáveis para coletar informações necessárias do cliente antes da confirmação do agendamento.
O formulário criado nesta tela é associado posteriormente a um item folha do Filtro de Agendamento . Quando o cliente navega no portal e seleciona essa opção, o sistema carrega a estrutura visual do formulário (construída via Form.io), coleta as respostas e gera o registro de dados associado ao agendamento.
.png)
A interface é dividida em três partes principais:
- Identificação: Dados administrativos do cadastro.
- Editor do Formulário: Construtor visual interativo
- Script de Validação: Editor de código para validações avançadas personalizadas.
Guia passo a passo
Identificação
Campos administrativos para nomear e catalogar o formulário no painel.
-
Nome
Obrigatório | Nome usado para localizar o formulário na listagem e vinculá-lo nos itens do Filtro.
Exemplo:Dados do cidadão — Atendimento Presencial -
Descrição
Opcional | Caixa de texto explicativa sobre a finalidade dos dados solicitados.
Exemplo:Formulário para coleta de dados do titular antes da emissão do documento.
.png)
Editor do Formulário
Interface gráfica que permite arrastar, soltar e organizar os componentes que serão apresentados ao cliente final.
- Construção Visual : O editor gera automaticamente o esquema estrutural em segundo plano (JSON) sem necessidade de edição manual de código.
- Componentes Customizados Disponíveis:
- Título Visual: Insere títulos e cabeçalhos formatados na tela do cliente.
- Imagem: Exibe imagens informativas ou ilustrativas.
- Arquivo : Permite o envio de documentos anexos pelo cliente.
- Botão de Envio (Submit): Se nenhum botão for inserido manualmente no desenho, o sistema adicionará automaticamente o botão de confirmação traduzido no idioma do sistema.
.png)
Para mais detalhes de como configurar um formulário clique aqui
Script de Validação Personalizada
Área para inserção de regras de código JavaScript em editor especializado (Ace Editor).
- Quando utilizar: Preencha apenas quando o formulário exigir cruzamento de dados complexos que a validação simples de cada campo não consiga resolver sozinha.
Exemplo de uso: Comparar se a data inserida em um campo de término é posterior à data de início, ou validar se dois campos numéricos somados atingem um determinado valor. - Formatação: Deve conter código JavaScript válido (
javascript). Caso não necessite de regras avançadas, mantenha o campo em branco.
.png)
Utilização do formulário de Agendamento
Entenda a sequência de integração do formulário dentro da estrutura do sistema:
- Criação: O formulário é configurado e salvo no menu de Formulários.
- Vínculo: No menu de Filtros de Agendamento, a opção final de escolha do cliente (folha) recebe o vínculo do formulário criado.
- Exibição: O cliente acessa o portal público, seleciona a opção desejada e o formulário é carregado na tela.
- Preenchimento e Envio: O cliente preenche as informações e confirma.
- Gravação: Os dados são registrados de forma temporária e promovem-se a definitivos assim que o agendamento é confirmado com sucesso.
- Disponibilidade: Todos os dados registrados são disponibilizados para o ambiente de atendimento tanto na "Agenda do dia" quanto durante o atendimento presencial.
- Atenção ao Digitar o Nome: O campo de nome não realiza a remoção automática de espaços em branco antes do envio. Evite deixar espaços desnecessários no início ou final do texto.
- Reutilização em Filtros: Um único formulário pode ser associado a múltiplos caminhos no filtro de agendamento. Lembre-se de que alterações na estrutura do formulário afetarão todas as opções de agendamento vinculadas a ele.
- Chave Técnica Estável: Mantenha as chaves técnicas dos campos do formulário consistentes, pois elas identificam as variáveis gravadas no banco de dados.
- Componentes Exclusivos: Utilize os componentes customizados disponibilizados para o OmniSIGA, como títulos personalizados, exibição de imagens e envio de arquivos.