Histórico da Página
| Informações | ||
|---|---|---|
| ||
Esta documentação refere-se ao novo editor de formulários da plataforma. Caso esteja utilizando o editor atual, acesse a documentação disponível em Plataforma | Configurar formulário. |
| Índice | ||||
|---|---|---|---|---|
|
Falando de editor de formulário...
...
O editor de formulários conta com diversos recursos, campos e propriedades para os formulários que são criados especificamente para um processo. A seguir, são detalhados todos os campos e procedimentos necessários para a construção de um formulário seguindo as boas práticas de desenvolvimento. O editor de formulários é dividido em quatro partes distintas que serão detalhadas nesta documentação.
Configurações iniciais
...
Algumas configurações iniciais como título, versão, configuração e visualização estão localizados no topo do editor de formulários. Abaixo detalharemos cada um destes itens.
Título do formulário: insira um título para o formulário que está sendo criado.
Versão: rascunho ou o número da versão liberada. Exemplo V. 01.
Regras do formulário: clique no ícone para visualizar ou incluir novas regras para o formulário.
Histórico de versões: utilizado para acessar o histórico de versões e modificações do formulário. Saiba mais aqui.
Visualizar formulário: clique no ícone de pré-visualização 
Configurações do formulário: define se a descrição dos campos será padrão ou campo de formulário.- Salvar
Criar com IA: utilizado para solicitar a criação de formulários de forma facilitada. 
Salvar salvar o formulário pertencente ao processo.Publicar: utilizado para publicar salvar o formulário pertencente ao processo.
Adicionar campos ao formulário
| Informações | ||
|---|---|---|
| ||
Nos formulários criados a partir dos novos editores,não existe a opção ou botão de publicação individual. Isso porque a publicação do formulário ocorre automaticamente quando o diagrama de processo ao qual ele está vinculado é publicado. Assim, não é possível publicar um formulário de forma isolada — ele só se torna disponível após a publicação do processo relacionado. |
Adicionar campos ao formulário
...
Os campos do formulário estão à esquerda do editor e podem ser adicionados em qualquer ordem e Os campos do formulário estão à esquerda do editor e podem ser adicionados em qualquer ordem e quantidade. Para reorganizar a posição de um campo, basta clicar sobre ele e arrastá-lo para o local desejado. Os campos disponíveis são:
- Campo simples: validar propósito de uso
- Área de texto: permite a inclusão de texto no formulário que está sendo criado.
- Texto: permite a inclusão de texto.
- Combo: permite a inclusão de um campo do tipo combobox com opções pré-definidas no formulário ou com opções carregadas dinamicamente de um dataset.
- Lista: permite a inclusão de campos do tipo list com opções pré-definidas no formulário ou com opções carregadas dinamicamente de um dataset.
- Seleção única: permite a inclusão de campos do tipo radiobutton, permitindo a seleção de apenas uma opção das cadastradas pelo usuário.
- Múltipla escolha: permite a inclusão de campos do tipo checkbox, permitindo a seleção de múltiplas opções pelo usuário.
- Pesquisa: permite a inclusão de um campo do tipo pesquisa com informações carregadas a partir do dataset selecionado.
- Avaliação: permite a inclusão de um campo do tipo rating star, onde o usuário pode selecionar uma escala de 0 a 5 estrelas.
- Tabela: permite a inclusão dos outros campos disponíveis para a construção do formulário.
- Painel: validar propósito de usopermite agrupar diferentes campos dentro de uma mesma área, facilitando a organização e a leitura das informações. Este recurso é utilizado para criar seções ou delimitar conjuntos de campos por contexto.
- Abas: Abas: permite a inclusão de abas dentro do formulário que está sendo criado, é possível incluir os outros campos disponíveis para a construção do formulário.
- Imagem: permite a inclusão de uma imagem diretamente do desktop do usuário. O tamanho máximo suportado para upload é de 10MB.
- Divisor: adiciona uma linha horizontal para separar visualmente os campos do formulário.
...
| Informações | ||
|---|---|---|
| ||
Todos os campos |
...
possuem a propriedade Código, preenchida automaticamente para facilitar sua identificação. Essa propriedade é editável e pode ser alterada conforme a necessidade. No entanto, não é permitido atribuir o mesmo código a dois campos diferentes. Caso isso ocorra, o campo duplicado será destacado em vermelho para sinalizar o ajuste necessário. Além disso, não é possível salvar o formulário enquanto houver campos com códigos repetidos. |
Duplicar campos
...
Todos os campos possuem a ação de duplicação, acessível por meio do ícone 
. Para campos que têm regras configuradas, uma mensagem é exibida perguntando se deseja copiar as regras do campo original para o campo duplicado. Caso desejado, clique em Sim.
Propriedade dos campos
...
Todos os campos disponíveis para a construção do formulário possuem propriedades que podem ser configuradas no momento da inclusão do campo ao formulário. A seguir, detalharemos todas as propriedades disponíveis para cada tipo de campo.
| Campo | Propriedades | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| Campo simples |
|
...
| Campo | Propriedades | ||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Campo simples |
| Informações |
|---|
Este campo pode ser usado para coletar dados sensíveis. Saiba mais aqui. |
Código
código único de identificação do campo
Texto de ajuda
instruções para o usuário preencher o
Dica de preenchimento
O limite de caracteres do campo pode ser ajustado usando os ícones de seta ou inserindo o valor diretamente na propriedade. Se nenhum valor for definido
Usar
código único de identificação do campo
. Este código pode ser editado para o valor desejado, sendo apenas necessário ser um código único, ou seja, que não se repita. Pode ser usado em personalizações via código. Tipo Título |
instruções para o usuário preencher o
Tamanho do campo |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda Dica de preenchimento |
Tamanho do campo
usado para definir o tamanho do campo no formulário.
Altura
usado para definir a altura do campo no formulário. O tamanho inicial padrão é 6.
Valor inicial
valor pré-definido para o campo. Esse valor oculta a dica de preenchimento.
O limite de caracteres do campo pode ser ajustado usando os ícones de seta ou inserindo o valor diretamente na propriedade. Se nenhum valor for definido
Limite de caracteres |
Máscara
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar Analytics?
|
| Painel | ||||||
|---|---|---|---|---|---|---|
|
Código Título |
possível incluir parágrafos utilizando a tecla Enter.
Altura Tamanho do campo |
Personalizar
possível realizar alinhamento do texto à direita, à esquerda e ao centro. Possível também utilizar negrito, itálico e sublinhado.
Tamanho do texto
define o tamanho da fonte utilizada no campo. Sendo possível definir entre o tamanho do parágrafo 7 ao 1.
Cor do texto
define a cor do texto incluído no campo.
Cor de fundo primário
define a cor primária utilizada de fundo para o campo.
Cor de fundo secundário
define a cor secundária utilizada de fundo para o campo. Quando utilizado, faz um gradiente entre as cores primárias e secundárias.
Altura do espaço interno
define a altura do espaço interno do campo. Quanto maior o valor, maior será o espaço interno do campo. O valor máximo suportado é 100.
Arredondar bordas
usado para arredondar as bordas do campo.| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda Dica de preenchimento Limite de caracteres |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar Analytics?
|
| Painel | ||||||
|---|---|---|---|---|---|---|
|
Código |
título que será atribuído ao campo do formulário
. Texto |
|
. Tamanho do campo |
Valor do campo
determina se as opções para seleção do campo serão definidas a partir de um dataset ou pré-definidas diretamente na construção do formulário.
Para usar informações pré-definidas no formulário, selecione a opção Valores manuais.
Para usar informações pré-definidas no formulário, selecione a opção Valores dinâmicos.
| Painel | ||||
|---|---|---|---|---|
| ||||
Ao escolher obter os valores manuais, será necessário incluir os valores nos campos Título da opção e Valor. Ao escolher obter os valores dinâmicos a partir de um dataset, é necessário acionar o botão Configurar dataset e preencher os campos abaixo: Dataset Ordenação Opções Valor
|
Usar Analytics?
Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
| Informações |
|---|
Este campo pode ser usado para coletar dados sensíveis. Saiba mais aqui |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Alinhamento e estilo define os alinhamentos que o campo vai receber, assim como os estilos aplicáveis negrito, itálico e sublinhado. Tamanho do texto define o tamanho da fonte utilizada no campo. Sendo possível definir entre o tamanho do parágrafo 7 ao 1. Cor do texto Cor do lado esquerdo do fundo cor que define o lado esquerdo do campo. Cor do lado direito do fundo cor que define o lado direito do campo. Altura do espaço interno Arredondar bordas usado para arredondar as bordas do campo. |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título Tamanho do campo |
Código
código único de identificação do campo. Este código pode ser editado para o valor desejado, sendo apenas necessário ser um código único, ou seja, que não se repita. Pode ser usado em personalizações via código.
Título
título que será atribuído ao campo do formulário.
Texto de ajuda
instruções para o usuário preencher o formulário.
Tamanho do campo
usado para definir o tamanho do campo no formulário.
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda |
Valor do campo
|
|
|
| #000000
Define uma coluna para ordenar as opções disponíveis
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar Analytics?
|
| Painel | ||||||
|---|---|---|---|---|---|---|
|
Código Título |
instruções para o usuário preencher o
formulário. |
Número de colunas
define o número de colunas que o campo terá.
Tamanho do campo |
insira as opções que irão compor o campo. É possível alternar a posição das opções e excluí-las.
Valor
propriedade que poderá ser utilizada para integrações ou tratativas no código. Não será exibido para o usuário final.
Usar analytics?
Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
| Informações |
|---|
Este campo pode ser usado para coletar dados sensíveis. Saiba mais aqui |
| Painel | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
Texto de ajuda Valor do campo
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar Analytics |
Código
código único de identificação do campo. Este código pode ser editado para o valor desejado, sendo apenas necessário ser um código único, ou seja, que não se repita. Pode ser usado em personalizações via código.
Título
título que será atribuído ao campo do formulário.
Texto de ajuda
instruções para o usuário preencher o formulário.
Número de colunas
define o número de colunas que o campo terá
Tamanho do campo
usado para definir o tamanho do campo no formulário.
Título das opções
insira as opções que irão compor o campo. É possível alternar a posição das opções e excluí-las.
Valor
propriedade que poderá ser utilizada para integrações ou tratativas no código. Não será exibido para o usuário final.
Usar analytics?
Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
|
| Painel | ||||||
|---|---|---|---|---|---|---|
|
Código Título |
usado
Número de colunas Tamanho do campo usado para definir o tamanho do campo no formulário. |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda |
| Painel | |||||||
|---|---|---|---|---|---|---|---|
|
| ||||||
Título da opção Valor
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar analytics?
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código |
código único de identificação do campo. Este código pode ser editado para o valor desejado, sendo apenas necessário ser um código único, ou seja, que não se repita. Pode ser usado em personalizações via código. Título |
Número de |
colunas |
define o número de colunas que o campo terá. Tamanho do campo |
Ícone
escolha entre os ícones disponíveis, que são:
- Estrela
- Seleção
- Feliz
- Triste
- Coração
Escala inicio
defina entre zero (0) ou um (1)
Escala fim
defina entre dois (2) à dez (10)
Marcador início
defina o marcador de início. Por exemplo: Ruim
Marcador fim
defina o marcador de fim. Por exemplo: Bom
Exibir numeração
exibe a numeração conforme a escala de 1 à 10
Usar analytics?
Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda |
| Painel | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
Título da opção Valor
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar analytics? Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título Tamanho do campo |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Abaixo do campo Texto de ajuda é exibido o botão Configurar dataset para realizar a configuração da pesquisa. Para isso, é necessário preencher os campos abaixo: Dataset Opções Valor Ordenação Limite de resultados Limite de seleção de registros
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar analytics? Quando assinalado, os dados recebidos por este campo serão enviados ao Analytics.
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título Tamanho do campo |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda Ícone
Escala Exibir numeração Marcadores Marcador inicial Marcador final |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Usar analytics?
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título Nome do botão de inclusão Ocultar título? quando habilitado o título da tabela ficará oculto. |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Tabela principal Titulo do campo será atribuído ao campo do formulário. |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
O botão Enviar ao Analytics não é exibido neste campo, pois o campo em si não é enviado ao Analytics. Somente os campos adicionados dentro do campo Tabela podem ter essa configuração. Já o botão Adicionar dado sensível define apenas como as informações serão armazenadas na tabela.
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título |
Nome do botão de inclusão
botão utilizado para adicionar novos registros na tabela, ou seja, uma nova linha.
Tabela principal
Titulo do campo será atribuído ao campo do formulário.
| Informações |
|---|
Este campo pode ser usado para coletar dados sensíveis. Saiba mais aqui |
Código
código único de identificação do campo. Este código pode ser editado para o valor desejado, sendo apenas necessário ser um código único, ou seja, que não se repita. Pode ser usado em personalizações via código.
Título
título que será atribuído ao campo do formulário.
Cor do título
define a cor que será utilizada no título
Cor de fundo do título
define a cor de fundo que será utilizada no painel
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Cor do título Cor do lado esquerdo do fundo Cor do lado direito do fundo Ícone Permite abrir e fechar? Ícones para abrir e fechar |
| Painel | ||||||
|---|---|---|---|---|---|---|
|
Código Título |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Título da aba defina o título que será atribuído a aba. Código propriedade que poderá ser utilizada para integrações ou tratativas no código. Não será exibido para o usuário final.
|
|
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código Título Tamanho do campo |
aqui é possível incluir a imagem
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Selecione o arquivo através do botão Selecionar arquivo, ou |
arraste e solte o |
arquivo |
na área indicada |
. Altura define a altura da imagem adicionada ao campo. |
Largura |
a largura da imagem adicionada ao campo. Manter proporção Alinhamento define o alinhamento a imagem adicionada ao campo, sendo alinhamento à direita, central e à esquerda. Comportamento
|
|
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Código |
Título |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Texto de ajuda |
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Espessura Cor do divisor Ícone |
Regras do formulário
...
Ao criar ou editar um formulário de processo, é possível adicionar regras para serem validadas no momento de preenchimento. Abaixo vamos detalhar o conceito e como utilizar esse recurso:
...
| Painel | |||||||
|---|---|---|---|---|---|---|---|
| |||||||
Campo Campo para o Quando a solicitação chegar na atividade Atividade Atividade na qual a regra definida para o campo deve ser executada. Ação Ação que será executada para o campo na atividade definida. As ações disponíveis são: o campo do formulário será ExibirExibido: quando selecionada, determina que o campo será exibido somente quando a solicitação estiver na atividade selecionada na regra. DesabilitarDesabilitado: quando selecionada, determina que o campo será exibido desabilitado quando a solicitação estiver na atividade selecionada na regra. HabilitarHabilitado: quando selecionada, determina que o campo será exibido habilitado quando a solicitação estiver na atividade selecionada na regra. Obrigatório: quando selecionada, determina que o campo será de preenchimento obrigatório quando a solicitação estiver na atividade selecionada na regra. ValidarOpcional: quando selecionada, determinada determina que será executada uma validação no campo o campo será de preenchimento opcional quando a solicitação estiver na atividade selecionada na regra. Ao selecionar essa opção, é necessário definir os critérios que serão considerados na validação do campo. Definir Definido valor: quando selecionada, determina que será atribuído um valor específico para o campo quando a solicitação estiver na atividade selecionada na regra. Nesse caso, é necessário definir o valor que será atribuído. Os valores são divididos em três categorias distintas, Usuário atual, Solicitação e Outros.
Validado valor: quando selecionada, determina que será executada uma validação no valor do campo quando a solicitação estiver na atividade selecionada na regra. Ao selecionar essa opção, é necessário definir os critérios que serão considerados na validação do campo. Validado formato: quando selecionada, determina que será validado o formato satisfazendo as condições definidas. Executado eventosEvento: quando selecionada, determinada que um evento ocorrerá no campo quando a solicitação estiver na atividade selecionada na regra. Saiba mais sobre Eventos de formulário.
|
...
|
Usar Analytics? 
...
Ao habilitar esta opção, os dados recebidos por este campo serão enviados ao Analytics, permitindo a realização das análises necessárias.
Adicionar dado pessoal / sensível
...
Em alguns campos é possível marcar como dado sensível nos casos onde é necessário. Os seguintes campos apresentam essa característica. Abaixo, vamos detalhar como utilizar esta opção.
- Campo simples;
- Área de texto;
- Combo;
- Listas;
- Seleção única;
- Múltipla escolha;
- Tabela.
| Informações | ||||||
|---|---|---|---|---|---|---|
| ||||||
Os dados sensíveis são um tipo específico de dado pessoal que, por sua natureza, exigem maior proteção. Eles revelam informações sobre a pessoa e, se forem expostos ou mal utilizados, podem causar discriminação, constrangimento, ou danos à liberdade e à privacidade do indivíduo.
|
01. Adicionar Adicione o campo desejado no editor de formulários;
02. Nas propriedades do campo, localizar e clicar localize o agrupador Privacidade e dados e clique em Adicionar dado sensívelpessoal;
03. Em Tipo do dado, selecionar selecione o tipo do dado que será coletado entre as opções abaixo:
...
- Execução de contrato;
- Obrigação legal;
- Consentimento;
- Execução de políticas públicas;
- Estudo por órgão de pesquisa;
- Exercício regular de direito;
- Para a proteção da vida;
- Para tutela de saúde;
- Interesse legítimo;
- Proteção de credito.
06. Em Justificativa, informe uma justificativa para o dado ter sido considerado sensível. , informe uma justificativa para o dado ter sido considerado sensível.
07. No ícone 
é possível adicionar mais de uma classificação e justificativa para o campo. Também é possível Remover o conjunto de classificação e justificativa através do botão Remover
.
0807. Após todas as configurações realizadas, clique em Salvar.
Publicar o formulário
Para publicar o formulário siga os passos abaixo.
01. Clique no botão Publicar, localizado no lado superior direito do editor.
02. Uma mensagem confirmando a ação será apresentada.
...
| borderColor | #f2f2f2 |
|---|---|
| bgColor | #f2f2f2 |
Ao publicar o formulário, as alterações feitas no formulário já serão válidas para novas solicitações do processo, caso o formulário foi editado.
...
.
Publicar o formulário
...
Para publicar um formulário criado no novo editor, é preciso primeiro publicar o processo ao qual ele está vinculado. Somente então a versão salva do formulário será efetivamente publicada
...
.
| Informações | ||
|---|---|---|
| ||
Esta documentação é válida a partir da atualização Voyager (2.0). Se você utiliza uma atualização anterior, ela pode conter informações diferentes das quais você vê na sua plataforma. |
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas