Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

...

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).

Info

This counter is reset only with the change of the year.

...

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

...

Klasse

Code Block
com.dooris.bpm.actionhandler.YearIDGenerator

Parameter

The generated ID can be called on using the variable Die generierte ID kann über die Variable #{key} , and can then be processed in the handler. If the variable is required as a process variable in the process development, the mandatory field must be setaufgerufen und dann im Handler verarbeitet werden. Wird die Variable als Prozessvariable in der Prozessentwicklung benötigt, muss das Pflichtfeld gesetzt werden!

The variable name “id” should not be used

Parameter

Default valueStandardwert

DescriptionBeschreibung

Valid examplesGültige Beispiele

mandatoryFieldsobligatorischeFelder

Status
titleN/A

The user can set a variable to which the created value is written.

Note

Der Benutzer kann eine Variable festlegen, in die der erstellte Wert geschrieben wird.

Note

Der Variablenname "id" sollte nicht verwendet werden!

IDwithYear

patternMuster

Status
titleN/A

This parameter is optional and can be used to include process variable(s) in the process instance name. Here, the variable #{key} can be called uponDieser Parameter ist optional und kann verwendet werden, um Prozessvariablen in den Namen der Prozessinstanz aufzunehmen. Hier kann die Variable #{key} aufgerufen werden.

  • Employee_name #{variablenameVariablenname} #{keySchlüssel}
    outputAusgabe:
    Employee_name variablename Variablenname IDwithyear

  • Employee_name #{variablenamevariablenname}
    outputAusgabe:Employee_name variablename Variablenname

lengthLänge

4

The length parameter increases the ID length by a specified number of consecutive numbers.
length can be set manually. For example, if “length=5” is entered, the ID will be composed of the current year + 5 consecutive numbers.

Info

If nothing is set manually, the ID is composed of the current year + 4 consecutive numbers by default.

prefixDer 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.

Info

Wenn nichts manuell eingestellt wird, setzt sich die ID standardmäßig aus dem aktuellen Jahr + 4 aufeinanderfolgenden Nummern zusammen.

Präfix

Status
titleN/A

This adds a specified prefix to the generated ID, with a blank space between the prefix and the ID.

Note

This parameter is only chosen when the pattern parameter is not being used!

Example

We have a process instance named ‘Year ID Generation’ with one task in this example. YearIDGenerator handler is set on the task.

...

Different combinations can be used for the desired output for the process instance name. Our for example contains only the parameter mandatoryFields.
We have a smartform with one input field which has the variable generatedID.
Actionhandler will generate an ID which will be stored in this variable and will be shown after the process is started, as you can see in the example screenshots below.

...

Parameter

...

Description

...

Example values

...

mandatoryFields

...

We put the variable name from the smartform here.

...

generatedID

Output after the configuration of the actionhandler:

...

Dadurch wird der generierten ID ein angegebenes Präfix mit einem Leerzeichen zwischen dem Präfix und der ID hinzugefügt.

Note

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

DescriptionBeschreibung

Example valuesBeispielwerte

mandatoryFields

We put the variable name from the smartform hereobligatorischeFelder

Wir haben hier den Variablennamen aus dem Smartform eingefügt.

generatedID

pattern

A pattern for the instance name can be created with text, process variables and key (which is the generated ID).
In the example:
Supervisor corresponds to textMuster

Ein Muster für den Instanznamen kann mit Text, Prozessvariablen und Schlüssel (die generierte ID) erstellt werden.
Im Beispiel:
Aufseher entspricht Text,
#{supervisor} corresponds to a process variable from the smart form and,Vorgesetzter} einer Prozessvariablen aus dem Smart Form entspricht und
#{key} calls the generated ID which we created with the actionhandler

Supervisor #{supervisor} #{key}

These settings will automatically create a unique name based on the year for each started process instance.

...

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':

...