Zum Hauptinhalt springen

Variablen

Mit Variablen können Sie einen Wert einmal befüllen und im Prozess wieder verwenden, ohne ihn an mehreren Stellen pflegen zu müssen. Stellen Sie sich vor, Sie möchten in einer E-Mail und in einem Dokument denselben zentral gepflegten Wert (z.B. eine Url oder eine zuständige Person) nutzen. Statt den Wert an beiden Orten einzeln zu hinterlegen, legen Sie ihn ein einziges Mal als Variable an und referenzieren ihn dort. Jede Ausführung des Prozesses (jeder laufenden Prozess) führt dabei über die Variable denselben Wert fort, den der Prozess aktuell besitzt.

Variablen Panel​

Das Variablen Panel erreichen Sie im Prozess Designer über den folgenden Button in der oberen Werkzeugleiste:

Anschließend öffnet sich das Panel, in dem Sie die Variablen des Prozesses verwalten können.

Variable anlegen​

Um eine Variable anzulegen, gehen Sie wie folgt vor:

  1. Klicken Sie im Variablen Panel auf Variable hinzufügen.
  2. Geben Sie einen Name für die Variable an. Der Name muss innerhalb des Prozesses eindeutig sein und dient später als Bezeichnung des Platzhalters.
  3. Wählen Sie den Datentyp, den die Variable annimmt. Dabei stehen folgende Optionen zur Auswahl:
    • Text
    • Zahl
    • Person
    • Datum
    • Datei
    • Tabelle
  4. Geben Sie einen Wert an, der der Variable zum Start des Prozesses zugewiesen wird. Der Wert wird passend zum gewählten Datentyp eingegeben (z.B. über eine Datumsauswahl oder die Personensuche). Für den Datentyp Datei können keine Standardwerte hinterlegt werden.
  5. Bestätigen Sie über Bestätigen, um die Variablen zu übernehmen. Über das Löschen-Icon am Ende einer Zeile () können Sie eine Variable wieder entfernen.
info

Eine neue Variable steht erst nach dem Speichern des Prozesses als Platzhalter zur Verfügung.

Tabellen Variablen​

Mit einer Tabellen Variable können Sie eine größere Menge zusammengehöriger Daten als Tabelle mit benannten Spalten in einer einzigen Prozessvariable verwalten. Jeder Eintrag (Zeile) der Tabelle besteht dabei aus Werten für die definierten Spalten.

Wählen Sie als Datentyp einer Variable Tabelle, erweitert sich das Variablen Panel im Wertbereich um die Tabellenspalten:

  1. Klicken Sie auf Spalte hinzufügen.
  2. Geben Sie einen Anzeigenamen für die Spalte an. Der Anzeigename dient später als Bezeichnung des Platzhalters der Spalte.
  3. Wählen Sie den Datentyp der Spalte. Dabei stehen folgende Optionen zur Auswahl:
    • Text
    • Zahl
    • Person
    • Datum
    • Datei
  4. Wiederholen Sie diese Schritte für weitere Spalten. Eine definierte Spalte entfernen Sie über das Löschen-Icon am Ende der Spaltenzeile.

Wenn mindestens eine Spalte definiert ist, können Sie über den Button Standardwerte bearbeiten Standardwerte für die Tabelle hinterlegen. Im Editor Standardwerte der Tabelle fügen Sie über Zeile hinzufügen Zeilen ein, tragen für jede Spalte den jeweiligen Wert ein und entfernen Zeilen über das Löschen-Icon am Ende der Zeile. Beim Start des Prozesses erhält die Variable diese Standardzeilen als Wert.

Um Einträge in der Tabelle zu verarbeiten, stehen die vier Tabellen Variablen Aktionen zur Verfügung:

  • Tabellen Variablen Eintrag einfügen: Fügt einen neuen Eintrag am Ende der Tabelle ein.
  • Tabellen Variablen Einträge löschen: Löscht Einträge, die den Filter erfüllen, aus der Tabelle.
  • Tabellen Variablen Einträge aktualisieren: Aktualisiert die konfigurierten Spaltenwerte von Einträgen, die den Filter erfüllen.
  • Tabellen Variablen Einträge laden: Lädt Einträge nach Filter und stellt deren Spaltenwerte als Platzhalter zur Verfügung.

Wird eine dieser Aktionen ausgeführt, wird der Wert der jeweiligen Prozess Instanz geändert - die Spalten in der Prozessdefinition bleiben unverändert.

Die Spaltenwerte einer Tabellen Variable können Sie zusätzlich direkt als Platzhalter referenzieren: In der Platzhalterauswahl finden Sie jede definierte Spalte in der Gruppe Prozess Variable unter dem Namen der Variable. Der Platzhalter löst die aktuellen Werte der Spalte für alle Zeilen auf; mehrere Werte werden mit einem Komma getrennt. Eine Tabellen Variable kann außerdem als Schleife durchlaufen werden: Innerhalb der Schleife lösen die Spaltenplatzhalter den Wert der jeweils aktuellen Zeile auf.

Variablen referenzieren​

Innerhalb des Prozesses referenzieren Sie eine Variable als Platzhalter. In der Platzhalterauswahl finden Sie die Variablen des Prozesses in der Gruppe Prozess Variable über den Namen der jeweiligen Variable. Bei der Ausführung des Prozesses wird der Platzhalter durch den aktuellen Wert der Variable ersetzt.

Variablen Wert setzen​

Den Wert einer Variable können Sie im Verlauf des Prozesses ändern. Hierfür steht die Aktion Variablen Wert setzen zur Verfügung. Wird diese Aktion ausgeführt, wird der Wert der jeweiligen Prozess Instanz auf den neuen Wert gesetzt - die Variable in der Prozessdefinition bleibt unverändert.

Werte in Dashboards anzeigen​

Variablen Werte, die im Verlauf des Prozesses befüllt oder geändert wurden, können Sie auch in Dashboards anzeigen. Dort referenzieren Sie die Variable über denselben Platzhalter und zeigen den aktuellen Wert des Prozesses an.