Use o Gráfico Data Map Especificação Language para criar um mapa de mensagens programaticamente.
Sobre esta tarefa
O arquivo msl.xsd fornece o esquema XML que descreve o Linguagem de especificação do mapa de dados gráficos, também conhecida como MSL. Esse arquivo está disponível no componente Graphical Data Mapping Versão 1040 e versões posteriores.
É possível localizar o arquivo msl.xsd no arquivo jar com.ibm.msl.mapping.api_7.5.0.jar.
Em
IBM® App Connect Enterprise, você pode encontrar o arquivo JAR em qualquer um dos seguintes diretórios:
- Em uma instalação da plataforma Windows: C:\Program Files\IBM\IIB\10.0.0.0\server\ct\lib\
- Em uma instalação da plataforma Linux® : install_dir/iib-10.0.0.0/server/ct/lib/
É possível criar um mapa programaticamente quando tiver metadados que definem a lógica de
transformação que precisa ser aplicada a uma mensagem de entrada para produzir a saída. Por exemplo, é possível gravar um programa baseado em JAXB que constrói o mapa usando classes JAXB geradas a partir do esquema MSL fornecido. O programa lê os dados XML que definem os elementos de entrada a serem mapeados e os
elementos de saída.
Procedimento
Você deve executar as etapas a seguir para gerar programaticamente um arquivo de mapeamento:
- Criar um mapa de template no editor de Mapeamento de Dados Gráficos.
Implemente e teste seu mapa modelo no tempo de execução para confirmar que a transformação de mensagem está correta.
- Inspecione o conteúdo MSL XML no mapa modelo.
Use o esquema MSL para identificar as construções de mapeamento e a definição dos pontos de variação para o mapa modelo.
- Desenvolva os scripts e programas para gerar o MSL XML para os novos mapas que você planeja gerar programaticamente.
Quando você usa uma abordagem de desenvolvimento baseada em JAXB, o arquivo de ligações msl_jaxb_bindings.xml disponível no arquivo com.ibm.msl.mapping.api_7.5.0.jar fornece o mínimo de ligações necessárias.
- Validar a sintaxe de cada arquivo de mapa gerado (.map) contra o esquema MSL fornecido msl.xsd.
- Importe cada arquivo de mapeamento gerado em seu ambiente de desenvolvimento. Em seguida, verifique se todos os recursos referidos, como arquivos xsd, são importados para os tipos de projetos relevantes. Assegure que o construtor relevante seja chamado para validar semanticamente cada arquivo de mapeamento gerado. Confira também usando o editor de Mapeamento de Dados Gráficos que as transformas em seu mapa gerado estão corretas e livres de erros e avisos.
- Empacote e implemente no tempo de execução os mapas gerados programaticamente. Em seguida, teste seu aplicativo para confirmar se a transformação de mensagem está correta.
Verifique se cada arquivo de mapeamento gerado é construído no artefato de implementação relevante.
O que fazer em seguida
Implementar e testar o mapa de mensagens. Para obter mais informações, consulte Resolução de problemas de um mapa de mensagens..