Defina um tipo de entidade
Antes de começar
- As permissões
entity-type.createeattribute-def.create. - Dados de referência já carregados para qualquer atributo que você pretenda vincular — veja gerencie dados de referência.
1. Crie o tipo de entidade
Criando um tipo de entidade. O nome é permanente; o rótulo de exibição não.
Dê a ele um nome e um rótulo de exibição. O nome o identifica na configuração e na API; o rótulo é o que as pessoas leem e pode ser alterado depois sem afetar dados armazenados.
2. Acrescente atributos
Para cada atributo decida quatro coisas, nesta ordem:
| Decisão | Consequência |
|---|---|
| Tipo de dado | Quais valores são aceitos, e quais comparadores podem ser usados |
| Cardinalidade | Se um valor ou vários. Mudar depois é disruptivo. |
| Obrigatório | Se um registro pode existir sem ele |
| Vínculo a referência | Se os valores são restritos a uma lista controlada |
Acerte a cardinalidade de primeira. Declarar e-mail como valor único obriga a plataforma a descartar dados reais em cada consolidação, e ampliar depois significa reexaminar todo registro que já perdeu valores.
3. Vincule valores controlados
Onde existir vocabulário controlado, vincule o atributo ao seu tipo de lookup. A plataforma então aceita apenas os códigos daquela lista e resolve rótulos de forma consistente em toda parte.
Para um atributo multivalorado, você pode adicionalmente vincular uma lista de tipos de uso — residencial, comercial, celular. A sobrevivência então resolve cada uso independentemente, em vez de escolher um único vencedor entre todos.
4. Declare compostos como compostos
Um endereço é um conjunto de partes nomeadas, não uma string. Declará-lo composto é o que permite à comparação comparar códigos postais exatamente enquanto compara logradouros de forma tolerante.
Achatá-lo em texto não é recuperável depois.
5. Defina o modelo de exibição
O rótulo de um tipo de entidade é derivado de atributos escolhidos, para que registros se exibam de forma significativa em listas, resultados de busca e filas de revisão.
Mudar o modelo depois exige uma recomputação para aplicá-lo a registros existentes — veja carregue dados em massa.
6. Verifique
Crie um registro com todos os atributos preenchidos e leia-o de volta. Confirme que:
- Valores são armazenados na forma canônica que suas regras de padronização produzem.
- Atributos vinculados a lookup resolvem para rótulos, não códigos crus.
- Compostos voltam como valores estruturados, não strings concatenadas.
- O rótulo de exibição renderiza como pretendido.
Fazer isso uma vez, antes de carregar em volume, é muito mais barato que descobrir um erro de modelagem depois que um milhão de registros existe.
A seguir
Última verificação no commit d3c2586b (2026-08-03)