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 set aufgerufen 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 usedIf nothing is set manually, the ID is composed of the current year + 4 consecutive numbers by default

Parameter

Default valueStandardwert

DescriptionBeschreibung

Valid examplesGültige Beispiele

mandatoryFields

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

pattern

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 #{variablename} #{key}
    outputAusgabe:
    Employee_name variablename Variablename IDwithyear

  • Employee_name #{variablename}
    outputAusgabe:Employee_name variablename Variablename

length

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

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.

Info

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

prefix

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

mandatoryFields

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 pattern , um den Instanznamen direkt zu ändern. Wir haben ein Smartform mit zwei Feldern, die supervisor (die zur Eingabe des Mitarbeiternamens verwendet wird) und generatedID (die verwendet wird, um die generierte ID zu speichern und anzuzeigen).

...

Parameter

DescriptionBeschreibung

Example valuesBeispielwerte

mandatoryFieldsWe put the variable name from the smartform here

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

generatedID

patternA 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 textEin Muster für den Instanznamen kann mit Text, Prozessvariablen und Schlüssel (die generierte ID) erstellt werden.
Im Beispiel:
Supervisor entspricht Text,
#{supervisor} corresponds to a process variable from the smart form and, einer Prozessvariablen aus dem Smart Form entspricht und
#{key} calls the generated ID which we created with the actionhandler ruft die generierte ID auf, die wir mit dem ActionHandler erstellt haben

Supervisor #{supervisor} #{key}

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

Example change of the process instance name after clicking the 'Start process instance' buttonMit 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':

...