YearIDGenerator

Beschreibung

Der Handler generiert eine Nummer, die als eindeutige Klassifizierung verwendet werden kann. In der Regel wird die generierte ID durch die RenameInstanceHandler. Die generierte ID wird wie folgt eingerichtet: JJJJxxxx; wobei YYYY das aktuelle Jahr ist und xxxx eine fortlaufende Zählerzahl darstellt (Beispiel: 20220001).

Dieser Zähler wird nur mit dem Jahreswechsel zurückgesetzt.

Klasse

com.dooris.bpm.actionhandler.YearIDGenerator

Parameter

Die generierte ID kann über die Variable #{key} aufgerufen und dann im Handler verarbeitet werden. Wird die Variable als Prozessvariable in der Prozessentwicklung benötigt, muss das Pflichtfeld gesetzt werden!

Parameter	Standardwert	Beschreibung	Gültige Beispiele
`obligatorischeFelder`	N/A	Der Benutzer kann eine Variable festlegen, in die der erstellte Wert geschrieben wird. Der Variablenname "id" sollte nicht verwendet werden!	`IDwithYear`
`Muster`	N/A	Dieser Parameter ist optional und kann verwendet werden, um Prozessvariablen in den Namen der Prozessinstanz aufzunehmen. Hier kann die Variable #{key} aufgerufen werden.	`Employee_name #{Variablenname} #{Schlüssel}` Ausgabe: `Employee_name` `Variablenname IDwithyear` `Employee_name #{variablenname}` Ausgabe:`Employee_name` `Variablenname`
`Länge`	`4`	Der length-Parameter erhöht die ID-Länge um eine bestimmte Anzahl aufeinanderfolgender Nummern. Die Länge kann manuell eingestellt werden. Wenn beispielsweise "length=5" eingegeben wird, setzt sich die ID aus dem aktuellen Jahr + 5 aufeinanderfolgenden Zahlen zusammen. Wenn nichts manuell eingestellt wird, setzt sich die ID standardmäßig aus dem aktuellen Jahr + 4 aufeinanderfolgenden Nummern zusammen.
`Präfix`	N/A	Dadurch wird der generierten ID ein angegebenes Präfix mit einem Leerzeichen zwischen dem Präfix und der ID hinzugefügt. Dieser Parameter wird nur ausgewählt, wenn der pattern-Parameter nicht verwendet wird!

Beispiel

In diesem Beispiel haben wir eine Prozessinstanz mit dem Namen "Year ID Generation" mit einer Aufgabe. YearIDGenerator handler ist für die Aufgabe festgelegt.

Für die gewünschte Ausgabe des Prozessinstanznamens können unterschiedliche Kombinationen verwendet werden. Unser enthält z.B. nur den Parameter obligatorischeFelder.
Wir haben ein Smartform mit einem Eingabefeld, das die Variable generatedID.
Actionhandler generiert eine ID, die in dieser Variablen gespeichert wird und nach dem Start des Prozesses angezeigt wird, wie Sie in den Beispiel-Screenshots unten sehen können.

Parameter	Beschreibung	Beispielwerte
`obligatorischeFelder`	Wir haben hier den Variablennamen aus dem Smartform eingefügt.	`generatedID`

Ausgabe nach der Konfiguration des Actionhandlers:

Beispiel 2:
Wie bereits erwähnt, sind für diesen Actionhandler verschiedene Konfigurationen möglich. In diesem zweiten Beispiel verwenden wir auch die Muster , um den Instanznamen direkt zu ändern. Wir haben ein Smartform mit zwei Feldern, die Aufseher (die zur Eingabe des Mitarbeiternamens verwendet wird) und generatedID (die verwendet wird, um die generierte ID zu speichern und anzuzeigen).

Parameter	Beschreibung	Beispielwerte
`obligatorischeFelder`	Wir haben hier den Variablennamen aus dem Smartform eingefügt.	`generatedID`
`Muster`	Ein Muster für den Instanznamen kann mit Text, Prozessvariablen und Schlüssel (die generierte ID) erstellt werden. Im Beispiel: `Aufseher` entspricht Text, `#{Vorgesetzter}` einer Prozessvariablen aus dem Smart Form entspricht und `#{Schlüssel}` ruft die generierte ID auf, die wir mit dem ActionHandler erstellt haben	`Vorgesetzter #{Vorgesetzter} #{Schlüssel}`

Mit diesen Einstellungen wird automatisch ein eindeutiger Name basierend auf dem Jahr für jede gestartete Prozessinstanz erstellt.

Beispiel für eine Änderung des Namens der Prozessinstanz nach dem Klick auf die Schaltfläche 'Prozessinstanz starten':