Pular para o conteúdo principal

Atributos e tipos de dados

Um atributo é uma informação nomeada em um tipo de entidade. Como você o declara muda o comportamento da comparação, da sobrevivência e da validação.

Cardinalidade

Valor únicoMultivalorado
Exatamente um valor significativoVários valores legítimos ao mesmo tempo
Um nome legal, uma data de nascimentoEndereços de e-mail, telefones, endereços
Comparado atomicamenteComparado em todas as combinações
Um vencedor de sobrevivênciaOpcionalmente todos os valores distintos preservados

Errar aqui é caro depois. Declarar e-mail como valor único obriga a plataforma a descartar dados reais em cada consolidação.

Tipos de uso

Um atributo multivalorado pode vincular um tipo de uso — residencial, comercial, celular — extraído de uma lista controlada.

Isso é mais que um rótulo. A sobrevivência agrupa por tipo de uso, então cada um se resolve independentemente: um endereço residencial vencedor e um comercial vencedor, em vez de um endereço só. Sem tipos de uso, uma consolidação teria de escolher um único endereço e descartar o resto.

Um valor por tipo de uso pode ser marcado como preferencial.

Atributos compostos

Alguns valores são estruturados, não escalares. Um endereço é um conjunto de partes nomeadas, não uma string.

Declará-lo composto é o que permite à comparação mirar sub-campos — comparando códigos postais exatamente enquanto compara logradouros de forma tolerante. Isso é impossível se o endereço for uma string única.

Nunca achate um composto em texto

Uma vez perdida, a estrutura não é recuperável de forma confiável. Comparar dois compostos inteiros com um comparador escalar é recusado — dois endereços completamente diferentes se comparariam como iguais, uma consolidação catastrófica.

Vínculo a dados de referência

Um atributo cujos valores vêm de uma lista controlada é vinculado a um tipo de lookup. A plataforma então aceita apenas os códigos daquela lista.

O código é armazenado; o rótulo é resolvido na leitura. Essa separação significa que renomear um valor na interface não reescreve dados armazenados, e todos os consumidores exibem a mesma coisa.

A busca também considera isso: pesquisar um atributo vinculado a lookup casa com o rótulo resolvido, não apenas com o código armazenado.

Validação

Atributos carregam regras de validação com severidade: erros bloqueiam a gravação, avisos registram uma violação.

A seguir


Última verificação no commit d3c2586b (2026-08-03)