---
title: "Formulário de Agendamento"
slug: "formulário-de-agendamento"
updated: 2026-09-09T19:18:37Z
published: 2026-09-09T19:18:37Z
canonical: "docs.omnisiga.ai/formulário-de-agendamento"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omnisiga.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Formulário de Agendamento

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.

![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(816).png)

A interface é dividida em três partes principais:

1. **Identificação:** Dados administrativos do cadastro.
2. **Editor do Formulário:** Construtor visual interativo
3. **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.`

![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(817).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.

![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(818).png)

Para mais detalhes de como configurar um formulário [clique aqui](/v1/docs/vis%C3%A3o-geral-3)

---

## 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.

![Image](https://cdn.document360.io/d1786d22-23e4-4145-98ac-accd680324d8/Images/Documentation/image(819).png)

---

## Utilização do formulário de Agendamento

Entenda a sequência de integração do formulário dentro da estrutura do sistema:

1. **Criação:** O formulário é configurado e salvo no menu de Formulários.
2. **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.
3. **Exibição:** O cliente acessa o portal público, seleciona a opção desejada e o formulário é carregado na tela.
4. **Preenchimento e Envio:** O cliente preenche as informações e confirma.
5. **Gravação:** Os dados são registrados de forma temporária e promovem-se a definitivos assim que o agendamento é confirmado com sucesso.
6. **Disponibilidade:** Todos os dados registrados são disponibilizados para o ambiente de atendimento tanto na "Agenda do dia" quanto durante o atendimento presencial.

---

Dicas e Regras para a configuração

- **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.

---