/
StartSoftlinksFromProcessVariablesHandler

StartSoftlinksFromProcessVariablesHandler

Beschreibung

Dieser Handler startet Softlinks und füllt sie mit Variablen aus dem Hauptprozess.

Dabei handelt der Handler nach folgendem Schema:

  1. Es sucht nach allen Variablen, die den mainSuffix Parameter enthalten.

  2. Danach sucht es nach allen Variablen, die den Parameter softLinkSuffix enthalten, woraufhin es von 0 bis kleiner als der Parameter softLinkCount zählt.

  3. Nach jedem Inkrement wird eine Softlink-Instanz der angegebenen Definition gestartet. In den Softlink-Instanzen wird der Parameter softLinkSuffix entfernt, um die Darstellung im Smartformular zu erleichtern.

Starter Regeln

Die folgenden Regeln gelten für das Startverhalten:

Prozesse, die ausschließlich den Starterausdruck user(sys.engine) enthalten, werden in keiner Liste startbarer Prozesse angezeigt.

Prozesse, die neben user(sys.engine) weitere Starterausdrücke enthalten, werden den entsprechenden Usern gemäß den definierten Berechtigungen angezeigt.

Softlink-Instanzen können ohne zusätzliche Berechtigungen gestartet werden, wenn ihr Starterausdruck user(sys.engine) ist.

Klasse

com.dooris.bpm.actionhandler.StartSoftlinksFromProcessVariablesHandler

Parameter

Parametername

Standardwert

Beschreibung

Gültige Beispiele

Parametername

Standardwert

Beschreibung

Gültige Beispiele

softLinkDefinition

 

Gibt an, von welcher Prozessdefinitions-Softlinks gestartet werden soll.

SGO Softlink

mainSuffix

 

Gibt an, welche Prozessvariablen des Hauptprozesses in alle Softlinks aufgenommen werden sollen.

Beispiel: Wenn das Suffix auf '_data' gesetzt ist, werden alle Prozessvariablen übernommen, die auf '_data' enden (firstname_data, lastname_data, email_data,...)

Pflichtfeld. Falls nicht erforderlich, geben Sie bitte eine Endung ein, die nicht existiert, d.h. _end

_mainData

softLinkCount

 

Gibt an, wie viele Softlinks gestartet werden sollen.

${softLinkCount}

softLinkSuffix

 

Gibt an, welche Variablen den einzelnen Softlinks zugeordnet werden sollen.

Hier wird der Parameter softLinkCount verwendet.

Der Handler zählt bis "i", zählt von 0 bis i < softLinkCount und sammelt dabei alle Variablen, die basierend auf dem folgenden Schema erstellt werden:

variablesname_softLinkSuffix[i]

Nach jeder Ausführung startet er eine Instanz der Softlinkdefinition und übergibt alle vom mainSuffix und softLinkSuffix gefundenen Variablen an sie.

In den neu gestarteten Softlink-Instanzen wird das softLinkSuffix entfernt, um eine einheitliche Darstellung im Smartformular zu gewährleisten.

Mindestens eine Variable mit der entsprechenden Endung muss gefunden werden, sonst wird kein Unterprozess gestartet.

_softLink

archiveWithMainInstance

true

Gibt an, ob die Softlinkinstanzen archiviert werden sollen, wenn die Hauptprozessinstanz archiviert wird.

Mögliche Werte:

  • archiveWithMainInstance=true → Die Softlink-Instanzen werden mit der Hauptprozessinstanz archiviert.

  • archiveWithMainInstance=false → Die Softlink-Instanzen werden nicht mit der Hauptprozessinstanz archiviert.

false

useChildTransactionsForSoftlinks

false

Um eine große Anzahl von gestarteten Softlink-Prozessen zu verarbeiten, muss dieser Parameter auf true gesetzt werden. 

true

 

Beispiel

  • Beispiel 1

     

    Variabel im Prozess: 
    user_email_sl[0]=john@doe.com 
    user_email_sl[1]=maria@doe.com 
    user_email_sl[2]=charles@doe.com 
    user_name_sl[0]=Johannes
    user_name_sl[1]=Maria
    user_name_sl[2]=Charles
    user_lastname_sl[0]=Mustermann
    user_lastname_sl[1]=Mustermann
    user_lastname_sl[2]=Mustermann

    softLinkSuffix=_sl
    softLinkCount=3

    ⇒ 3 Teilprozesse mit Variablen:
    1.
    user_email=john@doe.com 
    user_name=Johannes
    user_lastname=Reh
    2.
    user_email=Maria ...

 

  • Beispiel 2

    date_start_hp=01.01.2014 
    starter_hp=pm

    requesters_hp=Benutzer123 Benutzername=Mustermann
    useremail_sl[0]=john@doe.com
    userfirstname=John

    mainSuffix=_hp
    softLinkSuffix=_sl
    softLinkCount=1

    ⇒Unterprozess mit folgenden Variablen: 
    date_start=01.01.2014
    Starter=PM
    requesters=user123