Kurzbeschreibung
Die JSAction erlaubt das Ausführen beliebigen JavaScript Codes auf eine einlaufende Nachricht. Der JavaScript Code wird dabei dynamisch aus einer Extension geladen. Die Nutzung dieser Action setzt voraus, dass ein Interpreter für JavaScript auf dem System verfügbar ist und der Java-Laufzeitumgebung bekannt gemacht wurde.
Dem Skript werden zwei Variablen zur Laufzeit übergeben. Die Änderungen, die in derJavaScript Umgebung an diesen Objekten durchgeführt werden, werden am Skript-Ende an die B2B weitergegeben.
- messageContext
Der Nachrichtenkontext vom Typ org.b2bbp.configuration.vo.MessageContext - actionContext
Der ActionContext vom Typ org.b2bbp.engine.persistence.vo.ActionRegistryInstance
Bei der Problemen mit dem vom Benutzer hinterlegten JavaScript Code kann leider kein Support geleistet werden.
Einrichtung
Die JSAction wird als Java-Action eingerichtet (sieheActions Anlegen). Dabei müssen die folgenden Einstellungen der Action vorgenommen werden.
- Klasse
org.b2bbp.runtime.actions.managed.JSAction - Typ
JAVA
Alle weiteren Einstellungen der Action, die nach Erstellen der Action gesetzt werden, finden sich in den nachstehenden Tabellen.
ActionEigenschaften (Erforderlich)
Hier genannte Eigenschaften müssen konfiguriert werden. Sonst wird bei der Ausführung der Action ein Fehler generiert.
| Name der Eigenschaft | erlaubte Werte | Beschreibung |
|---|---|---|
| B3P_EXTENSION_PROVIDER | Zeichenkette der Länge 1..100 | Die Einstellung gibt den Provider an, der in der Administrationsansicht unter dem Reiter ‘Extension’ das verwendete Skript identifiziert. |
| B3P_EXTENSION_TYPE | Zeichenkette der Länge 1..100 | Die Einstellung gibt den Typ an, der in der Administrationsansicht unter dem Reiter ‘Extension’ das verwendete Skript identifiziert. |
ActionEigenschaften (Optional)
Hier aufgeführte Eigenschaften werden automatisch beim ersten Ausführen der Action mit den Standardeinstellungen initialisiert, falls sie nicht vom Benutzer gesetzt wurden.
| Name der Eigenschaft | erlaubte Werte | Beschreibung |
| B3P_EXTENSION_VERSION | Zeichenkette der Länge 0..100 | Die Einstellung gibt die Version an, die in der Administrationsansicht unter dem Reiter 'Extension' das verwendete Skript identifiziert. |
| B3P_CHECKSUM | Base64 kodierte Prüfsumme der Extension der Länge 0..100 | Hier wird eine Prüfsumme der Extension hinterlegt, um zu verhindern, dass das Skript nach einer unbeabsichtigten Veränderung ausgeführt wird. Stimmt die Prüfsumme des Skriptes nicht mit der hier hinterlegten Prüfsumme überein, wird eine Fehlermeldung generiert, in der auch die neue Prüfsumme enthalten ist. |
| B3P_PARAMETERS | Durch Semikolon getrennte Liste von Schlüssel-Wert-Paaren der Länge 1..1000. Beispiel: "schluessel1=wert1;schluessel2=wert2". Die reservierten Zeichen ';', '=' und '\' müssen mit einem zusätzlichen Backslash ('\') als Präfix versehen werden, falls sie in einem Schlüsselnamen oder einem Wert vorkommen. |
Diese Eigenschaft enthält Parameternamen und Werte für Parameter des aufgerufenen XSL Skriptes.Velocity Template-Ausdrücke sind erlaubt. |
| B3P_MESSAGE_DIGEST | Ein der Java-Umgebung bekannter Prüfsummenalgorithmus, z.B. 'sha-1', 'md5', 'md2' (default: 'md5') | Die Eigenschaft enthält einen in der Java-Umgebung definierten Prüfsummenalgorithmus. Ist die Eigenschaft leer gelassen, wird die Prüfung des Skriptes umgangen (nicht empfohlen). |