Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
software:tim:actionhandler:manageabsencehandler [2014/09/11 08:20] stefan.barth angelegt |
software:tim:actionhandler:manageabsencehandler [2021/07/01 09:52] (aktuell) |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ====== ManageAbsenceHandler ====== | ||
==== Beschreibung ==== | ==== Beschreibung ==== | ||
- | Bitte hier eine entsprechende Beschreibung einfügen! | + | 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 ==== | ==== Klasse ==== | ||
<code> | <code> | ||
- | com.dooris.bpm.actionhandler.http://stefan.tim-bpm.de/apache/log.log | + | com.dooris.bpm.actionhandler.ManageAbsenceHandler |
</code> | </code> | ||
\\ | \\ | ||
Zeile 17: | Zeile 18: | ||
---- | ---- | ||
==== Parameter ==== | ==== Parameter ==== | ||
+ | <note important>Alle Parameter müssen über eine Prozessvariable angegeben werden.</note> | ||
+ | |||
== start == | == 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 angepasst werden. | + | 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 == | \\ == 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 angepasst werden. | + | 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 == | \\ == user == | ||
- | Erklärung (siehe [[#Beispiel]]). Mögliche Optionen sind: | + | In dieser Variable muss der Name des Users oder dessen E-Mailadresse stehen, der als Abwesend eingetragen werden soll. |
- | *eins | + | |
- | *zwei | + | |
- | <note tip>Optionale Parameter</note> | + | <note tip>Folgende Parameter sind optional</note> |
\\ == representative == | \\ == 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 == | \\ == action == | ||
- | remove | + | Sollte der Wert "action=remove" gesetzt werden, so sucht TIM sich eine Abwesenheit die mit Start und End Zeipunkt übereinstimmt und löscht diese. |
- | \\ == datePattern == | + | |
- | >> **Achtung!** Hier steht eine Warnung! | + | \\ == 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 ==== | ==== Beispiel ==== | ||
- | Bitte ein Beispiel einfügen, MIT Screenshot! | + | {{:software:tim:actionhandler:manageAbsenceHandler.png}} |
- | ---- | ||
- | ==== Abhängigkeiten ==== | ||
- | \\ __Timer__: [[software:tim:timer:|ERSETZMICH]] |