Criar Formulário

Aprenda mais sobre o construtor de formulários e suas funcionalidades.

ATENÇÃO!

1. Esta funcionalidade não está disponível para todos os usuários. Verifique a disponibilidade para a sua unidade com o nosso time de Sucesso do Cliente.

2. Na integração com a API, para que os novos campos do construtor de formulários que não são exibidos na integração sejam incluídos, é necessário entrar em contato com o time de suporte e solicitar a integração dos campos.

Com o ‘Construtor de Formulários’, agora é possível que os próprios usuários criem formulários para suas unidades. Foram implementadas funcionalidades como:

• Configuração de campos;

• Edição de campos durante a criação do formulário;

• Reordenação de campos dentro das seções.

Nessa nova versão, disponibilizamos a funcionalidade de ‘Edição dos formulários’. Para mais detalhes sobre como editar um formulário, consulte o artigo Editar Formulários. Estamos trabalhando continuamente para trazer novas melhorias em breve!

Neste artigo, aprenda detalhadamente como criar formulários utilizando o ‘Construtor de formulários’.

DICA.: No final do artigo, assista aos vídeos sobre o Construtor de Formulários.

Criando o formulário

ATENÇÃO! Antes de criar um formulário, lembre-se de que algumas opções de edição não poderão ser alteradas após a finalização, como:

• Alterar a natureza;

• O nome da classe e das seções;

• Campos com condicionais.

Certifique-se de realizar todas as alterações necessárias antes de salvar o formulário. Para saber mais detalhes sobre a edição dos formulários, consulte o artigo Editar Formulários.

1. Acesse o painel de Configuração, clique na opção ‘Formulários’.

Captura de tela: Acessando o menu 'Formulários'.

1. Na lista de formulários, clique no botão +NOVO localizado no canto superior direito.

Captura de tela: Criando um formulário.

1. Na tela de criação do formulário, selecione a ‘Natureza’ e insira o nome da ‘Classe’. Também é possível adicionar um prazo para a execução do apontamento em ‘Dias’.

OBS.: Caso o formulário seja destinado a OAE, ative a opção ‘É OAE?’.

Captura de tela: Opção 'É OAE?'

• Natureza: Selecione a natureza desejada no formulário.

• Classe: Insira o nome da classe.

• Prazo: Insira o número de dias e horas para definir a duração da execução do apontamento. Este campo é opcional.

OBS.: Ao definir o prazo, os apontamentos dessa classe terão o campo prazo preenchido automaticamente. O cálculo é realizado somando o dia e a hora da criação do apontamento ao valor especificado no campo ‘Prazo (dias)’.

Captura de tela: Informações do formulário.

1. Para criar as seções e campos do formulário, clique na opção ’Seções e Campos’.

IMPORTANTE!

1. Para garantir a performance do sistema cada formulário pode ter no máximo 80 campos. O contador exibe o total e a quantidade utilizada.

2. Por padrão, ao criar um formulário, o sistema já disponibiliza as seções ‘Dimensões’ e ‘Observações’, com seus respectivos campos configurados para uso. Na seções, é possível alterar o título, reordenar os campos e apagar a seção, se necessário.

Captura de tela: Tela de configuração das seções e campos do formulário.

1. Neste passo, vamos demonstrar como adicionar e editar uma ‘Seção’.

• Adicionar Seção

• Editar Seção

Adicionar Seção

Para adicionar uma seção, clique no botão +ADICIONAR SEÇÃO.

Captura de tela: Adicionado seção.

No campo ‘Nome da Seção’, insira um nome para a seção. Para confirmar, clique no botão +ADICIONAR. Repita o processo para adicionar mais seções.

Captura de tela: Adicionado seção.

Para ordenar a seção, pressione e mantenha o botão esquerdo do mouse sobre o ícone localizado à esquerda do título da seção.

Captura de tela: Ordenar seção.

Arraste a seção para o local desejado e solte o botão esquerdo.

Captura de tela: Ordenar seção.

Editar Seção

Para editar uma seção, clique no ícone do lápis, localizado à direita do título da seção. É possível editar tanto as seções padrão do sistema quanto as novas seções.

Captura de tela: Editar seção.

Na tela de edição, é possível alterar o nome da seção e ordenar os campos. Para confirmar os ajustes, clique no botão CONCLUIR.

Captura de tela: Editando a seção.

Se deseja apagar uma seção, na tela de edição, clique no botão APAGAR. Ao apagar a seção, os campos existentes são apagados. Esta ação não pode ser desfeita.

Captura de tela: Apagar seção.

Leia o alerta com atenção, pois esta ação não pode ser desfeita. Clique no botão APAGAR para confirmar.

Captura de tela: Confirmação de exclusão da seção.

1. Neste passo, vamos demonstrar como adicionar e editar os ‘Campos’.

• Adicionar Campo

• Editar Campo

Adicionar Campo

Para adicionar um campo, escolha a seção e clique no botão +ADICIONAR CAMPO.

Captura de tela: Adicionado campo.

Em seguida seleciona uma opção de campo. Os tipos de campos que podem ser adicionados são:

• Chave de Seleção: Esse tipo de campo é uma variável que pode ter apenas dois valores: verdadeiro ou falso.

• Hora e Data: Esse tipo de campo aceita o formato de data e hora.

• Número com vírgula: Esse tipo de campo aceita números com vírgulas. Exemplo: 1,1.

• Número inteiro: Esse tipo de campo aceita números inteiros, sem casas decimais. Exemplo: 12.

• Campos de texto: Esse tipo de campo aceita letras, números e caracteres, sem restrições quanto ao conteúdo.

• Campo de seleção múltipla: Esse tipo de campo aceita selecionar mais de uma opção.

• Campo de seleção única: Esse tipo de campo aceita selecionar apenas uma opção.

Clique no tipo de campo que deseja adicionar.

Captura de tela: Selecionar tipo de campo.

Em seguida, será exibida a tela de configurações do campo. As opções disponíveis variam de acordo com o tipo de campo selecionado.

ATENÇÃO! Certifique-se de configurar os campos corretamente, pois algumas opções ficarão indisponíveis para edição após a criação do formulário. Para saber mais detalhes sobre a edição dos formulários, consulte o artigo Editar Formulários.

Captura de tela: Configurações do campo.

No campo ‘Nome do Campo’, insira um nome para identificá-lo. É importante que cada campo no formulário tenha um nome único. O campo ‘apiName’ é preenchido automaticamente e não pode ser alterado.

IMPORTANTE! Recomendamos não incluir números nos nomes dos campos.

Captura de tela: Inserindo o nome do campo.

Clique na opção que deseja configurar para expandir o conteúdo. Leia as instruções de uso e habilite ou preencha os campos conforme indicado. OBS.: Algumas opções estão disponíveis em tipos de campos específicos. Por exemplo:

• A opção ‘Texto com quebra de linha’, só está disponível para o tipo de campo ‘Texto’.

Captura de tela: Dica de configuração de campo.

• Já a opção ‘Separador de milhar’ é aplicada somente a campos do tipo ‘Numérico’.

Captura de tela: Configurar campo numérico com separador de milhar.

Algumas opções têm suas particularidades, como por exemplo as opções ‘Obrigatório’ e ‘Desabilitado’. Quando ‘Obrigatório’ está habilitado, a opção ‘Desabilitado’ não pode ser habilitada, e vice-versa.

Captura de tela: Dica de configuração de campo.

Configurar campos de seleção Única e Múltipla

Os campos de seleção única e múltipla, permite criar opções para exibir na lista seleção. Para criar um campo de seleção única ou múltipla, selecione um dos tipos na tela de adicionar campo.

Captura de tela: Seleção de tipo de campo 'Campo de Seleção Única' e 'Campo de Seleção Múltipla'.

Defina o nome do campo e realize as demais configurações, em seguida, navegue até ‘Opções do campo de seleção’.

Captura de tela: Configuração do campo 'Campo de Seleção Única' e 'Campo de Seleção Múltipla'.

Para adicionar as opções, insira o dado no campo e clique no botão ‘+’.

OBS.: O campo ‘Valor’ não pode ser editado, esse campo é de uso exclusivo do sistema.

Captura de tela: Configurando as opções de seleção.

Caso insira o nome de uma opção existente na lista, o sistema retorna o alerta "Já existe um campo com esse nome".

Captura de tela: Alerta de opção com nome igual.

Para apagar uma opção, clique no botão ‘Lixeira’.

Captura de tela: Apagar opção.

Repita o processo para incluir mais opções, após concluir revise as informações e clique no botão +ADICIONAR.

Captura de tela: Concluir configuração do campo.

Após criar os campos de seleção única e múltipla, teste os campos antes de finalizar a criação do formulário.

Captura de tela: Tela de configuração, com destaque nos campos 'Campo de Seleção Única' e 'Campo de Seleção Múltipla'.

Campo de Seleção Única

Captura de tela: Testando o campo 'Campo de Seleção Única'

Campo de Seleção Múltipla

Captura de tela: Testando o campo 'Campo de Seleção Múltipla'.

Configurar Fórmula ou Valor Padrão

O construtor de formulários permite criar campos de Fórmula ou Valor Padrão.

Fórmula

As fórmulas são baseadas na lógica JSON Logic. Para saber mais sobre o uso de fórmulas, acesse: jsonlogic.com/

Exemplo prático: Neste exemplo vamos mostrar em detalhes como realizar a soma de 2 campos do tipo inteiro:

1. Adicione os campos do tipo ‘Número inteiro’ com os nomes ‘Valor Inicial’ e ‘Valor Final’.

Captura de tela: Selecionando o tipo de campo ‘Número inteiro’.

Captura de tela: Inserindo o nome do campo.

1. Reserve o ‘apiName’ para ser usado na construção da fórmula: valorInicial e valorFinal.

Captura de tela: Campo 'apiName'.

1. Após concluir a configuração, clique no botão +ADICIONAR para adicionar o campo.

Captura de tela: Concluindo a criação do campo.

1. Para que seja possível realizar a soma dos dois campos, adicione um campo para receber a fórmula. Adicione um campo do tipo ‘Número inteiro’ de nome ‘Total’.

Captura de tela: Inserindo o nome do campo.

Clique na opção ‘Fórmula ou Valor Padrão’. Cole ou digite a fórmula com indentação e quebra de linhas. Após concluir a configuração, clique no botão +ADICIONAR para criar o campo.

ATENÇÃO! Certifique-se que a fórmula esteja correta, pois, após a criação do formulário, não será possível editar.

Captura de tela: Inserindo a fórmula no campo.

Fórmula usada no exemplo:

Em destaque o ‘apiName’ dos campos que realizamos a soma.

{
    "if": [
        {
            "missing": [
                "formData.valorInicial",
                "formData.valorFinal"
            ]
        },
        0,
        {
            "+": [
                {
                    "var": "formData.valorInicial"
                },
                {
                    "var": "formData.valorFinal"
                }
            ]
        }
    ]
 }

Valor Padrão

A configuração do valor padrão, define um valor fixo para o campo que é preenchido automaticamente durante o uso do formulário. Clique na opção ‘Fórmula ou Valor Padrão’, insira o valor desejado. Após concluir a configuração, clique no botão +ADICIONAR para criar o campo.

Captura de tela: Inserindo a valor padrão no campo.

Editar Campo

Após adicionar os campos, conforme explicado anteriormente, é possível editá-los antes de salvar o formulário. Para editar um campo, clique no ícone do lápis, localizado à direita do campo.

Captura de tela: Editar campo.

Clique na opção desejada para realizar as alterações. Para finalizar a edição, clique no botão CONCLUIR.

Captura de tela: Editar campo.

Se deseja apagar um campo, na tela de edição, clique no botão APAGAR. Esta ação não pode ser desfeita.

Captura de tela: Apagar campo.

1. Antes de prosseguir, teste os campos.

Captura de tela: Testando os campos adicionados.

1. Para finalizar, faça uma última revisão das seções e campos adicionados, pois após salvar o formulário, não será possível editá-los. Para concluir, clique no botão CRIAR FORMULÁRIO.

Captura de tela: Concluindo a criação do formulário.

Pronto! O formulário foi criado com sucesso.

Captura de tela: Lista de formulários.

Para usar o formulário, crie um apontamento e selecione a natureza e classe correspondentes ao formulário. Para mais detalhes sobre como preencher o formulário de apontamento, consulte os artigos Criar Apontamentos e Editar Apontamentos.

ATENÇÃO! Caso o formulário não mostre o valor padrão corretamente ou não execute a fórmula, limpe o cache do navegador. Caso o problema persista, entre em contato com o nosso time de suporte.

Captura de tela: Campos 'Natureza' e 'Classe' no formulários de apontamento.

Vídeos construtor de formulários

Para compreender melhor o uso dos formulários, assista aos vídeos a seguir, que contêm detalhes sobre:

• Acessando os formulários

• Criando o formulário

• Inativando o formulário

• Utilizando os formulários

Acessando os formulários

Veja como acessar os formulários no painel de configurações.

Não está vendo o vídeo? Clique no botão para acessá-lo. Assistir Vídeo

Criando o formulário

Veja como usar o construtor de formulários.

Não está vendo o vídeo? Clique no botão para acessá-lo. Assistir Vídeo

Inativando o formulário

Veja como inativar um formulário.

Não está vendo o vídeo? Clique no botão para acessá-lo. Assistir Vídeo

Utilizando os formulários

Veja como utilizar um formulário dentro do apontamento.

Não está vendo o vídeo? Clique no botão para acessá-lo. Assistir Vídeo

---

Artigos Relacionados

Criar ApontamentoEditar ApontamentoO que são os formulários?Copiar Formulário e EditarApagar Formulário