Funções de Mapeamento Predefinidas

Algumas funções de mapeamento predefinidas são fornecidas para uso com mapas de mensagem.

Esta tabela detalha as funções de mapeamento predefinidas que estão disponíveis para uso com mapas de mensagem.
Nome Parâmetros Return Notas
cdata-element Uma cadeia Nada Crie um elemento XML com conteúdo CData nos seguintes domínios da mensagem de destino:
  • XMLNSC
  • SOAP
  • XMLNS
  • XML
  • JMSMap
  • JMSStream
Por Exemplo:
msgmap:cdata-element('<date><month>05
</month><day>11</day><year>2008</year></date>')
db-path Estas assinaturas são suportadas:

msgmap:db-path(databasePath)

msgmap:db-path(databasePath, delimiter)

Nada Usado quando o caminho do banco de dados não está em conformidade com o formato NCName XML. Por exemplo, o caminho do banco de dados contém caracteres como '#' ou '$'.

databasePath é uma referência a uma instrução $db:select, uma instrução $db:insert, uma instrução $db:update, uma instrução $db:delete, uma instrução $db:proc ou uma instrução $db:func.

delimiter é uma cadeia literal usada entre os segmentos no caminho do banco de dados. delimiter tem um valor-padrão de '.'.

Por Exemplo:
msgmap:db-path(“$db:select.DB#1.SCH$#1.
CustInfo.Name”)
Neste caso, o valor-padrão, '.', é usado como o delimitador.
msgmap:db-path(“$db:select/DB#1/SCH$#1/
Cust.Info/Name”, “/”)
Neste caso, '/' é usado como o delimitador, porque o nome da tabela de banco de dados inclui o valor-padrão.
occurrence Campo de origem da mensagem ou banco de dados O índice do campo origem. Geralmente utilizado em uma instrução de condição quando a origem se repete para executar instruções específicas para uma ocorrência específica. Por Exemplo:
msgmap:occurrence
($source/po:purchaseOrder
/items)=2
significa que o segundo campo,
po:purchaseOrder
está sendo processado. Utilize um código semelhante ao exemplo anterior se desejar especificar uma determinada ocorrência de origem. Se você deseja apenas determinar o valor do índice para um destino, pode especificar o seguinte código:
msgmap:occurrence
($source/po:purchaseOrder
/items)
exact-type

1- Campo de origem da
    mensagem ou banco de dados
2- Prefixo de espaço de nomes
3- Nome do tipo

True se a origem for do tipo especificado no espaço de nomes especificado. Geralmente utilizado em uma condição para executar instruções específicas para um tipo de origem específico. Por Exemplo:
msgmap:exact-type
($source/tn1:msg2,'tn1',
'extendedMsgType')
O prefixo de espaço de nomes pode ser '*', que indica que apenas o nome do tipo deve ser verificado. Por exemplo:
msgmap:exact-type($source/tn1:msg2,'*',
'extendedMsgType')
retorna true se o elemento
$source/tn1:msg2
tiver um tipo
extendedMsgType
em qualquer espaço de nomes.
empty-element() Nenhuma Nada Cria um elemento XML com uma tag vazia. Por exemplo, se um elemento for denominado MyElement e a expressão de mapeamento para MyElement estiver configurada como msgmap:empty-element(), a mensagem de saída conterá um elemento sem conteúdo:
<MyElement/>
Chame esta função apenas para um elemento XML.
element-from-bitstream Estas assinaturas são suportadas:

msgmap:element-from-bitstream(StreamRef)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp, encodingExp, ccsidExp)

msgmap:element-from-bitstream(StreamRef, typeExp,
   setExp, formatExp, encodingExp, ccsidExp, options)

Nada

Usado para analisar um fluxo de bits. Esta função pode ser chamada apenas para um destino do elemento de mensagem. O fluxo de bits analisado é colocado na árvore de mensagens de destino como o elemento de destino.

StreamRef é uma referência a um BLOB de fluxo, como $source/BLOB or $db:select.dsn.schema.table.column

typeExp é uma cadeia literal do nome do corpo da mensagem, tal como purchaseOrder, opcionalmente qualificado com uma URI de espaço de nomes, tal como {http://www.ibm.com}:purchaseOrder

setExp é uma cadeia literal do nome do conjunto de mensagens, tal como PurchaseOrder

formatExp é uma cadeia literal do formato de ligação da mensagem, tal como XML1

encodingExp e ccsidExp são avaliados como inteiros com valores correspondentes às constantes ESQL ENCODING e CCSID

options é uma constante ESQL ou uma operação binária OU de constantes ESQL que são avaliadas como um inteiro.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-08-02 07:49:20


Tópico de ReferênciaTópico de Referência | Versão 7.0.0.5 | ar25650_