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/20 09:12] stefan.barth |
software:tim:actionhandler:mailbyprocessvariablehandler [2021/07/01 09:52] (aktuell) |
||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | =======MailByProcessVariableHandler======== | ||
==== Beschreibung ==== | ==== Beschreibung ==== | ||
- | 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:Eskalation]] in Kraft tritt (Methode handleEscalation). Er ist ab T!M Version 3.4 verfügbar. | + | 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> | ||
------ | ------ | ||
==== Klasse ==== | ==== Klasse ==== | ||
Zeile 9: | Zeile 17: | ||
---- | ---- | ||
==== Parameter ==== | ==== Parameter ==== | ||
- | ==Betreff (mailSubject) == | + | ==mailSubject == |
Dieser Parameter bestimmt den Betreff der zu versendenden E-Mail, (siehe [[#Beispiel]]) | Dieser Parameter bestimmt den Betreff der zu versendenden E-Mail, (siehe [[#Beispiel]]) | ||
- | \\ ==Text (mailText) == | + | \\ ==mailText== |
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]]) | 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]]) | ||
- | \\ ==Fester Empfänger oder aus einer Variablen auslesen (mailTo) == | + | \\ ==mailTo== |
Dieser Parameter definiert den/die Empfänger der Eskalationsmail. Dazu muss ein Variablennamen ohne # oder $ angegeben werden (siehe [[#Beispiel]]). \\ | Dieser Parameter definiert den/die Empfänger der Eskalationsmail. Dazu muss ein Variablennamen ohne # oder $ angegeben werden (siehe [[#Beispiel]]). \\ | ||
Mögliche Inhalte der Variable sind: | Mögliche Inhalte der Variable sind: | ||
Zeile 30: | Zeile 38: | ||
Kann alternativ zu mailTo benutzt werden. Hier muss eine Variable als Empfänger benutzt werden. | Kann alternativ zu mailTo benutzt werden. Hier muss eine Variable als Empfänger benutzt werden. | ||
- | \\ == Eskalationsdauer aus einer Variablen oder angegebenen Wert (fieldDuration) == | + | \\ == fieldDuration == |
- | In der Variable sind Werte im folgenden Format erlaubt: “AnzahlEinheit“.\\ | + | Die fieldDuration gibt die Zeitspanne an, an dem die Mail versendet werden soll. Mögliche Werte sind: |
- | 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: | + | |
- | *m (Monat) | + | |
- | *y (Jahr) | + | |
- | *w (Woche) | + | |
- | *min (Minute) | + | |
- | *ms (Millisekunden) | + | |
*s (Sekunden) | *s (Sekunden) | ||
+ | *m (Minuten) | ||
+ | *h (Stunden) | ||
+ | *d (Tage) | ||
+ | *w (Wochen) | ||
+ | *mon (Monate) | ||
+ | *y (Jahre) | ||
- | (siehe [[#Beispiel]]) | + | ist kombinierbar z.B. 1y 11mon 3w 2d 1h 12m 5s |
- | >> **Achtung!** Nur eine Zeiteinheit ist möglich, das heißt man kann keine Tage und Stunden kombinieren. | + | (siehe [[#Beispiel]]) |
Zeile 48: | Zeile 56: | ||
==== Beispiel ==== | ==== Beispiel ==== | ||
- | ===mailSubject=== | + | {{ :software:tim:actionhandler:mailbyprocessvariablehandler.png }} |
- | mailSubject=Erledigung von ${variable} nicht in vorgegeb. Zeit durchgeführt; | + | |
- | ===mailText=== | ||
- | Sehr geehrte Damen und Herren, \n \\ | ||
- | \n \\ | ||
- | die Erledigung der Aufgabe „Beispiel“ zum Artikel ${beispielArtikel} konnte nicht in der vorgegebenen Zeit (${beispielBearbeitungsdauer}) fertiggestellt werden. \n \\ | ||
- | \n \\ | ||
- | Beauftragter: ${beispielBeauftragter} \n \\ | ||
- | Standort: ${standort} \n \\ | ||
- | Werk: ${werk} \n \\ | ||
- | \n \\ | ||
- | Ihr T!M System; | ||
- | |||
- | ===MailTo=== | ||
- | fieldMailTo=variableZustaendigerControlling; | ||
- | |||
- | |||
- | ===fieldDuration=== | ||
- | Beispiel1: fieldDuration=bearbeitungszeitAufgabeA; \\ | ||
- | Beispiel2: fieldDuration=4m | ||
- | |||
- | |||
- | ---- | ||
- | ==== Abhängigkeiten ==== | ||
- | \\ __Timer__: [[software:tim:timer:performEscalationForNodesTimerWithLimit]] |