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

====== ManageAbsenceHandler ======
==== Description ====
This handler enters a user absence into TIM for a given user. It also designates a substitute user for all processes, for which the absent user is responsible.

------
==== Action Class ====
<code>
com.dooris.bpm.actionhandler.ManageAbsenceHandler
</code>
\\
----
==== Event Type ==== 
any
==== Action Name ==== 
any
==== Mandatory Fields ==== 
none
----
==== Parameter ==== 
<note important> All parameters must be given via a process variable.</note>

== start ==
Here, the starting date of the user absence is given. Currently, the format is based on the  [[en:software:tim:smartform_basics#datepicker_kalender|Datepicker]]; however, it can be customized to the [[#datepattern|Datepattern]].

\\ == end ==
Here, the ending date of the user absence is given. Currently, the format is based on the  [[en:software:tim:smartform_basics#datepicker_kalender|Datepicker]]; however, it can be customized to the [[#datepattern|Datepattern]].

\\ == user ==
This variable must contain the name or e-mail of the absent user.

<note tip>The following parameters are optional</note>

\\ == representative ==
This variable may contain the name or e-mail address of the person who is substituting for the absent user. TIM then automatically sets this user as a substitute for every process definition, for which the user is responsible.
<note tip> If the value "profile" (without "") is given, the handler will try to take the substitute from the [[en:software:tim:user_profile_properties|Userprofile]].</note>

\\ == action ==
If the value "action=remove" is given, TIM will search for an absence that matches the starting and ending times and then delete it.

\\ == takeOverExistingTasks ==
If "takeOverExistingTasks=true" is entered, all **existing** tasks from this absence will be transferred to the substitute. In order to do this, the [[en:software:tim:timer:handleactualabsences|HandleActualAbsences-Timer]] must be set and running. 

\\ == datePattern ==
If the date selection is not made with the Datepicker or does not match the "yyy-MM-dd" format, is may be adjusted here.

----
==== Example ====
{{:software:tim:actionhandler:manageAbsenceHandler.png}}