Formulários

Crie interfaces de entrada de dados

Os formulários são a interface principal de coleta, visualização e edição de informações no ENSPACE. Eles são utilizados para criar itens, editar registros existentes e apresentar dados ao usuário de forma estruturada.

Cada formulário pertence a uma categoria específica e só pode ser utilizado dentro dela. Uma mesma categoria pode ter múltiplos formulários — cada um com propósito, tipo e permissões diferentes. O mesmo campo pode aparecer em mais de um formulário da mesma categoria.

Para acessar, vá até Configurações > Estrutura > Categorias, selecione a categoria desejada e clique em Formulários.

Tipos de formulário

• Criação — utilizado apenas para criar novos itens. Não aparece nas opções de edição.
• Editar — utilizado apenas para editar itens existentes. Não aparece nas opções de criação.
• Geral — permite criação e edição no mesmo formulário. Indicado quando o mesmo layout serve para os dois contextos.
• Visualizar — apenas exibe os dados, sem possibilidade de edição. Indicado para telas de consulta ou aprovação somente leitura.

Visibilidade

• Privado — acesso restrito. Apenas membros com permissão podem utilizar o formulário.
• Público — gera um link externo que qualquer pessoa pode acessar e preencher, sem necessidade de autenticação no ENSPACE. Indicado para coleta de dados externos. O link não expira — para desativá-lo sem excluir o formulário, basta alterar a visibilidade de volta para Privado.

Duplicar e excluir formulários

Você pode duplicar um formulário existente para criar uma variação — útil quando dois formulários compartilham a maior parte dos campos mas diferem em alguns detalhes.

A exclusão de um formulário é permanente, mas os itens criados por ele permanecem na categoria — apenas o formulário deixa de existir.

Como criar um formulário

Permissões do formulário

Por padrão, todo novo formulário é criado sem permissões liberadas. O formulário não estará disponível para uso até que as permissões sejam configuradas.

Após salvar, o sistema verifica se você possui autorização para definir as permissões (ser membro Full, ter cargo atribuído ou ter permissão para editar cargos). Se possuir, um modal será exibido com as ações disponíveis: Ver, Criar, Atualizar e Excluir.

Se você não possuir autorização, o formulário será criado com sucesso mas ficará indisponível. Solicite a um administrador que configure as permissões em Gestão de Membros > Cargos.

Construtor de formulário

Após criar o formulário, clique em Construtor para acessar o editor visual. O construtor permite montar a estrutura do formulário adicionando, organizando e configurando blocos.

Blocos

O formulário é composto por blocos. Cada bloco representa um campo da categoria posicionado no formulário. Você pode adicionar quantos blocos forem necessários e reorganizá-los livremente no layout por meio de arrastar e soltar.

Para adicionar um bloco, clique em Adicionar Novo Bloco na área tracejada à direita. Um dropdown exibirá todos os campos disponíveis na categoria — selecione o campo desejado ou clique em + Novo para criar um campo diretamente pelo construtor.

Se você adicionar um campo novo à categoria depois de criar o formulário, ele não aparecerá automaticamente — é necessário adicioná-lo manualmente no construtor de cada formulário que deve incluí-lo.

Menu de opções do bloco

Cada bloco exibe um menu de opções (ícone de engrenagem) com as seguintes ações:

• Remover Bloco — remove o bloco do formulário (o campo continua existindo na categoria).
• Esconder Campo — oculta o campo no formulário sem removê-lo do layout.
• Largura — define o espaço ocupado pelo bloco: w-6/12 (meia largura, dois blocos lado a lado) ou w-full (largura total da linha).
• Conteúdo Adicional — permite inserir conteúdo HTML (textos explicativos, títulos, imagens) acima ou abaixo do campo, com as opções Ao Topo do Campo e Abaixo do Campo.
• Configurações — abre o modal de configurações detalhadas do bloco.

Configurações detalhadas do bloco

Ao clicar em Configurações no menu do bloco, um modal é aberto com as seguintes opções:

• Condicionais — regras de exibição condicional do bloco, divididas em dois grupos:
  • Ou Condicionais — o bloco aparece se qualquer condição for verdadeira.
  • E Condicionais — o bloco aparece se todas as condições forem verdadeiras.
• Campo Invisível — quando ativado, o campo existe no formulário mas não é exibido ao usuário.
• Somente Leitura — o campo fica visível, mas não pode ser editado. O valor exibido é apenas para exibição (display) e não é salvo ao enviar o formulário.
• Desabilitar Edição — o campo fica visível e os dados inseridos por eventos, automações ou outras ações automáticas são salvos normalmente, mas o usuário não pode editar o valor manualmente. Use esta opção quando o campo precisa receber dados automaticamente, mas não deve ser alterado pelo usuário. Diferente do modo Somente Leitura, que não persiste dados.
• Validações Básicas — selecione uma regra de validação que bloqueia o envio se o campo não for válido.
• Rótulo Visível (Label) — texto exibido acima do campo no formulário. Se não preenchido, o nome do campo é utilizado.
• Espaço Reservado — texto placeholder exibido dentro do campo quando vazio.
• Ajuda — texto de ajuda exibido ao lado do campo para orientar o preenchimento.
• Instrução — texto informativo exibido abaixo do campo.

Condicionais no formulário

Condicionais permitem controlar a visibilidade de blocos com base em regras. O modal de configurações do bloco oferece dois grupos de condicionais:

• Ou Condicionais — o bloco aparece se qualquer uma das condições configuradas neste grupo for verdadeira.
• E Condicionais — o bloco aparece se todas as condições configuradas neste grupo forem verdadeiras.

Clique em Adicionar dentro do grupo desejado para criar uma nova condição.

Tipos de condicionais

• Igual — o campo de referência é exatamente igual ao valor alvo.
• Diferente — o valor é diferente do valor alvo.
• Contém — o valor inclui o texto do valor alvo.
• Maior que / Maior ou igual — para valores numéricos.
• Menor que / Menor ou igual — para valores numéricos.

Campo de referência e valor alvo

Ao configurar uma condicional, selecione o Campo de Referência (o campo cujo valor será avaliado). O Valor Alvo se adapta automaticamente ao tipo do campo: dropdown para listas, input de texto para texto livre, seletor de data, input numérico ou toggle para booleano.

O campo de referência suporta estrutura aninhada — é possível expandir um campo do tipo Grupo ou Repetidor e selecionar diretamente um subcampo.

Preview

A aba Preview exibe o formulário exatamente como será apresentado aos usuários. Use para verificar a disposição dos blocos, simular o preenchimento, testar condicionais e confirmar textos de ajuda e validações antes de publicar.

O preview reflete as configurações salvas. Alterações não salvas no construtor não serão visíveis.

Condicional no bloco x condicional no campo

Há dois lugares onde uma regra de exibição pode ser escrita, e eles não se comportam da mesma forma:

Nos dois casos a condicional é avaliada contra os valores do formulário aberto, nunca contra o item gravado no banco.

Exemplo real: um campo "Ajustes solicitados" tinha, na configuração do campo, a regra aparecer quando Aprovação = Solicitar ajustes. No formulário de aprovação funcionava. No formulário que o solicitante usava para corrigir, o campo "Aprovação" não existia — e o texto do que havia sido pedido nunca aparecia para quem precisava lê-lo.

Regra prática: comportamento que é de um formulário mora no bloco daquele formulário. Se a condicional precisar mesmo viver no campo, inclua o campo de referência em todos os formulários que exibem o campo condicionado — nem que seja como bloco em Somente Leitura.