Relacionamento Simples

Permite selecionar um único item de outro tipo, criando uma ligação direta entre dados relacionados.
Atualizado

Configure campos de relacionamento simples

O campo do tipo Relacionamento Simples é utilizado para selecionar um único item de outra categoria previamente criada na plataforma, criando uma ligação direta entre registros interconectados em formulários, tarefas e telas do ENSPACE.

Ele é ideal para vincular informações de forma direta, como selecionar um cliente em um pedido, um responsável por um projeto ou uma empresa em um contrato.

Para relacionar múltiplos itens de outra categoria, utilize o campo Relacionamento Múltiplo.

Quando usar este campo

Utilize o campo Relacionamento Simples quando precisar vincular um único registro de outra categoria ao item atual.

Ele é ideal para:

  • Selecionar um cliente em um pedido
  • Associar um responsável em um projeto
  • Relacionar uma empresa em um contrato
  • Escolher um analista para uma solicitação
  • Vincular um produto a uma categoria
  • Referenciar um documento ou registro pai

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.
Após salvar o campo pela primeira vez, a referência técnica não poderá ser alterada.

Como o campo funciona

Em programação, um relacionamento é uma associação entre dois registros de diferentes entidades (tabelas ou categorias). O campo de relacionamento simples armazena uma referência única (chave estrangeira) que aponta para um item específico da categoria relacionada.

O campo Relacionamento Simples funciona como um seletor de item único vinculado a outra categoria.

O usuário visualiza uma lista filtrada de itens da categoria relacionada e seleciona apenas um registro. O valor salvo é uma referência direta ao item escolhido, permitindo navegação, filtros, expressões e automações entre categorias interconectadas.

O campo permite configurar filtros de exibição, formato de visualização, agrupamento e dependências para controlar quais itens aparecem e como são apresentados.


Configurações específicas

O campo Relacionamento Simples possui configurações próprias relacionadas à categoria vinculada, filtros, visualização e comportamento de dependência.

Relação

ConfiguraçãoDescrição
CategoriaCategoria que será relacionada. Define de qual categoria os itens serão listados para seleção.
FormuláriosSeleciona os formulários para relacionar. Define quais layouts ou estruturas de entrada de dados serão vinculados ao campo. Se não filtrar, todos os formulários da categoria poderão ser usados para trazer dados de relacionamento e no atalho de criar item pelo campo.

Filtros de Exibição

Define condições para filtrar quais itens da categoria relacionada serão exibidos. Permite criar regras específicas, usando campos e operadores, para mostrar apenas os registros relevantes para o contexto.

A estrutura de condicionais dos filtros de exibição está detalhada na documentação de Condicionais.

Formato de Visualização

Informação que será usada para identificar os itens listados. Define qual campo ou expressão aparece como label de cada item no dropdown de seleção.

Agrupar por

Campo usado para agrupar os itens na lista. Organiza as informações em blocos visuais, facilitando a localização e a categorização dos dados.

Formulários usados para filtrar os itens

Habilitando esta opção, os itens presentes no campo de relacionamento serão filtrados pelos formulários selecionados.

Desanexar Agrupamento

Quando ativo, permite que os itens relacionados sejam exibidos de forma independente, sem ficarem estritamente presos à estrutura do grupo principal.

Desabilitar Criação

Ao ativar esta opção, não será possível criar um novo item relacionado diretamente pelo campo. O usuário poderá apenas selecionar itens anteriormente criados.

Habilitar Dependência

Habilita a dependência de campo para este relacionamento. Garante que as opções deste campo só apareçam com base na seleção feita em outro campo anterior.

Ao habilitar a dependência, é necessário criar também um campo de relacionamento correspondente na outra categoria para manter a integridade dos vínculos.

Campo Dependente

Seleciona o campo do qual este relacionamento depende. Define o campo "pai" que controlará quais itens serão filtrados e exibidos neste relacionamento atual.

Atenção:
Quando a dependência está habilitada, o sistema aplica validações automáticas: o campo dependente se torna obrigatório na criação; ao excluir um item, a referência é removida automaticamente nos itens relacionados (o item excluído é inativado, não removido permanentemente); ao editar, itens removidos ou adicionados têm suas referências atualizadas automaticamente na outra categoria.

Configuração de Opções

ConfiguraçãoDescrição
Buscar ao CarregarUtiliza o valor inicial do campo para buscar e selecionar o primeiro item da lista. Se o valor inicial estiver vazio, seleciona o primeiro em ordem alfabética.

Como configurar

Crie um novo campo

Acesse Configurações > Categorias > Campos e clique em Criar.

Preencha as informações básicas

Defina o nome do campo, a referência técnica, o rótulo visível (Label) e selecione o tipo Relacionamento Simples.

Configure a relação

Na seção Configurações Específicas, selecione a categoria relacionada e defina os formulários disponíveis.

Defina filtros e visualização

Configure os filtros de exibição, o formato de visualização e o agrupamento dos itens listados.

Ajuste comportamentos avançados

Defina as opções de desanexar agrupamento, desabilitar criação, habilitar dependência e campo dependente conforme a necessidade.

Salve o campo

Após salvar, o campo poderá ser utilizado em formulários, tarefas e telas.


Comportamento dos dados

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

  • Alterar a categoria relacionada não modifica vínculos já existentes em registros antigos.
  • Modificar filtros de exibição não altera itens já selecionados.
  • Adicionar ou remover dependência não retroage automaticamente em registros existentes.
  • Os dados anteriores só serão alterados caso sejam editados novamente.

O valor continua sendo armazenado internamente como uma referência única ao item da categoria relacionada.


Boas práticas

  • Utilize Relacionamento Simples quando apenas um item da categoria relacionada deve ser vinculado.
  • Configure filtros de exibição para evitar listas excessivamente longas e melhorar a experiência do usuário.
  • Defina um formato de visualização claro para facilitar a identificação do item correto.
  • Utilize agrupamento quando a categoria relacionada possuir categorias ou classificações internas.
  • Ative "Desabilitar Criação" quando o usuário não deve criar novos itens da categoria relacionada diretamente pelo campo.
  • Utilize dependência apenas quando houver campo correspondente na categoria relacionada para manter a integridade dos dados.
  • Prefira desanexar agrupamento quando a estrutura de grupos não for relevante para a seleção.