Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung | ||
software:tim:actionhandler:mailbyprocessvariablehandler [2013/06/10 18:11] martin.oehm [Parameter] |
software:tim:actionhandler:mailbyprocessvariablehandler [2021/07/01 09:52] (aktuell) |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | =======MailByProcessVariableHandler======== | ||
==== Beschreibung ==== | ==== Beschreibung ==== | ||
- | Dieser [[software:tim:Actionhandler]] fällt unter die Kategorie [[software:tim:Eskalation]] und wird verwendet, um Mails z.B. an Vorgesetze zu senden, falls eine Aufgabe nicht im angegeben [[#fieldDuration|Zeitrahmen]] erledigt wurde. | + | 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> | ||
------ | ------ | ||
Zeile 10: | Zeile 17: | ||
---- | ---- | ||
==== Parameter ==== | ==== Parameter ==== | ||
- | == mailSubject == | + | ==mailSubject == |
- | Dieser Paramter gibt den Betreff der ausgehende Mail an (siehe [[#Beispiel]]) | + | Dieser Parameter bestimmt den Betreff der zu versendenden E-Mail, (siehe [[#Beispiel]]) |
- | \\ == mailText == | + | \\ ==mailText== |
- | Der Mailtext kann frei definiert werden und wird verwendet, wenn eine Eskalations Mail versendet wird. Variablen können, gekennzeichnet mit ${variablenName}, verwendet werden (siehe [[#Beispiel]]) | + | 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 == | + | \\ ==mailTo== |
- | Hier werden der oder die Empfänger der Mail angegeben (siehe [[#Beispiel]]). Mögliche Optionen sind: | + | Dieser Parameter definiert den/die Empfänger der Eskalationsmail. Dazu muss ein Variablennamen ohne # oder $ angegeben werden (siehe [[#Beispiel]]). \\ |
- | *swimlane() | + | Mögliche Inhalte der Variable sind: |
- | *group() | + | |
- | *user() | + | *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. |
- | *mail@adresse.de | + | *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! | >> **Achtung!** Eine Kombination aus diesen Möglichkeiten ist nicht möglich! | ||
Zeile 30: | Zeile 39: | ||
\\ == fieldDuration == | \\ == fieldDuration == | ||
- | Die fieldDuration gibt den Zeitpunkt an, an dem die Mail versendet werden soll, ab dem Zeitpunkt, wo der Prozess die Node betritt. Mögliche Parameter sind: | + | Die fieldDuration gibt die Zeitspanne an, an dem die Mail versendet werden soll. Mögliche Werte sind: |
- | *m (Monat) | + | |
- | *y (Jahr) | + | |
- | *w (Woche) | + | |
- | *min (Minute) | + | |
- | *ms (Millisekunden) | + | |
*s (Sekunden) | *s (Sekunden) | ||
- | BSP: 13s, 5min, 1m | + | *m (Minuten) |
+ | *h (Stunden) | ||
+ | *d (Tage) | ||
+ | *w (Wochen) | ||
+ | *mon (Monate) | ||
+ | *y (Jahre) | ||
- | >> **Achtung!** Eine Kombination aus diesen Möglichkeiten ist nicht möglich! | + | ist kombinierbar z.B. 1y 11mon 3w 2d 1h 12m 5s |
+ | (siehe [[#Beispiel]]) | ||
- | ---- | ||
+ | ---- | ||
==== Beispiel ==== | ==== Beispiel ==== | ||
- | Blablub | ||
- | ---- | + | {{ :software:tim:actionhandler:mailbyprocessvariablehandler.png }} |
- | ==== Abhängigkeiten ==== | + | |
- | \\ __Timer__: [[software:tim:timer:performEscalationForNodesTimerWithLimit]] | + | |
- | \\ __T!M Version__ : [[software:tim:changelog:3.4]] | + |