XSLT-Mapping
Die Schnittstellenbeschreibungen liegen als XML-Dokumente vor. XSL Transformation (XSLT) ist eine Sprache der XML-Familie. Sie beschreibt, wie eine XML-Struktur in eine andere transformiert wird.
Empfehlung zur Verwendung von SAP XML Toolkit und JDK
XSLT-Programme wurden vor SAP NetWeaver Process Integration (PI) 7.1 mit Hilfe des SAP XML Toolkit ausgeführt. Das SAP XML Toolkit wird unterstützt von SAP NetWeaver PI 7.1 sowie von höheren Releases.
Neuen Kunden wird jedoch empfohlen das Java Development Kit (JDK) für alle neuen XSLT-Mapping-Programme zu verwenden, sowie alle vorhandenden XSLT-Programme mit dem JDK zu testen und entsprechend anzupassen. Informieren Sie sich über die neueste Version.
Im Vergleich zum SAP XML Toolkit bietet das JDK folgende Vorteile:
XSLT-Programme werden schneller ausgeführt.
Die Fehlerbehandlung ist eleganter.
Der Funktionsumfang ist größer.
Wenn Sie SAP NetWeaver 7.3 installiert haben, empfehlen wir Ihnen JDK 6. Die gilt auch für Enhancement Package 1 für SAP NetWeaver 7.3.
Um das JDK als Laufzeit für XSLT-Mapping-Programme zu verwenden, wählen Sie in dem Operation-Mapping, von dem Sie auf die XSLT-Mapping-Programme verweisen, nichtVerwende SAP XML Toolkit aus.
XPath und <xsl:include>
Sie können mit XSLT in Verbindung mit XPath-Mappings definieren. XPath ist ebenfalls eine Spezifikation der XML-Familie. Mittels XPath können Sie einen beliebigen Knoten im XML-Dokument adressieren. XSLT setzt XPath-Ausdrücke ein, um Teilstrukturen eines XML-Dokuments zu selektieren. Mit sogenannten Templates in XSLT definieren Sie die Abbildungsvorschriften für die ausgewählten Teilstrukturen.
Sie können die XSLT-Tags <xsl:include> und <xsl:import> verwenden, um vordefinierte Templates für Teilstrukturen in eine gesamte Mapping-Definition einzubeziehen. Damit können Sie Mappings für Datentypen wiederverwenden.
Laufzeit-Konstanten
Wie bei Java-Mappings liefert Ihnen auch die Mapping-Laufzeit bei XSLT-Programmen Parameter, mit denen Sie erst zur Laufzeit bekannte Informationen im XSLT-Programm auswerten können:
Konstanten der Mapping-Laufzeit
Konstante |
Bedeutung |
Relevant für PCK |
$MessageClass |
Klassifizierung der Message. Mögliche Werte:
|
Ja |
$VersionMajor |
Version des XI Message-Protokolls. Beispiel: Für das XI 3.0 Message-Protokoll ist VERSION_MAJOR = 3 und VERSION_MINOR = 0. |
Nein Das PCK verwendet nur das Message-Protokoll XI 3.0 |
$VersionMinor |
|
Nein |
$ProcessingMode |
Der Modus einer Message kann synchron oder asynchron sein. Entsprechend kann diese Konstante den Wert synchronous oder asynchronous haben. |
Ja |
$MessageId |
Die Message-ID. Sie kann sich während der Kommunikation verändern.
|
Ja |
$RefToMessageId |
ID einer referenzierten Message, die semantisch zu dieser Message gehört. Beispielsweise merkt sich eine Response-Message über dieses Feld zu welcher Request-Message sie gehört. |
Ja |
$ConversationId |
Dieses Feld ist nicht obligatorisch in der Message enthalten. Es ermöglicht die Verwendung einer ID zur Gruppierung von zusammengehörenden Messages. Dieses Feld ist nicht dazu gedacht eine Serialisierung von Messages zu realisieren und hat nichts mit dem Serialisierungskontext ( ABAP -Proxy-Laufzeit, Java -Proxy-Laufzeit) zu tun. |
Ja |
$TimeSent |
Zeitstempel, der angibt, wann die Message beim Sender abgeschickt wurde. Das Format des Zeitstempels ist: YYYY-MM-DDTHH:MM:SSZ Der Buchstabe T trennt das Datum von der Zeit, die in der Regel in UTC angegeben ist. Falls es sich um eine lokale Zeit handelt, entfällt das abschließende Z. |
Ja |
$Interface |
Name des Sender-Interface. Verwenden Sie ab SAP XI 3.0 diese Konstante anstelle der bisherigen Konstante SENDER_NAME . |
Ja |
$InterfaceNamespace |
Namensraum des Sender-Interface. Verwenden Sie ab SAP XI 3.0 diese Konstante anstelle der bisherigen Konstante SENDER_NAMESPACE . |
Ja |
$SenderParty |
Kommunikationspartner , der die Message verschickt hat |
Ja Siehe auch: Kommunikationspartner |
$SenderPartyAgency |
Vergebende Agentur für den Sender der Message |
Ja |
$SenderPartyScheme |
Verwendetes Identifikationsschema des Senders |
Ja |
$SenderService |
Service auf Senderseite, der die Message verschickt hat. Beispielsweise der Name eines Business-Systems. Verwenden Sie ab SAP XI 3.0 diese Konstante anstelle der bisherigen Konstante SENDER_SYSTEM . |
Ja Siehe auch: Service |
$ReceiverName |
Name des Empfänger-Interface. |
Ja |
$ReceiverNamespace |
Namensraum des Empfänger-Interface. |
Ja |
$ReceiverParty |
Kommunikationspartner , der die Message empfangen soll |
Ja Siehe auch: Kommunikationspartner |
$ReceiverPartyAgency |
Vergebende Agentur für den Empfänger der Message |
Ja |
$ReceiverPartyScheme |
Verwendetes Identifikationsschema des Empfängers |
Ja |
$ReceiverService |
Service auf Empfängerseite, der die Message empfangen soll. Beispielsweise der Name eines Business-Systems. Verwenden Sie ab SAP XI 3.0 diese Konstante anstelle der bisherigen Konstante RECEIVER_SYSTEM . |
Ja Siehe auch: Service |
$MappingTrace |
Gibt ein AbstractTrace-Objekt zurück, mit dem Sie im Mapping-Programm Meldungen in das Monitoring schreiben können. |
Nein |
Wenn Sie auf eine der Konstanten im XSLT-Programm zugreifen wollen, müssen Sie die Konstante vorher als Parameter deklarieren, zum Beispiel:
<xsl:param name="MessageId" />
Java-Erweiterungen
Außerdem ist es möglich, von einer XSLT-Definition aus externe Java-Methoden zum Konvertieren von XML-Strukturen aufzurufen. Diese Vorgehensweise gibt Ihnen mehr Flexibilität für die Definition von Mappings. Sie erfahren später mehr über das XSLT-Mapping mit Java-Erweiterung .
Weitere Informationen zu XSL/XSLT und XPath finden Sie auf der Web-Site http://www.w3c.org/
.
Die Funktion zur Flugbuchung enthält einen Parameter für die Flugklasse. Das Outbound-Interface stellt Flugklassen als symbolische Werte dar, während sie im Inbound-Interface numerische Werte haben. Der XSLT-Abschnitt wandelt die symbolische Darstellung vom Quellsystem in die numerische des Zielsystems um.
Der XPath-Ausdruck match="//hh:class" wählt den Knoten <hh:class> im Outbound-Interface aus. Die XSLT-Anweisung < xsl:choose > definiert schließlich die Mapping-Regel, wie die Laufzeit der Process Integration die symbolischen Werte im Quellsystem in numerische Werte des Zielsystems konvertiert.
