====== ManageAbsenceHandler ======
==== Beschreibung ====
Dieser Handler trägt eine Abwesenheit in TIM für einen übergebenen Benutzer ein. Ausserdem legt er auch Vertreter für alle Prozesse, für die der abwesende Benutzer zuständig ist, an.

------
==== Klasse ====
<code>
com.dooris.bpm.actionhandler.ManageAbsenceHandler
</code>
\\
----
==== Event Type ==== 
beliebig
==== Action Name ==== 
beliebig
==== Mandatory Fields ==== 
leer
----
==== Parameter ==== 
<note important>Alle Parameter müssen über eine Prozessvariable angegeben werden.</note>

== start ==
Hier muss das Datum des Startzeitpunkts angegeben werden, ab wann dem User eine Abwesenheit eingetragen werden soll. Aktuell ist das Format auf den [[software:tim:smartform_basics#datepicker_kalender|Datepicker]] ausgerichtet, kann aber das [[#datepattern|Datepattern]] angepasst werden.

\\ == end ==
Hier muss das Datum des Endzeitpunkts angegeben werden, ab wann dem User eine Abwesenheit eingetragen werden soll. Aktuell ist das Format auf den [[software:tim:smartform_basics#datepicker_kalender|Datepicker]] ausgerichtet, kann aber das [[#datepattern|Datepattern]] angepasst werden.

\\ == user ==
In dieser Variable muss der Name des Users oder dessen E-Mailadresse stehen, der als Abwesend eingetragen werden soll.

<note tip>Folgende Parameter sind optional</note>

\\ == representative ==
In dieser Variable kann der Name des Users oder dessen E-Mailadresse stehen, der den abwesenden User vertritt. TIM legt dann automatisch für jede Prozessdefinition, für die der Benutzer zuständig ist, eine Vertretung auf diesen User ein.
<note tip>Wird als Wert "profile" (ohne "") übergeben, so versucht der Handler den Vertreter aus dem [[software:tim:user_profile_properties|Userprofile]] zu holen.</note>

\\ == action ==
Sollte der Wert "action=remove" gesetzt werden, so sucht TIM sich eine Abwesenheit die mit Start und End Zeipunkt übereinstimmt und löscht diese.

\\ == takeOverExistingTasks ==
Falls "takeOverExistingTasks=true" angegeben wird, werden für diese Abwesenheit alle **bestehenden** Aufgaben auf den Vertreter umgeschrieben. Für diese Umschreibung muss der [[software:tim:timer:handleactualabsences|HandleActualAbsences-Timer]] eingerichtet sein und laufen.

\\ == datePattern ==
Sollten die Datumsangaben nicht mit dem Datepicker gemacht worden sein oder nicht dem Format "yyyy-MM-dd" entsprechen, kann dies mit hier angepasst werden.

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