Grupo

Organize seus formulários com blocos de campos

O campo do tipo Grupo é utilizado para reunir campos relacionados dentro de uma área visual com título e borda, organizando o formulário em blocos lógicos em formulários, tarefas e telas do ENSPACE.

O grupo em si não armazena valor — ele serve como contêiner para outros campos, melhorando a legibilidade e separação de informações.

Ele é ideal para formulários com muitos campos que precisam ser agrupados por tema ou seção, como separar "Informações Pessoais" de "Dados de Contato", criar um bloco de "Responsável Legal" ou isolar campos financeiros em uma seção própria.

Quando usar este campo

Utilize o campo Grupo quando precisar organizar visualmente campos relacionados em um bloco lógico dentro do formulário.

Ele é ideal para:

• Informações pessoais (nome, CPF, data de nascimento, estado civil)
• Dados de contato (telefone, e-mail, endereço, CEP)
• Responsável legal (nome, CPF, grau de parentesco, telefone)
• Dados do contrato, partes envolvidas, condições financeiras
• Qualquer conjunto de campos que compartilhem um contexto temático

Informações básicas do campo

Todo campo no ENSPACE possui quatro informações básicas que são definidas no momento da criação:

• Nome do campo — nome interno utilizado nas configurações da categoria. Possui limite de 31 caracteres. Não é necessariamente o nome exibido para o usuário final.
• Rótulo Visível (Label) — nome exibido para os usuários em formulários, tarefas e telas. Possui limite de 255 caracteres. Pode ser mais descritivo que o nome interno e pode ser alterado posteriormente sem impactar automações ou referências técnicas.
• Referência técnica — identificador técnico do campo, gerado automaticamente em formato snake_case. É utilizado em expressões, variáveis, fluxos, automações e referências internas.
• Descrição — descrição interna para adicionar contexto ao campo. Ajuda configuradores a entenderem a finalidade do campo e auxilia recursos de IA do ENSPACE durante pesquisas e interpretações automáticas.

Como o campo funciona

O campo Grupo funciona como um contêiner visual e lógico para subcampos.

O grupo exibe um bloco com título (o Label do campo) e borda, contendo os subcampos configurados. A ordem dos subcampos é definida na configuração e pode ser reordenada após a criação. O grupo não armazena valor próprio — os dados ficam nos subcampos individuais.

O campo aceita qualquer tipo de campo como subcampo, incluindo Repetidor, Matriz de Dados e até outro Grupo, com aninhamento limitado a dois níveis de profundidade.

Configurações específicas

O campo Grupo possui configurações próprias relacionadas a escopo de condicionais, visualização e subcampos aninhados.

Escopo das condicionais

Os subcampos de um Grupo podem ter condicionais configuradas na aba Regras e Condições — por exemplo, exibir o subcampo "Estado Civil" somente se o subcampo "Maior de idade" for "Sim". Mas quais campos podem ser usados como referência nessas condicionais? É isso que o escopo controla.

O escopo é configurado no campo Grupo (não nos subcampos individuais) e se aplica a todos os subcampos dentro dele. As três opções são:

• Somente este grupo — as condicionais só podem referenciar subcampos que estão dentro do mesmo grupo. Um subcampo pode olhar para outro subcampo do grupo, mas não para nada fora dele.
• Campos do nível acima — as condicionais podem referenciar campos do grupo pai (o nível imediatamente acima). Se o Grupo estiver dentro de outro Grupo, os subcampos podem olhar para os subcampos do grupo externo. Se o Grupo não estiver dentro de outro Grupo, esta opção não terá campos disponíveis.
• Todo o formulário — as condicionais podem referenciar qualquer campo do formulário inteiro, dentro ou fora de qualquer grupo.

Neste diagrama:

• Com escopo Somente este grupo: o subcampo Nome pode criar uma condicional referenciando CPF ou Data de Nascimento (ambos dentro do mesmo grupo), mas não pode referenciar o Campo Externo.
• Com escopo Campos do nível acima: o subcampo Nome pode referenciar o Campo Externo (que está no nível acima do grupo). Se o Grupo "Dados Pessoais" estivesse dentro de outro Grupo, o nível acima seria o grupo pai.
• Com escopo Todo o formulário: o subcampo CPF pode referenciar qualquer campo — tanto os subcampos do grupo quanto o Campo Externo ou qualquer outro campo do formulário.

Formato de Visualização

Define como os dados do grupo aparecem na tabela nativa de itens da categoria. Use chaves duplas para inserir referências de subcampos (ex: {{nome}} - {{cpf}}). O texto formatado será exibido como valor do grupo na coluna correspondente da tabela de itens.

Subcampos

Clique em Adicionar na seção Aninhados para criar cada subcampo com as seguintes configurações:

O modal de subcampo também possui as abas Regras e Condições, Ajuda e Eventos de Campo, que funcionam da mesma forma que em campos comuns — com a diferença de que as condicionais respeitam o escopo configurado no grupo pai.

Aninhamento

O Grupo aceita qualquer tipo de campo como subcampo — incluindo Repetidor, Matriz de Dados e até outro Grupo.

Não há limite de quantidade de subcampos dentro de um Grupo.

Uso em condicionais do formulário

Os subcampos de um Grupo podem ser usados como referência em condicionais no construtor de formulários. A seleção é feita por uma lista aninhada — você expande o grupo e aponta diretamente para o subcampo desejado.

Além das condicionais internas (entre subcampos), é possível tornar o Grupo inteiro condicional dentro do formulário. Por exemplo: exibir o bloco "Responsável Legal" somente se o campo "Menor de idade" for igual a "Sim". Essa condicional é configurada no construtor de formulários — especificamente na configuração do campo Grupo dentro do formulário, não na criação padrão do campo.

Como configurar

Comportamento dos dados

Algumas alterações feitas no campo afetam apenas novos preenchimentos:

• Adicionar ou remover subcampos não altera dados já preenchidos em registros antigos.
• Modificar o escopo das condicionais não retroage em itens já criados.
• Alterar o formato de visualização não modifica a exibição de registros existentes.
• Os dados anteriores só serão alterados caso sejam editados novamente.

Em relatórios, cada subcampo aparece como uma coluna independente, identificada pela sua própria referência técnica.

Boas práticas

• Utilize Grupo para organizar visualmente formulários complexos com muitos campos.
• Configure o escopo "Somente este grupo" como padrão para manter condicionais isoladas e previsíveis.
• Use "Todo o formulário" apenas quando subcampos precisarem reagir a campos externos ao grupo.
• Defina larguras de subcampos para criar layouts balanceados (ex: dois campos de metade lado a lado).
• Ative "Preservar dados" para subcampos que podem ser ocultados temporariamente por condicionais.
• Prefira abas do formulário (campo Seção) para separações maiores, e Grupo para agrupamentos dentro de uma mesma aba.
• Evite aninhar mais de dois níveis para garantir performance e clareza visual.