Java-Funktionen von Funktionsbibliotheken verwenden 

Verwendung

Sie möchten innerhalb eines Message-Mappings oder einer Mapping-Vorlage Java-Funktionen einer Funktionsbibliothek verwenden. Da das Vorgehen für Message-Mappings und für Mapping-Vorlagen gleich ist, bezieht sich diese Vorgehensweise im folgenden nur noch auf Message-Mappings, auch wenn die Aussagen in gleicher Weise für Mapping-Vorlagen gelten.

Voraussetzungen

Die Funktionsbibliothek liegt in der gleichen oder einer unterliegenden Software-Komponentenversion wie das Message-Mapping, in dem Sie die Funktionen der Funktionsbibliothek verwenden wollen. Außerdem gibt es bereits eine entsprechende Funktionsbibliothek und ein entsprechendes Message-Mapping im Enterprise Services Repository.

Sie haben eine Ausgangs- und eine Zielstruktur in die Strukturübersicht des Mapping-Editors geladen.

Vorgehensweise

...

       1.      Die Tabelle zur Auswahl von Funktionsbibliotheken ist auf der linken Seite des Datenfluss-Editors. Falls sie dort noch nicht sichtbar ist, wählen Sie links Verwendete Funktionsbibliotheken anzeigen ().

       2.      Um eine Funktionsbibliothek in die Tabelle aufzunehmen, gehen Sie folgendermaßen vor:

                            a.      Fügen Sie zunächst eine neue Tabellenzeile hinzu.

                            b.      Wählen Sie entweder über die Eingabehilfe in der Spalte Funktionsbibliothek der neuen Zeile eine Funktionsbibliothek aus oder ziehen Sie eine Funktionsbibliothek aus dem Navigationsbaum des ES Builders per Drag & Drop dorthin.

                            c.      Tragen Sie pro Funktionsbibliothek einen Instanznamen ein. Auf diese Weise können Sie eine Funktionsbibliothek mehrfach in einem Message-Mapping verwenden, wenn Sie verschiedene Objektinstanzen von der zu der Funktionsbibliothek gehörenden Klasse benötigen.

       3.      Speichern Sie Ihre Änderungen.

Ergebnis

Die Funktionen der im Mapping-Editor eingetragenen Funktionsbibliothek erscheinen im Datenfluss-Editor (entweder in einer der Funktion zugewiesenen Standardfunktionskategorie oder in einer neuen Funktionskategorie, die in der Funktionsbibliothek neu eingeführt wurde). Der Titel der Funktion setzt sich folgendermaßen zusammen:

Funktionsnamen im Datenfluss-Editor

Funktionsbibliothek, in der die Funktion definiert ist	Funktionsname
lokale Funktionsbibliothek	local.<Titel der Funktion>
unabhängige Funktionsbibliothek	<Instanzenname>.<Titel der Funktion>

Wenn Sie mehrere Funktionsbibliotheken in einem Message-Mapping verwenden, gibt es mehrere Java-Bereiche Attribute und Methoden, sowie mehrere init()- und cleanUp()-Methoden. Die Mapping-Laufzeit führt diesen Quelltext am Anfang beziehungsweise am Ende des Message-Mappings in der Reihenfolge aus, in der Sie die zugehörigen Funktionsbibliotheken in der Tabelle zur Verwendung der Bibliotheken eingetragen haben. Siehe auch: Funktionsübersicht und Funktionseigenschaften.