Bei komplexen Zuordnungen können Sie benutzerdefinierte ESQL-Funktionen erstellen, die über den Nachrichtenzuordnungseditor aufgerufen werden können.
In diesem Abschnitt wird die Erstellung einer benutzerdefinierten ESQL-Funktion und deren Verwendung in einer bestehenden Nachrichtenzuordnung beschrieben.
- Erstellen Sie eine neue ESQL-Datei, oder öffnen Sie eine vorhandene ESQL-Datei.
- Geben Sie Ihre ESQL-Funktion in der ESQL-Datei ein. Der ESQL-Code darf keinesfalls in den bestehenden Modulen eingegeben werden.
- Speichern Sie die ESQL-Datei.
- Klicken Sie mit der rechten Maustaste auf den Zuordnungsknoten und klicken Sie auf Zuordnung öffnen, um Ihre Nachrichtenzuordnung im Nachrichtenzuordnungseditor zu öffnen.
- Wählen Sie aus der entsprechenden Tabelle mit Zielnachrichten oder -datenbanken das Ziel aus, das Sie mit Ihrer ESQL-Funktion generieren möchten.
- Geben Sie im Bearbeitungsfenster den Ausdruck für den Aufruf der ESQL-Funktion ein und alle Parameter, die an die Funktion übergeben werden sollen. Beispiel:
esql:concatValues($source/Pager/Text, ' Powered by IBM.')
Dabei steht
concatValues für den Namen der benutzerdefinierten ESQL-Funktion und die folgenden Parameter:
- $source/Pager/Text ist ein Feld in der Quellennachricht
- ' Powered by IBM.' steht für Text
Für die benutzerdefinierte ESQL-Funktion im vorherigen Beispiel wird der folgende ESQL-Code verwendet:
CREATE FUNCTION concatValues(IN val INTEGER, IN str CHAR) RETURNS CHAR
BEGIN
return str || ' plus int val ' || CAST(val AS CHAR);
END;
Benutzerdefinierte ESQL-Funktionen können auch über aufgerufen werden. Die benutzerdefinierten ESQL-Funktionen befinden sich am Ende der Liste mit ESQL-Funktionen.
- Speichern Sie die Nachrichtenzuordnungsdatei, indem Sie auf klicken.