Tabelas de conversão

Tabelas de conversão, também chamadas de de/para, permitem traduzir valores entre origem e destino sem mudar o código da integração.

No modelo atual do produto, esse recurso deve ser entendido como um caso comum de Data Store.

Quando usar

Use tabelas de conversão quando houver necessidade de mapear:

• códigos internos para códigos externos;

• status de um sistema para outro;

• siglas para identificadores completos;

• regras de classificação controladas pelo negócio.

Estrutura

Uma tabela de conversão normalmente possui:

• um cabeçalho com código externo e descrição;

• itens contendo o valor de origem e o valor de destino.

Na maioria dos cenários, isso aparece como externalCode no cabeçalho e pares fromValue/toValue nos itens.

Uso no SDK

O SDK expõe utilitários para leitura de data stores e consulta a itens de conversão durante a execução.

Isso permite que a regra fique no produto, e não embutida no código.

Quando o cenário evolui além de um simples de/para, prefira pensar no recurso como Data Store e documentar o contexto funcional daquele conjunto de dados.

Boas práticas

• use códigos claros e estáveis;

• mantenha ownership funcional definido;

• trate tabelas como configuração de negócio, não como área de testes improvisados;

• revise itens obsoletos periodicamente.