======= MailReminderHandler =======
==== Beschreibung ====
Durch diesen [[software:tim:actionhandler:|Handler]] wird der Eskalationszeitpunkt dieser [[:glossar#Node]] gesetzt. Mit **Offset** wird festgelegt, wie lange vor Ablauf der [[:glossar#Bearbeitungszeit]] alle Aufgaben erledigen sein müssen. Zum Eskalationszeitpunkt wird zu jeder offenen Task auf der "Eskalationsnode" eine Mail an den Bearbeiter verschickt.

<note tip>Nur mit diesem Handler können mehrere Eskalationen auf einer Aktivität konfiguriert werden.</note>

----
==== Klasse ====
<code>
com.dooris.bpm.actionhandler.MailReminderHandler
</code>
\\
----
==== Event Type ==== 
node-enter

==== Action Name ==== 
beliebig

==== Mandatory Fields ==== 
leer
-----
==== Parameter ==== 
== escalationDuration ==
escalationDuration=VariablenName \\
oder \\
escalationDuration=VariablenName+05 \\
>> Der Wert der Variable muss folgendes Format haben: hhmm 
Wenn das Feld escalationDuration angegeben wird, wird nicht die Bearbeitungszeit der [[:glossar#Node]] sondern der Wert, der Variable, die durch escalationDuration angegeben wurde verwendet. \\
\\
== escalationDate == 
escalationDate=VariablenName oder z.b. 01.01.2014 12:00\\
Datum und Uhrzeit zu welchem die Eskalationsmail versand werden soll.\\
>> Achtung: escalationDate wird nur beachtet, sofern keine escalationDuration gesetzt ist!
>> Achtung 2: escalationDate ist erst ab TIM Version 4.0 oder per Hotfix verfügbar.
\\
\\
== escalationDateFormat == 
escalationDateFormat=Datumsformat im Simple Date Format (z.B. dd.MM.yyyy HH:mm)\\
Format in welchem escalationDate angegeben wird. \\
Defaultwert ist hier dd.MM.yyyy HH:mm
\\
\\


== escalationMessage == 
escalationMessage=Mailtext der Escalationamail\\
Kann [[software:tim:process_variables|Variablen]] enhalten.
\\
\\
== escalationSubject == 
escalationSubject=Betreff der Escalationamail\\
Kann [[software:tim:process_variables|Variablen]] enhalten.
\\
\\
== offSet ==
Der Offset-Wert wird in dem Format **hhmm** angegeben, d. h. die letzten beiden Stellen werden als
Minuten angenommen, die Stellen davor als Stunden. Siehe auch [[#Beispiel]]

>> Es wird nach dem [[:glossar#BusinessCalendar]] berechnet.
> Als Wert kann auch ein Prozentsatz genutzt werden.
== escalationMailTo ==

Kann mit Variablen, Emailadressen oder Expressions gefüllt werden. Diese können kommasepariert angegeben werden!
Möglich wäre hier z.B.
  * escalationMailTo=variable;
  * escalationMailTo=variable1,variable2,group(PM),swimlane(Instanzstarter);
  * escalationMailTo=email@adresse.de,variable1,user(pm);
Es kann beliebig gemischt werden.
>> Achtung: Bei TIM Versionen vor 3.8 sind nur Variablen möglich!

==nodeMail==
Wird dieser Wert auf "true" gestellt, so wird pro Node nur eine Mail versendet und nicht pro Aufgabe eine Mail. Der Default Wert ist hier "false"

----

==== Beispiel ====
{{:software:tim:actionhandler:mailreminderhandler.png }}
{{:software:tim:actionhandler:mailreminderhandler2.png }}
----
==== Abhängigkeiten ====
\\ __Timer__: [[software:tim:timer:performPastReminders|performPastReminders]]