Variable | X4Documentation

Eine Variable speichert temporär Daten, während ein Technical Process (*.wrf) ausgeführt wird. Innerhalb desselben Technical Processes oder eines Subprozesses können Sie die Variable auslesen. Mithilfe des context:-Protokolls können Sie auch in XSL-Mappings auf solche Variablen zugreifen.

Eigenschaften

Operation

Bestimmt, ob die Variable initialisiert, verwendet oder verworfen werden soll

Mögliche Werte:

Put: Daten aus dem vorangegangenen Prozessschritt in der Variable speichern (Standard)
Get: Variableninhalt lesen und an den nächsten Prozessschritt weitergeben
Remove: Variable verwerfen (aus dem Arbeitsspeicher löschen). Ist keine Variable gesetzt, wird der Status 0 ausgegeben.
Test: Prüfen, ob eine Variable vorhanden ist. Ist keine Variable gesetzt, wird der Status 0 ausgegeben.

Name

Eindeutige Bezeichnung der Variable

Mögliche Werte:

Zeichenkette, die aus alphanumerischen US-ASCII-Zeichen (Aa–Zz und 0–9) sowie aus Unterstrichen (_) bestehen darf und nicht mit einer Ziffer beginnt (z. B. Report_Data01)

Variablen verwenden

In Variablen lassen sich Daten im Kontext eines aktuell ausgeführten Technical Processes zwischenspeichern. Jede Variable muss zunächst initialisiert werden, also einen eindeutigen Namen erhalten und mit einem Wert belegt werden (Put-Operation). In späteren Prozessschritten kann dann per Get-Operation auf die Variable zugegriffen werden. Schließlich können Variableninhalte über die Remove-Operation aus dem Speicher gelöscht werden.

Variablen-Baustein erstellen	Per Drag&Drop aus der Palette in den Technical Process ziehen und in der Sicht Properties in der Eigenschaft `Name` einen eindeutigen Variablennamen eingeben (z. B. `Var1`)
Variable initialisieren	In der Sicht Properties in der Eigenschaft `Operation` den Wert `Put` wählen, um die Daten aus dem vorangegangenen Prozessschritt in die Variable zu laden
Variable auslesen	Den Variablen-Baustein mit demselben Namen erneut einfügen und die Eigenschaft `Operation` auf `Get` setzen
Variable testen	Den Variablen-Baustein mit demselben Namen erneut einfügen und die Eigenschaft `Operation` auf Test setzen
Variable aus dem Speicher löschen	Den Variablen-Baustein mit demselben Namen erneut einfügen und die Eigenschaft `Operation` auf `Remove` setzen
Innerhalb von XSL-Mappings auf Prozessvariablen zugreifen	Das `context://`-URL-Protokoll verwenden, z. B. über den XPath-Ausdruck `document('` `context://Var1` `')`

Kontextvariablen

In Prozessen gibt es zwei Kontextvariablen, die Informationen zur aktuell ausgeführten Prozessinstanz liefern. Diese Variablen können Sie sowohl im Process über einen Variable-Baustein über die Operation Get als auch in XSL-Mappings über das context:-URL-Protokoll abrufen.

X4STATE

Gibt den Status des vorherigen Prozessschritts (unmittelbar vor dem aktuellen Prozessschritt) in einem XML-Dokument aus.

<state>-1</state>

X4PREVACTION

Gibt Informationen (Action ID, Beschriftungstext und Status) zum vorherigen Prozessschritt als XML-Dokument aus.

<action>
   <id>4</id> 
   <label>File.tra</label> 
   <state>-1</state> 
</action>

Beispiel

Mit diesen Kontextvariablen wird eine erweiterte Fehlerbehandlung ermöglicht. So können Sie z. B. den Fehlermeldungstext eines Adapters gemeinsam mit dem Adapterstatus ausgeben.

<Merge>
   <state>-1</state> 
   <error>General File Error (see log for details).</error>
</Merge>

Adapter-Fehlermeldung und dessen Statuscode zusammengeführt in ein XML-Dokument: