Global Context Manipulation

Dieser Adapter bietet die Möglichkeit, ähnlich wie bei Prozess-Variablen beliebige Dokumente aus einem Technical Process in einer globalen Hashtabelle zwischenzuspeichern, sodass auch von anderen Prozessen auf diesen Kontext zugegriffen werden kann, siehe Handbuch X4 Designer – Variablen-Baustein.

Die im globalen Kontext abgelegten Dokumente werden unter einem Schlüssel gespeichert und sind über die gesamte Laufzeit des X4 Servers verfügbar. Der Funktions-Adapter kann Einträge in der Hash-Tabelle erstellen, überschreiben und löschen sowie alle oder ausgewählte Schlüssel der Hashtabellen-Einträge auflisten.

Da ein Kontext X4 Server-weit gilt und alle Technical Processes auf dieselbe Hashtabelle zugreifen, ist es möglich, dass andere Threads parallel ein Dokument unter demselben Schlüssel einstellen. Zudem können geringe Zeitdifferenzen zwischen den Operationen Put und PutGet uneindeutige (z. B. leere) Ergebnisse liefern.

Innerhalb von XSL-Mappings können Sie über das globalcontext:-URL-Protokoll zur Laufzeit auf bereits definierte Kontextschlüssel zugreifen, siehe X4 Developer Guide – globalcontext:-URL-Protokoll.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte:

Get: Eintrag, dessen Schlüssel in Parameter Key festgelegt wurde, aus dem globalen Kontext auslesen und das zuletzt vollständig gespeicherte Dokument ausgeben
Put: Input-Dokument mit dem in Parameter Key festgelegten Schlüssel im globalen Kontext speichern und liefert den gesetzten Eintrag zurück
PutGet: Input-Dokument mit einem Schlüssel im globalen Kontext speichern und das zuletzt vollständig gespeicherte Dokument ausgeben (dass das aktuellste Dokument ausgegeben wird, kann nicht garantiert werden!)
Remove: Eintrag, dessen Schlüssel in Parameter Key festgelegt wurde, aus dem Globalen Kontext löschen und gibt den gelöschten Eintrag zurück
List: Alle Schlüssel des globalen Kontexts in einem XML-Dokument ausgeben
RemoveAllMatching: Alle Einträge des globalen Kontexts löschen, deren Schlüssel dem Regex-Filterausdruck in Parameter Filter entsprechen
KeepAllMatching: Nur Einträge des globalen Kontexts behalten, deren Schlüssel dem Regex-Filterausdruck in Parameter Filter entsprechen (alle anderen Einträge löschen)
ListAllMatchingKeys: Alle Schlüssel des globalen Kontexts, die dem Regex-Filterausdruck in Parameter Filter entsprechen, in einem XML-Dokument ausgeben
ListAllNotMatchingKeys: Nur Schlüssel des globalen Kontexts, die nicht dem Regex-Filterausdruck in Parameter Filter entsprechen, in einem XML-Dokument ausgeben

Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte: de.softproject.integration.adapter. globalcontext.GlobalContextAdapter: Hauptklasse (Standard)

Key

Schlüssel, unter dem ein Eintrag im globalen Kontext gespeichert ist

Mögliche Werte: Beliebige Zeichenkette

Filter

Regulärer Ausdruck (Regex), um nach Schlüsseln im globalen Kontext zu filtern, gemäß java.util.Pattern, siehe http://java.sun.com/j2se/1.5.0/docs/api/java/util/regex/Pattern.html

Mögliche Werte: Beliebiger Regulärer Ausdruck (z.B. .*Test.*)

Statuswerte

1	Die Operation wurde erfolgreich ausgeführt.
0	Die Operation wurde erfolgreich ausgeführt, das Ergebnis ist jedoch Null oder eine leere Liste.
-1	Der Adapter konnte nicht ausgeführt werden.