Möglichkeiten der Parametrierung

Hier erhalten Sie einen Überblick über die Erstellung und Verwendung von Parametern in der X4 BPMS.

Gültigkeitsbereich (Scope) für Parameter:

System-Parameter: vom System vorgegebene Parameter (siehe System-Parameter)
Globale Parameter: Parameter, die Sie als Nutzer anlegen können und die in allen Projekten der X4 BPMS verwendet werden können (siehe Globale Parameter)
Projekt-Parameter: Parameter, die in einer Datei in einem Projekt erstellt, innerhalb dieses Projekts genutzt und mit dem Projekt importiert bzw. exportiert werden können (siehe Projekt-Parameter erstellen)

Verwendung von Parametern:

Parameter können in Technical Processes in Prozessbausteinen, Mappings, Adaptern und Conditions genutzt werden. In Geschäftsprozessen (BPM-Prozessen) können Sie zudem in Rules und Human Task verwendet werden. Es können globale, System- oder Projekt-Parameter verwendet werden.

Mit der Tastenkombination Strg+Leertaste können in Projektdateien (Prozessbausteinen, Mappings, Adaptern und Conditions) alle verfügbaren System-, Projekt- und globalen Parameter angezeigt und ausgewählt werden.

Beachten Sie folgende Priorisierung bei der Verwendung von Parametern:

System-Parameter → Projekt-Parameter → Globale Parameter

Bei Namenskonflikten wird eine Fehlermeldung bzw. Warnung in der Sicht Problems angezeigt:

Fehlermeldung bei Namenskonflikten von System- und Projekt-Parametern
Warnung bei Namenskonflikten von Projekt-Parametern und globalen Parametern

Wo werden Parameter gespeichert?

System-Parameter	Die X4 BPMS enthält eine Reihe von vordefinierten System-Parametern, z. B. `%PID%` (aktuelle Prozessinstanz-ID) oder `%NOW%` (aktuelles Datum und Uhrzeit). System-Parameter können nicht während der Laufzeit geändert werden. Typischer Anwendungsfall: Technische Parameter, z.B. eine Mailserver-Adresse, setzen für diese Laufzeitumgebung/Stufe. Dateinamen oder Prozess-ID eines Technical Processes ausgeben
Für zusätzliche Anwendungsfälle, die nicht durch System-Parameter abgedeckt werden, können Sie globale oder Projekt-Parameter erstellen. Globale oder Projekt-Parameter können, im Gegensatz zu System-Parametern, zur Prozesslaufzeit gesetzt werden.
Globale Parameter	Globale Parameter können Sie in der Global Parameter Configuration definieren. Diese Konfiguration wird im jeweiligen Prozess gespeichert. Beispiele für Anwendungsfälle von globalen Parametern finden Sie in Globale Parameter verwenden. Typischer Anwendungsfall: Parameter setzen, die in verschiedenen Projekten genutzt und die während der Laufzeit geändert werden können, z.B. die Empfänger von systemgenerierten Mails oder die Fußzeile in systemgenerierten Mails.
Projekt-Parameter	Projekt-Parameter können in einem Projekt in mehreren Technical Processes verwendet werden. Diese Parameter werden in der Project Parameter Configuration (`.param`) im Projekt gespeichert und können mit dem Projekt exportiert bzw. importiert werden. Typischer Anwendungsfall:* Technical Process: Ein Projekt-Parameter kann als Grenzwert für Messwerte (Messwert muss zwischen zwei Grenzwerten liegen) definiert werden. Geschäftsprozess mit Business Rule: Ein Projekt-Parameter kann als Limitierung zur Überprüfung eines Werts (Abnahme/Ablehnung je nach gesetztem Wert) festgelegt werden. Geschäftsprozess mit Human Task: Ein Projekt-Parameter kann in einem Mapping in einem Technical Process gesetzt werden, der vom Geschäftsprozess aufgerufen wird. Hier kann z.B. die Duration im Human Task unterschiedlich sein je nach Umgebung.

Wo werden Parameter verwendet?

In Technical Processes können Parameter für folgende Elemente gesetzt werden:

Adapter
Conditions
Mappings
weitere Prozessbausteine

In Geschäftsprozessen (BPM-Processes) können Parameter für folgende Elemente gesetzt werden

Rules
Human Task (über Mapping in einem Technical Process)

Beachten Sie folgende Priorisierung bei der Nutzung von Component Parameters und dynamischen Parametern:

Component Parameters überschreiben die Konfiguration von Prozessbausteinen im Repository (beispielsweise Funktions-Adapter) während der Prozesslaufzeit.
Dynamische Parameter überschreiben gesetzte globale, Projekt-Parameter System-Parameter sowie die Konfiguration von Prozessbausteinen im Repository (beispielsweise Funktions-Adapter) zur Prozesslaufzeit.

Aktion	Beschreibung
Adapter-Parameter	Parameter lassen sich in Adapter-Konfigurationen einsetzen. Typischer Anwendungsfall: In einem XML Encryption (Password) Adapter kann im Parameter xpath ein Pfad zu einem Element, das verschlüsselt/entschlüsselt werden soll, gesetzt werden. Dieser Pfad kann fest definiert (`//Data`) werden oder über einen Parameter gesetzt werden.
Conditions	Fallunterscheidungen in Verzweigungen von Condition-Bausteinen können Sie mit Parametern definieren (siehe Bedingungen erstellen und verwenden). Typischer Anwendungsfall: Es soll geprüft werden, ob der Output eines Prozessbausteins einen bestimmten Parameterwert enthält.
Mappings	Parameter (globale, Projekt- und System-Parameter) können in XSL-Mappings verwendet werden. Hierzu müssen Sie im Mapping eingefügt werden (siehe Parameter in XSL-Mappings verwenden).
Component-Parameter	Markierte Prozessbausteine eines geöffneten Prozesses können Sie in der Sicht Properties anpassen. Mit Component-Parameter können Sie einen markierten Prozessbaustein für den einzelnen Prozess parametrieren (siehe Component-Parameter). Diese Parameter werden im jeweiligen Prozess gespeichert. Typischer Anwendungsfall: Mit Component-Parameter können die Parameter eines Adapters in einem Prozess überschrieben werden. Innerhalb von Component-Parameter können Sie feste Werte (fester Pfad z.B. c:\temp) oder Parameter verwenden. Hier können System-Parameter oder zuvor definierte globale bzw. Projekt-Parametern genutzt werden.
Dynamische Parameter	Mit dynamischen Parametern können Sie globale, System- und Projekt-Parameter in XSL-Mappings überschreiben. Innerhalb eines Prozesses können Sie in Abhängigkeit von verarbeiteten Daten mit dynamischen Parametern verschiedene Prozessbausteine ansteuern. Dynamische Parameter werden in XSL-Mappings in Form von Processing Instructions abgelegt und vom darauf folgenden Prozessbaustein (z. B. einem Adapter) interpretiert (siehe Dynamische Parameter verwenden). Die Konfiguration wird nur während der Prozesslaufzeit dynamisch verändert. Typischer Anwendungsfall: Mit dynamischen Parametern können Sie Prozessbausteine ansteuern und bereits gesetzte Parameter zur Prozesslaufzeit überschreiben.