Vordefinierte Zuordnungsfunktionen

Es werden einige vordefinierte Zuordnungsfunktionen für die Verwendung bei Nachrichtenzuordnungen bereitgestellt.

Die folgende Tabelle enthält Details zu den vordefinierten Zuordnungsfunktionen, die mit Nachrichtenzuordnungen verwendet werden können.
Name Parameter Rückgabe Hinweise
cdata-element Eine Zeichenfolge - Erstellt ein XML-Element mit CData-Inhalt in den folgenden Zielnachrichtdomänen:
  • XMLNSC
  • SOAP
  • XMLNS
  • XML
  • JMSMap
  • JMSStream
Beispiel:
msgmap:cdata-element('<date><month>05
</month><day>11</day><year>2008</year></date>')
db-path Die folgenden Signaturen werden unterstützt:

msgmap:db-path(Datenbankpfad)

msgmap:db-path(Datenbankpfad, Begrenzer)

- Wird verwendet, wenn der Datenbankpfad nicht dem XML-Format "NCName" (Name ohne Doppelpunkte) entspricht. Ein solcher Datenbankpfad enthält beispielsweise Zeichen wie '#' oder '$'.

Datenbankpfad ist ein Verweis auf eine $db:select-, $db:insert-, $db:update-, $db:delete-, $db:proc- oder $db:func-Anweisung.

Begrenzer ist ein Zeichenfolgeliteral, das zwischen den Segmenten eines Datenbankpfades verwendet wird. Begrenzer hat den Standardwert '.'.

Beispiel:
msgmap:db-path(“$db:select.DB#1.SCH$#1.CustInfo.Name”)
In diesem Fall wird der Standardwert '.' als Begrenzer verwendet.
msgmap:db-path(“$db:select/DB#1/SCH$#1/
Cust.Info/Name”, “/”)
In diesem Fall wird hingegen der Wert '/' als Begrenzer verwendet, weil der Standardwert ('.') bereits im Datenbanktabellennamen vorkommt.
occurrence Quellenfeld aus der Nachricht oder Datenbank Der Index des Quellenfeldes. Wird oft in Bedingungsanweisungen verwendet, wenn die Quelle wiederholt bestimmte Anweisungen für ein bestimmtes Element ausführt. Beispiel:
msgmap:occurrence
($source/po:purchaseOrder
/items)=2
bedeutet, dass das zweite Feld,
po:purchaseOrder
, verarbeitet wird. Verwenden Sie ähnlichen Code wie im vorherigen Beispiel, wenn Sie ein bestimmtes Quellenvorkommen angeben möchten. Wenn Sie nur den Indexwert einem Ziel zuordnen möchten, können Sie folgenden Code angeben:
msgmap:occurrence
($source/po:purchaseOrder
/items)
exact-type

1- Quellenfeld aus der Nachricht oder Datenbank
2- Namespacepräfix
3- Name des Typs

Ist wahr, wenn die Quelle dem angegebenen Typ im angegebenen Namespace entspricht. Wird oft in Bedingungsanweisungen verwendet, um bestimmte Anweisungen für einen bestimmten Quellentyp auszuführen. Beispiel:
msgmap:exact-type
($source/tn1:msg2,'tn1',
'extendedMsgType')
Zu den möglichen Namespacepräfixen gehört unter anderem '*', der angibt, dass nur der Name des Typs überprüft werden soll. Beispiel:
msgmap:exact-type($source/tn1:msg2,'*',
'extendedMsgType')
gibt 'true' (wahr) aus, wenn das Element
$source/tn1:msg2
einen Typ
extendedMsgType
in einem Namensbereich hat.
empty-element() - - Erstellt ein XML-Element mit einer leeren Kennung. Wenn ein Element z. B. die Bezeichnung 'MyElement' hat und für den Zuordnungsausdruck von 'MyElement' 'msgmap:empty-element()' festgelegt ist, enthält die Ausgabenachricht ein Element ohne Inhalt:
<MyElement/>
Rufen Sie diese Funktion nur für ein XML-Element auf.
element-from-bitstream Die folgenden Signaturen werden unterstützt:

msgmap:element-from-bitstream(Datenstromverweis)

msgmap:element-from-bitstream(Datenstromverweis, Typausdruck,
   Gruppenausdruck, Formatausdruck)

msgmap:element-from-bitstream(Datenstromverweis, Typausdruck,
   Gruppenausdruck, Formatausdruck, Codierungsausdruck, CCSID-Ausdruck)

msgmap:element-from-bitstream(Datenstromverweis, Typausdruck,
   Gruppenausdruck, Formatausdruck, Codierungsausdruck, CCSID-Ausdruck, Optionen)

-

Wird zum Parsen eines Bitstroms verwendet. Diese Funktion kann nur für das Ziel eines Nachrichtenelements aufgerufen werden. Der analysierte Bitstrom wird als Zielelement in der Zielnachrichtenbaumstruktur gespeichert.

Datenstromverweis ist ein Verweis auf das große Binärobjekt (BLOB) eines Datenstroms, z. B. '$source/BLOB' oder '$db:select.dsn.schema.table.column'

Typausdruck ist ein Zeichenfolgeliteral für den Namen des Nachrichtenhauptteils, z. B. 'purchaseOrder'; optional ist er mit einer Namespace-URI qualifiziert, z. B. '{http://www.ibm.com}:purchaseOrder'

Gruppenausdruck ist ein Zeichenfolgeliteral für den Namen der Nachrichtengruppe, z. B. 'PurchaseOrder'

Formatausdruck ist ein Zeichenfolgeliteral des physischen Formats der Nachricht, z. B. 'XML1'

Codierungsausdruck und CCSID-Ausdruck ergeben ganze Zahlen mit Werten, die den Konstanten ESQL ENCODING und CCSID entsprechen.

Optionen ist eine ESQL-Konstante oder die bit-or-Funktion von ESQL-Konstanten, die eine ganze Zahl ergeben.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

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

        
        Letzte Aktualisierung
        
        Letzte Aktualisierung : 2012-08-06 17:58:25


ReferenzthemaReferenzthema | Version 7.0.0.5 | ar25650_