Dados de referência em resumo
As peças
| Peça | O que é |
|---|---|
| Tipo de lookup | Uma lista controlada |
| Valor de lookup | Uma entrada: um código estável e um rótulo legível |
| Mapa de transcodificação | Transforma o código de um sistema no canônico |
| Hierarquia | Uma classificação nivelada para agregação |
Código versus rótulo
| Armazenado | Alterável | |
|---|---|---|
| Código | Sim — em cada registro | Não — mudá-lo órfã os dados |
| Rótulo | Não — resolvido na leitura | Sim, livremente |
Essa separação é por que renomear um valor na interface não reescreve um único registro.
A confusão que vale antecipar
| Conceito | Liga | Chama-se |
|---|---|---|
| Um registro → o identificador de um sistema de origem para ele | Registros | Crosswalk |
| O valor de código de um sistema → o canônico | Valores | Transcodificação |
Algumas plataformas usam "crosswalk" para o segundo. Esta documentação o reserva estritamente para o primeiro.
Por que transcodificar antes de carregar
Um código que não resolve contra seu tipo de lookup é recusado na gravação. O
registro não chega carregando um valor ruim — a carga falha. Então um sistema
enviando USA onde o lookup tem US custa uma carga falha, não uma
correspondência silenciosamente mal pontuada.
A transcodificação é o que transforma essa recusa numa carga bem-sucedida, mapeando o código do sistema para o canônico antes.
O mapeamento por sistema de origem é consultado quando um registro é criado ou alterado individualmente e quem chama identificou seu sistema de origem. Uma carga em massa resolve códigos de forma estrita e direta, então traduza os valores antes de submetê-los.
Aposente, não exclua
Um valor em uso continua resolvendo em registros históricos depois de aposentado. Excluí-lo deixa esses registros exibindo um código cru — os registros não estão errados, o vocabulário é que ficou incompleto.
Duas coisas chamadas hierarquia
| Conceito | O que é | Usado para |
|---|---|---|
| Árvore de valores | Um valor referenciando um valor pai | Restringir valores permitidos |
| Hierarquia nivelada | Uma estrutura nomeada com níveis ordenados | Classificação e agregação |
Ambas legítimas; respondem perguntas diferentes.
A seguir
Última verificação no commit d3c2586b (2026-08-03)