Skip to main content
Skip table of contents

Übersicht der System-Parameter

Folgende Parameter werden in der X4 BPMS bereitgestellt:

%ACTION_ID%

Gibt die laufende Nummer des aktuell ausgeführten Prozess-Schrittes aus.

Beispiel: 3

%CALLING_PROCESS%

Gibt den relativen Repository-Pfad und den Dateinamen des Technical Processes aus, der den aktuellen Technical Process aufgerufen hat.

Dieser Parameter wird nur umgewandelt, wenn der aktuelle Technical Process von einem anderen Technical Process direkt als Subprozess aufgerufen wurde.

Beispiel: Project/Processes/ProcessCaller.wrf

%CALLING_PROCESS_NAME%

Gibt den Dateinamen (ohne Dateinamenerweitung *.wrf) des Technical Processes aus, der den aktuellen Technical Process direkt als Subprozess aufgerufen hat.

Dieser Parameter wird nur umgewandelt, wenn der aktuelle Technical Process von einem anderen Technical Process als Subprozess aufgerufen wurde.

Beispiel: ProcessCaller

%CALLING_PROCESS_PATH%

Gibt den relativen Repository-Pfad des Technical Processes aus, der den aktuellen Technical Process direkt als Subprozess aufgerufen hat.

Beispiel: Project/Processes/

%CURRENT_PROCESS%

Gibt den relativen Repository-Pfad und den Dateinamen des aktuellen Technical Processes aus.

Beispiel: Project/Processes/Process.wrf

%CURRENT_PROCESS_NAME%

Gibt den Dateinamen des aktuellen Technical Processes ohne Dateinamenerweitung (*.wrf) aus.

Beispiel: Process

%CURRENT_PROCESS_PATH%

Gibt den relativen Repository-Pfad des aktuellen Technical Processes aus.

Dieser Parameter wird nur umgewandelt, wenn der aktuelle Technical Process von einem anderen Technical Process als Subprozess aufgerufen wurde.

Beispiel: Project/Processes/

%CURRENT_PROJECT%

Gibt den Namen des aktuellen Repository-Projekts aus.

Beispiel: Project

%HOSTNAME%

Gibt den Host-Namen des X4 Servers aus.

Beispiel: YC-WS-000.yourcompany.local

%HTTP_PORT%

Gibt den HTTP-Port aus, der in der Konfigurationsdatei x4config.xml im Element <webContainerURL/> festgelegt wurde.

Beispiel: 8080

%INSTANCE%

Gibt den Namen der aktuellen X4 Server-Instanz aus, der in der Konfigurationsdatei x4config.xml im Element <instanceName> festgelegt wurde.

Beispiel: X4

%IPADRESS%

Gibt die IP-Adresse des X4 Servers aus.

Beispiel: 192.168.0.1

%NOW%

Gibt das aktuelle Datum und die Uhrzeit im ISO-Format yyyy-MM-ddThh:mm:ss aus.

Das Datum richtet sich nach der lokalen Zeitzone, die bei Bedarf separat eingestellt werden kann.

Weitere Informationen hierzu finden Sie weiter unten auf dieser Seite unter: Einstellen der Zeitzone für die Parameter %NOW% und %NOW_PLAIN%

Beispiel: 2021-08-11T17:46:50

%NOW_PLAIN%

Gibt das aktuelle Datum und die Uhrzeit im Format yyyyMMddhhmmss aus.

Das Datum richtet sich nach der lokalen Zeitzone, die bei Bedarf separat eingestellt werdenkann.

Weitere Informationen hierzu finden Sie weiter unten auf dieser Seite unter: Einstellen der Zeitzone für die Parameter %NOW% und %NOW_PLAIN%

Beispiel: 20210811174650

%PID%

Gibt die ID der aktuellen Prozess-Instanz als ganze Zahl aus, die innerhalb einer X4 Server-Instanz eindeutig ist. Subprozesse werden mit derselben Prozess-ID ausgeführt, nicht jedoch Technical Processes, die über den Process Starter gestartet wurden.

Beispiel: 1628696804892237809

Wenn mehrere Instanzen eines X4 Servers parallel auf einem Applikations-Server ausgeführt werden, empfiehlt sich, statt %PID% den eindeutigen Platzhalter %UID% zu verwenden.

%PUID%

Gibt die eindeutige UUID des Start-Prozesses aus.

%START_PROCESS%

Gibt den relativen Repository-Pfad und den Dateinamen des Technical Processes aus, der ursprünglich gestartet wurde.

Wird der aktuelle Technical Process als Subprozess eines anderen Technical Processes gestartet, so wird dessen Pfad und Dateiname angezeigt.

Beispiel: Project/Processes/ProcessCaller.wrf

%START_PROCESS_NAME%

Gibt den Dateinamen des ursprünglich gestarteten Technical Processes ohne Dateinamenerweierung (*.wrf) aus.

Wird der aktuelle Technical Process als Subprozess gestartet, so wird der Dateiname des ursprünglichen gestarteten Technical Processes angezeigt, der den aktuellen Prozess-Kontext erzeugt hat.

Beachten Sie, dass bei einem Prozessaufruf mittels Process Starter ein neuer Prozess-Kontext erzeugt wird.

Beispiel: ProcessCaller

%START_PROCESS_PATH%

Gibt den relativen Repository-Pfad des Technical Processes aus, der ursprünglich gestartet wurde.

Wird der aktuelle Technical Process als Subprozess eines anderen Technical Processes gestartet, so wird dessen Pfad angezeigt.

Beispiel: Project/Processes/

%TIME_MS%

Gibt die Zahl der Millisekunden seit 1. Januar 1970, 0:00 Uhr aus.

Beispiel: 1628696810712

%UID%

Gibt den Namen der X4 Server-Instanz %INSTANCE% und die angehängte aktuelle Prozess-ID (%PID%) aus.

Damit lässt sich eine Prozess-Instanz eindeutig identifizieren, wenn auf demselben Applikations-Server mehrere X4 Server-Instanzen parallel ausgeführt werden.

Beispiel: X41628696804892237809

%USER_COLLECTION%

Gibt den Pfad (absolut oder relativ) zum Repository-Ordner des aktuellen Benutzers in der X4DB aus; die so genannte "User Collection".

Dieser Wert wird aus der zentralen Konfigurationsdatei X4config.xml von Element <repositoryPath> unverändert übernommen, der dort auch relativ definiert sein kann, siehe X4 Server - Repository-Konfiguration

Beispiel: C:\X4\X4DB\1 oder./X4DB/1

%USER_COLLECTION_ABSOLUTE%

Gibt den absoluten Pfad zum Repository-Ordner des aktuellen Benutzers in der X4DB aus; die so genannte "User Collection"

Beispiel: C:\X4\Server\X4DB\1

%USER_ID%

Gibt die ID des aktuellen Benutzers aus, in dessen Repository-Ordner sich der Technical Process befindet ("user collection"). Seit X4-BPMS-Version 4.0 ist die User-ID keine ganze Zahl mehr, sondern eine Zeichenkette.

Beispiel:1

%WORKING_DIR_ABSOLUTE%

Gibt den absoluten Pfad des aktuellen Arbeitsverzeichnisses aus, in dem der Applikations-Server gestartet wurde.

Beispiel: C:\X4\Server


Einstellen der Zeitzone für die Parameter %NOW% und %NOW_PLAIN%

Sie können die Zeitzone für X4 einstellen, indem Sie in der Datei startX4.bat (Windows) oder startX4.sh (Linux) einen Parameter auf den Start von X4 / wildfly setzen.

Beispiele:

@set JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=Europe/Berlin

oder

@set JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=UTC

oder

@set JAVA_OPTS=%JAVA_OPTS% -Duser.timezone=US/Eastern

Parameter für Webservices

Innerhalb des Webservice Configuration Editors können zusätzliche Parameter für die Nutzung von Webservices aktiviert werden. Damit lassen sich Parameter für diese ReSTful-Webservice- oder SOAP-Webservice-Operation verarbeiten und Informationen aus dem HTTP-Request als Parameter bereitstellen (als effizientere Alternative zu Input Mode HTTP-MetaXml).

Mögliche Werte:

  • Disabled: Keine Parameter aus dem HTTP-Request im Kontext des Technical Processes bereitstellen (Standard)

  • Enabled: Parameter aus HTTP-Request-Informationen im Kontext des Technical Processes bereitstellen

Folgende Parameter mit Informationen aus dem HTTP-Request stehen bei Option Enabled innerhalb des X4-Prozesskontexts zur Verfügung, z.B. innerhalb von XSL-Mappings:

  • REQUEST_PARAMETER_<Name>: Gewünschter Parameter (Groß-/Kleinschreibung wird beachtet!)

  • REQUEST_HEADER_<NAME>: Gewünschter HTTP-Header (nur Großschreibung!)

  • REQUEST_METHOD

  • REQUEST_SCHEME

  • REQUEST_PATH

  • REQUEST_FULL_PATH

  • REQUEST_REMOTE_ADDRESS

  • REQUEST_REMOTE_PORT

  • REQUEST_REMOTE_USER

  • REQUEST_LOCAL_ADDRESS

  • REQUEST_LOCAL_PORT

  • REQUEST_SERVER_NAME

  • REQUEST_SERVER_PORT

Diese Parameter können wie alle Standard-Platzhalter verwendet werden, lassen sich jedoch nicht überschreiben und sind nicht in der Verwaltung für globale Parameter sichtbar.


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.