Campo: Relacionamento

O campo do tipo Relacionamento permite selecionar apenas um item de outra categoria previamente criada na plataforma. 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.

Com esse campo, você pode criar relacionamentos entre registros e facilitar a organização e visualização de dados interconectados.

Como funciona

  • Exibe uma lista dos registros da outra categoria.
  • Permite a seleção de apenas um item para relacionar ao item que está sendo criado.

Como configurar

  1. No menu esquerdo, vá até a seção "Configurações".
  2. Acesse "Categorias" e selecione a categoria desejada.
  3. Vá em "Campos" e clique em "Criar".
  4. Dê um nome curto ao seu campo (com até 31 caracteres; a referência será preenchida automaticamente).
  5. Defina o label do seu campo — aqui você pode inserir um nome mais longo e descritivo.

    ⚠️ Atenção: O nome exibido no formulário será sempre o definido no campo "Label".

  6. Selecione o tipo "Relacionamento". Visualização do campo relacionamento Visualização do campo relacionamento
  7. Defina as seguintes configurações:
    • Categoria: Categoria que será relacionada.
    • Formulários (opcional): Formulário que será exibido ao clicar em "Novo" no relacionamento.
    • Formato de Visualização: Informação que será usada para identificar os itens listados.
    • Agrupar por: Campo usado para agrupar os itens na lista.
    • Formulários usados para filtrar os itens: Permite aplicar filtros por formulários na listagem.
    • Desanexar Agrupamento
    • Desabilitar Criação: Impede que novos itens sejam criados diretamente pelo campo de relacionamento.
    • Habilitar Dependência: Permite que, ao relacionar um item na categoria A, esse mesmo relacionamento seja automaticamente criado na categoria B.
      ⚠️ Atenção: Nesse caso, é necessário criar também um campo de relacionamento na outra categoria.
    • Campo Dependente: Campo correspondente na outra categoria que será usado para manter a dependência.
  8. Resultado esperado:
Visualização do campo relacionamento

Ao clicar em novo:

Visualização do campo relacionamentoVisualização do campo relacionamento

Exemplo de uso

  • 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.

Funcionalidades Avançadas

Ao ativar a opção Habilitar Dependência nos campos do tipo Relacionamento ou Relacionamento Múltiplo, regras específicas são aplicadas para manter a integridade dos dados entre categorias relacionadas.


1. Aba de Itens Relacionados

Essa funcionalidade, disponível apenas para campos do tipo Relacionamento Múltiplo, permite criar automaticamente uma nova aba na pasta do item atual, exibindo uma tabela com os itens vinculados. Na criação do campo de relacionamento múltiplo, basta selecionar a opção:

Visualização do campo relacionamento-multi

Essa aba permite:

  • Visualizar os registros relacionados.
  • Criar novos itens já vinculados ao item atual.
  • Editar ou desvincular itens diretamente pela interface.

⚠️ Se a dependência estiver habilitada, os novos itens criados a partir dessa aba já serão vinculados corretamente ao item pai de forma automática.


2. Regras de Dependência entre Categorias

Ao habilitar a dependência entre campos de diferentes categorias, o sistema aplica validações automáticas para garantir vínculos consistentes. Veja como isso funciona em diferentes cenários:

2.1. Criação de Itens de relacionamento simples com Dependência

  • O campo dependente se torna obrigatório durante a criação de items de relacionamento simples.
  • Se o campo de relacionamento não for preenchido, o item não será criado e o sistema retornará um erro, mesmo que o campo esteja oculto no formulário.
  • Quando a criação ocorre pela aba do relacionamento, o vínculo é feito automaticamente, permitindo a criação sem erros.

2.2. Exclusão de Itens com Dependência

  • Antes de excluir um item, o sistema verifica se ele está vinculado a outros itens por meio de campos com dependência.
  • Se estiver:
    • Remove automaticamente a referência do item excluído dos itens relacionados.
    • O item excluído será apenas inativado.
    • Caso seja reativado posteriormente, o vínculo não será restaurado automaticamente.

2.3. Edição de Itens com Dependência

  • Ao editar um item:
    • Os itens removidos do campo com dependência terão a referência removida automaticamente na outra categoria.
    • Os itens adicionados terão a referência incluída automaticamente.
  • Essa lógica é aplicada tanto para Relacionamentos Simples (EnRel) quanto para Relacionamentos Múltiplos (EnRelMulti).