Ir para o conteúdo principal

Tela de Formulário

Informações Gerais

**Descrição:** Essa tela tem como objetivo realizar o cadastro de Tutoriais, permitindo vincular documentos e vídeos explicativos a telas específicas do sistema para determinados municípios.

**URL:** Tela de Formulário - Tutoriais

**Caminho para a tela:** Configurações > Tutoriais

## Campos do Formulário

### Situação do Cadastro (apenas em edição)
- **Tipo:** Radio button
- **Validações:** Obrigatório
- **Opções:** Ativo (1) / Inativo (0)

### Título
- **Tipo:** Alfanumérico
- **Validações:** 
  - Obrigatório
  - Máximo 50 caracteres
  - Permite emojis
- **Tooltip:** "Este será o nome de exibição do arquivo para o usuário"

### Tela
- **Tipo:** Dropdown
- **Validações:** Obrigatório
- **Fonte de Dados:** API getTelas
- **Tooltip:** "Selecione aqui a tela a qual esse tutorial diz respeito"

### Municípios
- **Tipo:** Multi-select dropdown
- **Validações:** Obrigatório
- **Fonte de Dados:** API getTenants
- **Tooltip:** "Selecione aqui o(s) município(s) para os quais o tutorial será disponibilizado"
- **Observação:** Campo é desabilitado em modo de edição

### Anexos
- **Tipo:** Upload de arquivo
- **Validações:** 
  - Obrigatório
  - Máximo 1 arquivo
  - Tamanho máximo: 10 MB
- **Extensões permitidas:** 
  - Documentos: .doc, .docx, .pdf
  - Apresentações: .ppt, .pptx, .ppsx, .pot
  - Vídeos: .mp4, .avi, .mkv, .mov, .wmv, .webm, .flv, .mpeg, .3gp, .ogg
- **Texto descritivo:** "São permitidos arquivos com tamanho máximo de 10 MB nas seguintes extensões: doc, docx e pdf (documento de texto), ppt, pptx e ppsx (documento de slideshow), mp4, mov, avi, webm, entre outros (vídeo)."

## Funcionalidades

### Salvar
- Botão localizado no final do formulário
- Ao clicar:
  1. Realiza validação de todos os campos
  2. Se válido, envia dados para API saveTutorial
  3. Em caso de sucesso:
     - Exibe toast de sucesso "Tutorial salvo com sucesso!"
     - Redireciona para tela de pesquisa (/configuracoes/tutoriais/pesquisar)

### Upload de Anexo
- Ao fazer upload de um arquivo:
  1. Converte arquivo para base64
  2. Envia para API saveTutorialAnexo com dados do arquivo e lista de clientes selecionados
  3. Permite apenas um arquivo por tutorial
  4. Em caso de tentativa de upload de mais arquivos, exibe mensagem "O tutorial deve possuir somente um arquivo."