==== Beschreibung ====

Startet einen Softlinkprozess für jedes Werk welches vorab per [[:software:tim:actionhandler:zollnergetfactoriesbyxlsxhandler|ZollnerGetFactoriesByXSLXHandler]] und RulesMatrixHandler ermittelt worden ist.

Die gestarteten Softlinkprozesse bekommen die für sie relevanten Prozessvariablen mit übergeben.

Es ist möglich alle Dokumente mit zu übergeben oder gegebenenfalls verschiedene Dokumente aus zu schließen.

----

==== Klasse ====

<code>
com.dooris.bpm.actionhandler.ZollnerStartSoftlinkForEachAreaAndAddDocument
</code>

----

==== Event Type ====

beliebig

==== Action Name ====

beliebig

==== Mandatory Fields ====

leer

----

==== Parameter ====

== softLinkDefinition ==

Name der Prozessdefinition welche gestartet werden soll. Variablen sind möglich. Erklärung (siehe [[#beispiel|Beispiel]])

Mögliche Optionen sind:

  * softLinkDefinition=PxN for business area;
  * softLinkDefinition=${PROCESSDEFINITIONNAME}

== softLinkCount ==

Anzahl der zu startenden Softlinks.

Variablen sind möglich. Erklärung (siehe [[#beispiel|Beispiel]])

Mögliche Optionen sind:

  * softLinkCount=10;
  * softLinkCount=${count}

== assignee ==

Variable in welcher die User stehen, welche den gestarteten Softlinks zugewiesen werden sollen.

Erklärung (siehe [[#beispiel|Beispiel]]).

assignee=assignee;

>> **Achtung!** Abhängig vom Wert im Parameter softLinkCount wird hier für jeden Softlink der passende Assignee gesucht. Der Actionhandler sucht hierfür in den Variablen assignee[0] - assignee[x]. Die Assignees müssen vorab ermittelt worden sein.

Die Variable assignee wird im gestarteten Softlink dann ohne Index zur Verfügung gestellt.

== swimlane ==

Swimlane, an welche der User aus parameter assignee zugewiesen werden soll.

Default ist dieser Parameter leer.

Erklärung (siehe [[#beispiel|Beispiel]]).

Swimlane=PxN Manager;

>> **Achtung!** Nur wenn swimlane und assignee einen Wert haben, diese Swimlane im Unterprozess dem passenden User zugewiesen!

== softlinkArea ==

Variable in welcher die verschiedenen ermittelten Bereiche stehen. Die gestarteten Softlinks bekommen den Wert der softlinkArea als Suffix im Prozessinstanznamen

Erklärung (siehe [[#beispiel|Beispiel]]).

softlinkArea=softlinkArea;

>> **Achtung!** Abhängig vom Wert im Parameter softLinkCount wird hier für jeden Softlink die passende Softlinkarea gesucht. Der Actionhandler sucht hierfür in den Variablen softlinkArea[0] - softlinkAreaee[x]. Die Areas müssen vorab ermittelt worden sein.

Die Variable softlinkArea wird im gestarteten Softlink dann ohne Index zur Verfügung gestellt.

== addOriginalDocuments ==

Der Paramenter kann den Wert true oder false annehmen. Wenn hier true übergeben wird, werden alle Dokumente inklusive des generierten bereichsspezifischen Dokuments (exklusiv der übrigen in ZollnerCreateXLSXForEachArea generierten bereichsspezifischen) angehängt.

Erklärung (siehe [[#beispiel|Beispiel]]).

Mögliche Optionen sind:

  * addOriginalDocuments=true;
  * addOriginalDocuments=false;

== excludeDocuments ==

Dieser Parameter ist optional.

In PxN hat jedes Dokument einen Kommentar. In diesem Parameter können die Kommentare kommasepariert mitgegeben werden. Hat ein Dokument diesen Kommentar, wird es nicht in den Softlink mit übergeben.

excludeDocuments=SAP-Export,SAP-Export (bereichsspezifisch),E-Mail;

Erklärung (siehe [[#beispiel|Beispiel]]).

==== Beispiel ====

Bitte ein Beispiel einfügen, MIT Screenshot!

----

==== Abhängigkeiten ====

  __Timer__: [[:software:tim:timer|ERSETZMICH]]