Gerencie tipos e valores de lookup
Antes de começar
rdm.lookup-type.create e rdm.lookup-value.create para construir uma lista,
rdm.transcode-map.create para mapear códigos de origem, e os códigos .update
correspondentes para alterá-los depois.
1. Crie o tipo de lookup
Criando um tipo de lookup. Uma lista em rascunho pode ser montada antes que algo se vincule a ela.
Nomeie a lista pelo conceito que ela controla, não por onde é usada primeiro.
country sobrevive a customer_country, e uma lista serve todo atributo que precise
de países.
2. Acrescente valores
Os valores de um tipo de lookup. O código é o que os registros armazenam e não pode ser editado; o rótulo pode.
Cada valor tem um código e um rótulo.
| Finalidade | Alterável | |
|---|---|---|
| Código | Armazenado nos registros; identificador estável | Não — mudá-lo órfã dados armazenados |
| Rótulo | O que as pessoas leem | Sim, livremente |
Escolha códigos de um padrão onde existir. Inventar códigos para países ou moedas cria um problema de mapeamento para toda integração seguinte.
3. Vincule atributos a ele
Um atributo vinculado a um tipo de lookup aceita apenas seus códigos. A plataforma resolve códigos para rótulos na leitura, então todo consumidor exibe a mesma coisa.
A busca considera isso: pesquisar um atributo vinculado casa com o rótulo resolvido além do código armazenado, então uma pessoa pode ser encontrada pelo nome do seu município em vez do número.
4. Mapeie códigos de origem
Onde origens usam seus próprios códigos, acrescente mapeamentos de transcodificação para que cada um vire o valor canônico na entrada.
Faça isso antes de carregar. Sem isso, a comparação vê o US de uma origem e
o USA de outra como discordância, e pontua dois registros da mesma pessoa como
evidência contra uma correspondência.
5. Aposente um valor
Não exclua um valor que registros referenciam. Aposente-o: ele deixa de ser oferecido para novos registros e continua resolvendo para os existentes.
Registros guardam o código. Remover o valor ao qual ele resolve faz registros históricos exibirem um código cru onde havia um rótulo — e os registros não estão errados, o vocabulário é que ficou incompleto. A aposentadoria existe exatamente para isso.
6. Verifique
- Um registro pode ser criado com um código válido, e rejeitado com um inválido.
- Lê-lo devolve o rótulo resolvido.
- Um código de origem chega e é armazenado como seu equivalente canônico.
- Um valor aposentado ainda resolve num registro existente.
A seguir
Última verificação no commit d3c2586b (2026-08-03)