FIXME **This page is not fully translated, yet. Please help completing the translation.**\\ //(remove this paragraph once the translation is finished)//

=======MailByProcessVariableHandler========
==== Description ====
The [[en:software:tim:actionhandler|action handler]] is built into all escalating activities.  It stipulates that the escalation point and itself be called as methods if the [[en:software:tim:escalation]] comes into effect (method handleEscalation). It is available in from TIM Version 4.3 on.

The corresponding timer is the [[en:software:tim:timer:performescalationfornodestimerwithlimit|performEscalationForNodesTimerWithLimit]].

>> **Attention!**  This handler allows only one escalation per activity.  If more escalations are necessary, the [[en:software:tim:Actionhandler:MailReminderHandler]] can be used.

<note important> This handler does not use a [[en:software:tim:calendar_profile|business calender]]</note>

------
==== Action Class ====
<code>
com.dooris.bpm.actionhandler.MailByProcessVariableHandler
</code>
\\
----
==== Parameter ==== 
==mailSubject ==
This parameter dictates the subject of the e-mail being sent (see [[#example]]).

\\ ==mailText==
This parameter sets the text of the e-mail being sent. Use „\n“ to enter a line break, and „${variablenName}“ to reference a variable. (see [[#example]])

\\ ==mailTo==
This parameter defines the receiver of the escalation e-mail. For this, a variable name without a # or $ must be entered (see [[#example]]) . \\
The variable may be a:

  *swimlane(Exampleswimlane): The user to which the swimlane is assigned receives the mail.  If no user is assigned, all of the users from the group that is assigned to the swimlane will be notified. 
  *group(Examplegroup): All users in this group receive the mail.
  *user(Exampleuser): Only this specific user receives the mail.
  *exampleaddress@mail.de, exampleaddress2@mail.de: Only one e-mail address, or multiple e-mail addresses that are separated by a comma. Fixed addresses and variables cannot be combined!

>> **Attention!**  A combination of the possibilities listed above is not possible! Sending to multiple addresses, separated by "," or ";" is possible.

\\ == fieldMailTo ==
May be used as an alternative to mailTo.  Here, a variable is used as the receiver.

\\ == fieldDuration ==
The fieldDuration defines the time span in which the mail should be sent. Possible values are:
  *s (Seconds)
  *m (Minutes)
  *h (Hours)
  *d (Days)
  *w (Weeks)
  *mon (Months)
  *y (Years)

can be combined i.e. 1y 11mon 3w 2d 1h 12m 5s

(see [[#example]])


----
==== Example ====

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