=======MailByProcessVariableHandler========
==== Beschreibung ====
Der [[software:tim:Actionhandler]] wird auf allen zu eskalierenden Aktivitäten eingebaut. Er setzt den Eskalationszeitpunkt und sich selbst als aufzurufende Methode, falls die [[software:tim:escalation]] in Kraft tritt (Methode handleEscalation). Er ist ab TIM Version 3.4 verfügbar.

Der zugehörige Timer ist der [[software:tim:timer:performescalationfornodestimerwithlimit|performEscalationForNodesTimerWithLimit]].

>> **Achtung!**  Pro Aktivität ist mit diesem Handler nur eine Eskalation möglich. Sind mehrere Eskalationen notwendig, kann der [[software:tim:Actionhandler:MailReminderHandler]] verwendet werden.

<note important>Dieser Handler benutzt keinen [[software:tim:calendar_profile|Business Kalender]]</note>

------
==== Klasse ====
<code>
com.dooris.bpm.actionhandler.MailByProcessVariableHandler
</code>
\\
----
==== Parameter ==== 
==mailSubject ==
Dieser Parameter bestimmt den Betreff der zu versendenden E-Mail, (siehe [[#Beispiel]])

\\ ==mailText==
Dieser Parameter legt den Text der zu versendenden E-Mail fest. Mit „\n“ werden Zeilenumbrüche erzeugt, auf Variablen kann mit „${variablenName}“ referenziert werden. (siehe       [[#Beispiel]])

\\ ==mailTo==
Dieser Parameter definiert den/die Empfänger der Eskalationsmail. Dazu muss ein Variablennamen ohne # oder $ angegeben werden (siehe [[#Beispiel]]). \\
Mögliche Inhalte der Variable sind:

  *swimlane(Beispielswimlane): Der User, dem die Swimlane assigned ist, bekommt die Mail. Ist kein User assigned, werden alle User aus der der Gruppe, der die Swimlane zugewiesen ist, benachrichtigt.
  *group(Beispielgruppe): Alle User in dieser Gruppe bekommen die Mail.
  *user(Beispieluser): Nur dieser User bekommt die Mail.
  *beispieladresse@mail.de,beispieladresse2@mail.de: nur eine E-Mail-Adresse, oder mehrere E-Mail-Adressen mit Komma getrennt. Feste Adressen und Variablen sind nicht kombinierbar!

>> **Achtung!**  Eine Kombination aus diesen Möglichkeiten ist nicht möglich!
Es können mehrere Mailadressen mit , oder ; getrennt angegeben werden.

\\ == fieldMailTo ==
Kann alternativ zu mailTo benutzt werden. Hier muss eine Variable als Empfänger benutzt werden.

\\ == fieldDuration ==
Die fieldDuration gibt die Zeitspanne an, an dem die Mail versendet werden soll. Mögliche Werte sind:
  *s (Sekunden)
  *m (Minuten)
  *h (Stunden)
  *d (Tage)
  *w (Wochen)
  *mon (Monate)
  *y (Jahre)

ist kombinierbar z.B. 1y 11mon 3w 2d 1h 12m 5s

(siehe [[#Beispiel]])


----
==== Beispiel ====

{{ :software:tim:actionhandler:mailbyprocessvariablehandler.png }}