Skip to main content

Template de Atributo (TemplateAttribute)

O Template de Atributo define um modelo reutilizável de configuração para atributos.
Ele permite padronizar estruturas, conjuntos de propriedades e comportamentos esperados, garantindo consistência na criação de atributos em diferentes contextos do sistema.

Todo template pertence a uma empresa e pode ser utilizado por múltiplos atributos.


Identidade do Modelo

Configurações estruturais que definem o comportamento do objeto.

RecursoIdentificadorFinalidade
MóduloAtributoContexto funcional
GrupoTemplateAttributeIdentificação técnica do schema
PrincipalSimDisponível como ponto de entrada no menu

Contrato do Modelo

Este schema opera sob as seguintes garantias:

  • Todo TemplateAttribute pertence a uma empresa
  • O campo code é auto-gerado, único e imutável
  • A description é o identificador humano
  • Um template pode conter múltiplas propriedades
  • Templates podem ser reutilizados por vários atributos
  • O isolamento por empresa é aplicado automaticamente

Interface & Comportamento (UI)

Como o sistema expõe este objeto ao usuário final.

Inteligência de Busca

Campos indexados para navegação rápida:

  • Campos indexados: description, code
  • Descriptor: description

Sempre que um template for referenciado, o valor exibido será sua descrição.


Fluxo de Navegação

AçãoRota
Listagem/templateAttribute

Regras do Formulário

Fluxo de Preenchimento

A ordem, validações e bloqueios são controlados automaticamente pelo sistema.

Código (code)

  • Auto-gerado
  • Obrigatório
  • Único
  • Não editável após criação

Descrição (description)

  • Texto (máx. 100 caracteres)
  • Obrigatório

Propriedades (properties)

  • Relacionamento com o schema Properties
  • Lista de propriedades associadas ao template
  • Obrigatório

Filial / Empresa (companySiteId)

  • Relacionamento com CompanySite
  • Somente leitura
  • Preenchido automaticamente pelo contexto

Conectividade e Regras Especiais

CampoRelation SchemaValor DefaultValor Fixo
companySiteIdCompanySiteContexto atual-
propertiesProperties--
sync--false

Os relacionamentos garantem integridade entre templates, atributos e empresas.


Segurança e Integridade

Multitenancy (Múltiplas Empresas)

Com multi_company: true, o sistema aplica:

  • Isolamento completo por empresa
  • Filtro automático em todas as consultas
  • Bloqueio de acesso cruzado, inclusive via API

Sincronização de Dados

  • dataSync: registro temporal da última sincronização
  • sync: flag de controle interno
  • Valor inicial fixo: false

Exemplo de Registro

{
"code": 5,
"description": "Atributo Numérico",
"properties": [
"min",
"max",
"precision"
],
"companySiteId": "64fa9c2e8b1c2a001f3e9a77"
}