Lookup-API in XSLT-Programmen nutzen 

Voraussetzungen

Beachten Sie die Voraussetzungen für den Adapter, den Sie für den Lookup nutzen wollen (siehe: Mapping-Programme um Lookups erweitern).

Vorgehensweise

Um ein XSLT-Programm um einen Lookup zu erweitern, müssen Sie es parametrisieren und die Lookup-API nutzen. Sowohl für den Zugriff auf Parameter als auch für die Verwendung der Mapping-API ist der Aufruf von Java-Methoden im XSLT-Programm notwendig. Um die Absprünge in die Java-Methoden zu minimieren, empfiehlt SAP den gesamten Mapping-Lookup in einer Java-Methode zu kapseln.

1. Parametrisiertes XSLT-Mapping-Programm implementieren

...

       1.      Um den Lookup ausführen zu können, benötigt Ihr XSLT-Mapping-Programm einen Importparameter für den zu verwendenden Adapter. Legen Sie ein solches XSLT-Mapping an (siehe Schritte 1 und 2 unter Parametrisierte XSLT-Mappings). Über den Importparameter übergibt das zugehörige Operation-Mapping zur Laufzeit die ID eines zum Adapter passenden Empfängerkanals (siehe Schritte 4 und 6).

       2.      Legen Sie ein Java-Mapping-Programm an, in dem Sie den Lookup implementieren. Die Methode, über die Sie den Lookup ausführen wollen, muss einen Parameter haben, um die ID des Empfängerkanals (siehe Schritt 1) vom XSLT-Programm zu übergeben. Ergänzen Sie die Signatur der Java-Methode außerdem um weitere Parameter, die für den Lookup und die Übergabe des Ergebnisses an das XSLT-Programm benötigt werden.

Siehe auch: XSLT Mapping mit Java-Erweiterung.

       3.      Implementieren Sie innerhalb der Java-Methode mit Hilfe der Lookup-API und dem Importparameter den Aufruf in das Anwendungssystem:

¡        Für Aufrufe über den JDBC-Adapter nutzen Sie die auf diesen Adapter zugeschnittene Lookup-API (siehe: Lookups über DataBaseAccessor implementieren).

¡        Für Aufrufe über andere Adapter nutzen Sie die generische Lookup-API (siehe: Lookups über SystemAccesor implementieren).

       4.      Um diesem Importparameter später einen Empfängerkanal zuweisen zu können, müssen Sie diesen Importparameter über ein Binding einem Operation-Mapping-Parameter zuweisen (siehe Schritte 3 bis 7 unter Parametrisierte XSLT-Mappings).

Um das Mapping-Programm und den Mapping-Lookup ausführen oder testen zu können, sind die folgenden Schritte im Integration Directory notwendig:

2. Empfängerkanal für Mapping-Lookup konfigurieren

       5.      Legen Sie den Empfängerkanal für den Aufruf des Anwendungssystems im Integration Directory an (siehe: Kommunikationskanal).

       6.      Um die ID des Empfängerkanals zur Laufzeit an Ihr XSLT-Mapping-Programm zu übergeben, legen Sie eine Interface-Ermittlung an, dem Sie das Operation-Mapping aus Schritt 4 (siehe oben) zuweisen (siehe Schritt 6 in Interface-Ermittlung definieren).

Der Mapping-Lookup kann nur ausgeführt werden, wenn diese Schritte durchgeführt worden sind und die Laufzeitkomponenten des Integration Servers installiert sind. Ansonsten bricht das gesamte XSLT-Mapping-Programm mit einer Fehlermeldung ab.

Ergebnis

Sie haben einen Lookup in Ihrem XSLT-Mapping-Programm über eine Java-Erweiterung implementiert und im Integration Directory konfiguriert. Sie können das XSLT-Mapping-Programm nun über das Operation-Mapping testen (siehe: Testumgebung für Operation-Mappings).