Ao converter um mapa de mensagem de uma versão anterior do
IBM® Integration Bus para um
mapa de dados gráficos, você poderá precisar concluir
tarefas adicionais para poder usar o
mapa de dados gráficos em uma solução de sistema de
mensagens.
Os pontos a seguir devem ser considerados quando você estiver preparando para converter um mapa de mensagem em um mapa de dados gráficos:
- O mapa de dados gráficos é executado na
Java™ virtual machine
do broker. Assegure que o broker seja configurado corretamente; consulte Configurando o Tamanho de Heap da JVM.
- As transformações de banco de dados em um mapa de dados gráficos usam suporte para conexões JDBC construídas no IBM Integration Bus.
A conversão de operações do banco de dados relacional do mapa de mensagem em transformações de mapeamento de dados gráficos requer ação adicional no Editor de Mapeamento de Dados Gráficos. Para informações adicionais, consulte Mapeando Conteúdo do Banco de Dados.
- Mapas de dados gráficos podem ser implementados somente como origem. Para implementar um
mapa de dados gráficos:
- Forneça um esquema de modelo de mensagem para suas mensagens de entrada e saída.
Para mensagens XML, um arquivo de esquema XML deve ser fornecido. Para mensagens de texto e binárias, o modelo pode ser fornecido usando um arquivo de esquema DFDL ou um conjunto de mensagens.
- Se sua mensagem for modelada em um conjunto de mensagens, o
mapa de dados gráficos exigirá que o esquema de
conjunto de mensagens (arquivo .xsdzip) seja implementado para executar seu
mapa de dados gráficos. Se o seu conjunto de mensagens
existente for utilizado apenas em formatos de texto e binário, será possível implementar
o mapa de dados gráficos com apenas um arquivo
.dictionary no broker archive (BAR). Nesse caso, você deve modificar
o conjunto de mensagens para configurar adicionalmente a opção de suporte ao domínio
XMLNSC, de modo que ela seja incluída em um BAR com um arquivo
.dictionary e um arquivo .xsdzip. Se essa opção
não for configurada, um aviso será exibido na visualização
Problemas, com uma ação de correção rápida.
- Quando um mapa de mensagem convertido incluir chamadas para procedimentos SQL fornecidos pelo usuário, eles são convertidos para transformações de ESQL Customizada. Para mapas de dados gráficos para chamar o procedimento ESQL, determinados requisitos devem ser atendidos.
Para informações adicionais, consulte ESQL customizado. Os aspectos a seguir devem ser considerados:
- Os módulos ESQL são implementados como origem. Consulte Incluindo Arquivos em um Broker Archive.
- Se você não estiver usando recursos de aplicativo e biblioteca do
IBM Integration Bus, os procedimentos ESQL deverão ser denominados
de forma exclusiva, pois são implementados no servidor
de integração.
- Chamadas aos procedimento ESQL que usam o tipo de dados ESQL REFERENCE são substituídas por transformações Tarefa no mapa de dados gráficos convertido. Você
deve substituir cada uma dessas transformações Tarefa por uma transformação XPath
Customizado, Java Customizado ou ESQL Customizado que forneça função equivalente.
- Quando um mapa de mensagem convertido inclui chamadas a funções do mapa de mensagem predefinido (msgmap:), cada uma dessas transformações é convertida em uma transformação
XPath ou Customizar XPath. Essas transformações de substituição devem ser revisadas para assegurar que recriam o comportamento necessário. Se não houver nenhum XPath equivalente de uma função de mapa de mensagem, será substituído por uma transformação Tarefa em seu mapa de dados gráficos.
Você deve substituir cada uma dessas transformações Tarefa por uma transformação XPath
Customizado, Java Customizado ou ESQL Customizado
que recrie o comportamento necessário.
As funções do mapa de mensagem a seguir não têm nenhum equivalente a XPath:
- msgmap:element-from-bitstream
- msgmap:cdata-element
- msgmap:db-path
- É possível usar uma transformação Cast e funções de Esquema XML em transformações
XPath Customizado para executar cast de tipo de valor. Para obter informações adicionais, consulte o Cast e o Tipos ESQL e Tipos de Esquema.
- Ao converter um mapa de mensagem para uma transformação que inclui a manipulação de
elementos ausentes, vazios ou zerados, consulte Manipulando valores nulos. As
funções XPath a seguir são fornecidas para que você implemente essas transformações:
- fn:empty testa se um elemento tem um valor vazio.
- fn:nilled testa se um elemento XML tem o atributo xsi:nil configurado.
- fn:exists testa se um elemento está presente. Um elemento XML que tem o atributo
xsi:nil configurado é considerado como estando presente.
- Quando um mapa de mensagem convertido inclui chamadas a funções do mapa de ESQL predefinido
(esql:), cada uma dessas chamadas é convertida em uma transformação
XPath ou Customizar XPath. Essas transformações de substituição devem ser revisadas para assegurar que recriam o comportamento necessário. Se não houver nenhum XPath equivalente de uma função de mapa de ESQL, será substituído por uma transformação Tarefa em seu mapa de dados gráficos.
Você deve substituir cada uma dessas transformações Tarefa por uma transformação XPath
Customizado, Java Customizado ou ESQL Customizado
que recrie o comportamento necessário.
As funções do mapa de ESQL a seguir não têm nenhum equivalente a XPath:
- Determinadas funções matemáticas:
- ACOS
- ASIN
- ATAN
- ATAN2
- BITAND
- BITNOT
- BITOR
- BITXOR
- COS
- COSH
- COT
- DEGREES
- EXP
- LN
- LOG
- LOG10
- MOD
- POWER
- RADIANS
- RAND
- SIGN
- SIN
- SINH
- SQRT
- TAN
- TANH
- Função decimal
- Determinadas funções de sequência de caracteres:
- LTRIM
- RTRIM
- TRIM-LEADING
- TRIM-TRAILING
- REPLICATE
- SPACE
- Determinadas funções de campo:
- ABITSTREAM
- BITSTREAM
- SAMEFIELD
- Determinadas funções de sequência de data e hora:
- TIMESTAMP
- CURRENT-GMTDATE
- CURRENT-GMTTIME
- CURRENT-GMTTIMESTAMP
- Todas as funções INTERVAL-
- A função ESQL LIKE
- O formato ESQL FOLLOWING da função ESQL POSITION
- Todas as funções SQL
- As funções UUIDASCHAR e UUIDASBLOB