📑 Catálogo de Formulários

📅Disponibilizado: 20/11/2024    Versão 1.0

🔄 Atualizado: 29/01/2025   Versão 1.1

📄CATÁLOGO DE FORMULÁRIOS

Na aba de catálogo de formulários, será possível visualizar uma visão geral de todos os formulários, com informações sobre suas versões, histórico de edições, status e auditoria. Para acessar essa tela, basta navegar até o MENU LATERAL -> CADASTRO-> FORMULÁRIOS.

🔷MENU DE AÇÕES DOS FORMULÁRIOS

Localizada na parte direita do catálogo, essa seção oferece algumas funcionalidades.

✏️Descrição:

1. Visualizar: Mostra os campos do formulário da forma que irá aparecer para o agente no mobile, não mostra o ID nem opções de formatação; 
2. Campos: Mostra os campos do formulário possibilitando acessar as regras dos campos, ID, e opções de formatação, porém não possibilita edição de nenhum elemento;
3. Perfis: Possibilita a indexação de um perfil a um tipo de formulário, é importante assegurar que cada formulário seja associado ao perfil correto, pois é assim que o usuário mobile terá acesso á este formulário;
4. Nova versão: Gera uma nova versão do formulário, altera o estado dele para e disponibiliza a opção “Editar”;
5. Clone: Gera um clone do formulário idêntico ao original;
6. Atualizar relacionamentos: Atualiza a versão dos formulários contidos nos tipos de demanda para a versão mais recente;
7. Salvar: inicia um download da versão atual em formato json;
8. Restaurar: importar localmente um formulário em formato json;
9. Layouts Relatórios: permite associar layouts de impressão/geração de PDF aos formulários desenhado, por exemplo E-toi;
10. Excluir: Remove a última versão do formulário, e todas as anteriores;
11. Editar: Possibilita editar o formulário, essa opção é disponível somente após criar nova versão ou primeira versão (item IV);
12. Publicar: Disponibiliza o formulário para uso nos aparelhos móveis, essa opção é disponível somente após criar nova versão ou primeira versão (item IV);

🟡CONDIÇÕES DE LISTA

As condições de uma 'Lista' geralmente seguem o padrão abaixo:

1️⃣O campo é exibido se o valor “1” do item “LISTA _01” for selecionado.

2️⃣O campo também é exibido quando o valor “1” do item “LISTA_01”, for selecionado, porém nesse formato é possível acrescentar outras condições como AND e OR, veja um exemplo:

3️⃣O campo é exibido quando o valor 1 ou o valor 2 forem selecionados.

4️⃣O campo é exibido APENAS se ambos os valores “1” e “2” forem selecionados.

❌RESTRIÇÕES

As restrições presentes no módulo de formulário são as seguintes:

• Evite utilizar espaços ou caracteres especiais no nome do formulário, bem como palavras reservadas, como 'name', 'title' e 'size'.

❇️PRINCIPAIS CAMPOS DO FORMULÁRIO

1. Booleano: Pode assumir os seguintes renderizadores: Interruptor, Radiogroup, Caixa de Seleção e uma lista comum com valor de “sim, não e sem valor”, respectivamente:

   

2. Texto: O campo de texto pode ser configurado como 'longo' ou 'comum'. O tipo 'longo' exibe uma caixa de texto, enquanto o tipo 'comum' apresenta uma linha para entrada de texto. Essa configuração não está relacionada ao limite de caracteres.

   A validação do texto pode ser definida para diversos formatos, como CPF, Telefone, Alfanumérico, E-mail, entre outros.

   O tamanho do texto pode ser ajustado no campo 'Tamanho', com um valor mínimo de 1 e sem limite máximo. Embora não haja um valor máximo de caracteres, é importante observar que, ao exportar o documento para PDF, o texto pode ser cortado. Por isso, deve-se considerar que o modelo do documento pode precisar ser ajustado.

3. Lista: As listas podem ser apresentadas nos formatos de radiogroup, lista de seleção ou árvore, e podem ser ordenadas por ID ou por valor. Além disso, as listas podem ser do tipo 'Domínio', onde os valores são extraídos de uma planilha de dados de terceiros, ou do tipo 'Lista', onde os valores são inseridos manualmente
4. Inteiro: O campo de números inteiros possui um valor mínimo de 0 e não possui valor máximo.
5. Arquivo: 
   

   O campo de arquivo possui a possibilidade de anexar:

   • Foto: é possível anexar fotos da câmera ou da galeria, com a opção de escolher a qualidade da imagem e definir a quantidade de fotos a serem enviadas.
   • Vídeo: anexar vídeo da câmera ou da galeria, podendo escolher qualidade da imagem e definir a quantidade das mesmas;
   • Arquivo: anexar arquivo de texto;
     
     

     É possível definir a qualidade do arquivo de vídeo e foto, além de especificar o formato do áudio a ser anexado.

6. Código de Barras: Leitor de código de barras que converte a leitura em texto.
7. Data e Hora: Seletor de data e/ou hora, podendo permitir adição manual.
8. Formulário: Cria um sub formulário, útil para regras específicas de visibilidade e maior organização, possui regras de obrigatoriedade e validação.
9. Localização: Registra localização do usuário.
10. Seção: Cria uma seção semelhante ao formulário (item 1.8) porém possui apenas regras de visibilidade.
11. Slide: Valores disponíveis em formato de barra deslizante, pode ser vertical ou horizontal.
12. Página: Cria outra página ao formulário, páginas possuem regras de visibilidade e funcionam da mesma forma da página padrão.
13. Avaliação: Possui renderização de estrelas e carinhas, utilizado para classificar satisfação.
14. Medidor OCR: Leitura de imagem com extração de texto/número.

🔀ASSOCIANDO FORMULÁRIOS AO CONTRATO

Local: CONTRATOS -> TIPOS DE CONTRATOS

• Selecione o tipo de contrato desejado e clique no símbolo '+' no menu de ações ou em 'Editar'.
  
• Na criação do tipo de contrato, é possível selecionar o formulário desejado, em seguida clique em salvar.

▶️ PUBLICAR FORMULÁRIO

A publicação do formulário deve ser feita após a conclusão do desenho do formulário. E deve seguir o seguinte fluxo:

🟢BOAS PRÁTICAS NA CRIAÇÃO DE FORMULÁRIOS

• Cadastrar o nome dos formulários com abreviações da etiqueta, para fácil localização, simplificando as integrações e outros processos. 

          Exemplo: “NOME DO CLIENTE” vira NOME_CLIENTE, “NÚMERO DE TELEFONE” vira NUM_TEL;

• Manter um controle dos campos e alterações;

⚠️POSSÍVEIS ERROS AO CRIAR/PUBLICAR FORMULÁRIOS
Caso o usuário não atualize o formulário por meio do ícone atualizar relacionamentos. O usuário permanecerá visualizando o formulário antigo caso não seja atualizado o relacionamento.