Dados de referência
As listas de códigos do workspace, como países, moedas ou estados de encomenda, com versões que não mudam depois de criadas e mapeamentos dos códigos de outros sistemas. As regras «Lista de referência» validam colunas contra elas, e a coerência mostra onde os datasets divergem.
O que podes fazer
- Criar uma Nova lista com nome e identificador, a partir de uma lista ISO (países alfa-2 ou alfa-3, moedas), escrita à mão com uma linha
CÓDIGO;Rótulopor código, ou importada de uma coluna. O identificador é o que as regras usam e não muda depois. - Importar os códigos de uma coluna de um dataset, com uma coluna de rótulos opcional. O BeryX lê até 20 000 linhas da coluna na fonte, só em leitura (uma amostra, se a tabela for maior), e grava os códigos distintos como versão nova; cada código fica com o rótulo mais frequente. Quando as linhas lidas são uma amostra, a mensagem da importação avisa que um código que não esteja nelas ficou fora da lista.
- Criar uma Nova versão a partir dos códigos da versão em uso, ou de uma versão antiga aberta no seletor, e ver antes de gravar quantos códigos entram, saem ou mudam de rótulo. O Histórico de versões mostra o mesmo para cada versão.
- Editar os Mapeamentos, com uma linha
SISTEMA;código no sistema;código da listacada um. Uma regra com sistema traduz os valores da coluna por eles antes de os procurar na lista. - Ver a Coerência entre sistemas, a partir do último scan de cada regra que usa a lista: os valores fora da lista e em quantos datasets aparecem, o mesmo código com rótulos ou mapeamentos diferentes, e as regras avaliadas contra uma versão antiga.
- Usar uma lista numa regra: em Regras, no tipo «Lista de referência», escolher a lista do registo, fixar ou não uma versão e indicar o sistema e a coluna de rótulos, se os houver.
Ver também
- Regras — as regras «Lista de referência» que validam colunas contra estas listas.
- Glossário — os termos de negócio e as colunas que os implementam.
English
Reference data
The workspace's code lists, such as countries, currencies or order statuses, with versions that never change once created and mappings from other systems' codes. “Reference list” rules validate columns against them, and coherence shows where datasets disagree.
What you can do
- Create a New list with a name and a key, from an ISO list (alpha-2 or alpha-3 countries, currencies), written by hand with one
CODE;Labelline per code, or imported from a column. Rules use the key, and it never changes. - Import the codes from a dataset column, with an optional label column. BeryX reads up to 20,000 rows of the column at the source, read-only (a sample, if the table is larger), and saves the distinct codes as a new version; each code gets its most frequent label. When the rows read are a sample, the import message warns that a code missing from them was left out of the list.
- Create a New version from the codes of the version in use, or of an older version opened in the selector, and see before saving how many codes come in, go out or change label. The Version history shows the same for every version.
- Edit the Mappings, one
SYSTEM;code in the system;list codeline each. A rule with a system translates the column's values through them before looking them up in the list. - See Coherence across systems, from the last scan of every rule that uses the list: values outside the list and in how many datasets they appear, the same code with different labels or mappings, and rules evaluated against an old version.
- Use a list in a rule: in Rules, with the “Reference list” type, pick the registry list, pin a version or not, and set the system and the label column, if there are any.