Lookup-API in Message-Mappings nutzen 

Verwendung

Sie können die Mapping-Lookup-API in einer benutzerdefinierten Funktion eines Message-Mappings verwenden und so die generische Lookup-API (Klasse SystemAccessor) oder die spezielle API für Datenbankaufrufe (DataBaseAccessor) nutzen. Im letzteren Fall ist für einfache SELECT-Aufrufe auch die Standardfunktion für die grafische Definition von JDBC-Lookups ausreichend (siehe: JDBC-Lookups graphisch definieren).

Voraussetzungen

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

Sie haben bereits ein Message-Mapping angelegt und befinden sich im Mapping-Editor.

Vorgehensweise

1. Parametrisiertes Message-Mapping-Programm implementieren

...

       1.      Um den Lookup ausführen zu können, benötigt Ihre benutzerdefinierte Funktion einen Importfunktionsparameter vom Typ Adapter, der einem Message-Mapping-Parameter zugeordnet ist (siehe Schritte 1 bis 3 unter Importparameter definieren und verwenden).

       2.      Implementieren Sie mit Hilfe der Lookup-API und dem Importparameter den Aufruf in das Anwendungssystem:

¡        Wenn der Funktionsumfang der Standardfunktion für grafische JDBC-Lookups (siehe oben) für Ihre Anwendung nicht ausreichend ist, nutzen Sie die auf den JDBC-Adapter zugeschnittene Lookup-API (siehe: Lookups über DataBaseAccessor implementieren).

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

       3.      Um dem Message-Mapping-Parameter, dem Sie in Schritt 1 den Importfunktionsparameter zugewiesen haben, später einen Empfängerkanal zuweisen zu können, müssen Sie diesen Importparameter über ein Binding einem Operation-Mapping-Parameter zuweisen (siehe Schritte 4 bis 8 unter Importparameter definieren und verwenden).

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

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

       5.      Um die ID des Empfängerkanals zur Laufzeit an Ihr Message-Mapping-Programm zu übergeben, legen Sie eine Interface-Ermittlung an, dem Sie das Operation-Mapping aus Schritt 3 (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 Message-Mapping-Programm mit einer Fehlermeldung ab.

Ergebnis

Sie haben einen Lookup in einer benutzerdefinierten Funktion Ihres Message-Mapping-Programms implementiert und im Integration Directory konfiguriert. Sie können das Message-Mapping-Programm nun über das Operation-Mapping testen (siehe: Testumgebung für Operation-Mappings).