Veja nesta publicação com ajustar e controlar regras de mapeamento de dados de forma “externa”, sem interferir no desenho do projeto de integração Magic xpi.
O Magic xpi possui um recurso bem interessante, mas talvez pouco explorado, que nos permite ajustar regras de mapeamento de dados do conector DataMapper de forma totalmente externa, sem necessidade de alterar o desenho (código) do projeto desenvolvido.
São as Conversion Tables.
As Conversion Tables estão disponíveis no repositório Data Converter do projeto:
e são basicamente cadastros de arquivos do tipo TEXTO, divididas em dois grupos:
- Estáticas = o nome de este arquivo é fixo e conhecido durante a etapa de desenvolvimento, e muito dificilmente terá seu conteúdo alterado
- Dinâmicas = o nome de este arquivo não é fixo e nem conhecido durante a etapa de desenvolvimento, e frequentemente terá seu conteúdo alterado
Estes arquivos possuem uma estrutura muito simples de linhas, no formato: <DE><delim><PARA>
- DE: representa o dado original, como ele será encontrado durante a execução do projeto
- PARA: representa o dado final, substituindo o “DE” (convertido)
- <delim>: representa o dado que separa o “DE” e o “PARA”, geralmente (mas não restrito a) uma vírgula
Veja dois exemplos:
Uma vez que estas tabelas estão definidas, usá-las é muito simples.
É através da função Convert.
Geralmente faremos isso em regra do DataMapper (mas seu uso não é exclusivo a este local).
Veja:
O que a função Convert faz é pegar um determinado dado de input e pesquisá-lo na respectiva tabela de conversão. Encontrando a referência, executa a substituição.
Se a Conversion Table for dinâmica, ou seu conteúdo pode ter sido alterado, basta pedirmos para recarregá-la a partir do seu arquivo TEXTO, com o componente Refresh Conversions:
Então, dado um determinado valor de input:
o processamento dele pelas duas Conversion Tables do exemplo, produz este resultado:
Fique ligado no Blog MagicBR, para mais dicas sobre o Magic xpi.
Para receber os artigos do Blog Magic Brasil em primeira mão no seu email, registre-se aqui