Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
Beide Seiten der vorigen Revision Vorhergehende Überarbeitung Nächste Überarbeitung | Vorhergehende Überarbeitung Nächste Überarbeitung Beide Seiten der Revision | ||
software:tim:timer:signalbymailreply [2017/12/07 16:01] Philipp Deycke [Parameter] |
software:tim:timer:signalbymailreply [2017/12/07 16:58] Philipp Deycke [Ablauf] |
||
---|---|---|---|
Zeile 51: | Zeile 51: | ||
== 3. port == | == 3. port == | ||
- | Port, passend zur E-Mailadresse und dem Host. | + | Port, passend zur Email-Adresse und dem Host. |
Häufige Ports: | Häufige Ports: | ||
110 //Pop// | 110 //Pop// | ||
Zeile 84: | Zeile 84: | ||
== 8. signalSuccessMail == | == 8. signalSuccessMail == | ||
- | Bei true wird auch bei erfolgreichem Signal eine Antwortmail an den Absender geschickt. Die Antwort kann mit Variablen im Prozess konfiguriert werden. Siehe [[:software:tim:timer:signalbymailreply#variablen|unten]]. | + | Bei //true// wird auch bei erfolgreichem Signal eine Antwortmail an den Absender geschickt. Die Antwort kann mit Variablen im Prozess konfiguriert werden. Siehe [[:software:tim:timer:signalbymailreply#variablen|unten]]. |
== 9. processVariable == | == 9. processVariable == | ||
Zeile 127: | Zeile 127: | ||
>> //lastUserNameLast//, Nachname des Users der die Node beendet hat. Nur bei Signal-versuchen die nach Abschluss der Node versucht werden | >> //lastUserNameLast//, Nachname des Users der die Node beendet hat. Nur bei Signal-versuchen die nach Abschluss der Node versucht werden | ||
>> //lastUserNameFirst//, Vorname des Users der die Node beendet hat. Nur bei Signal-versuchen die nach Abschluss der Node versucht werden | >> //lastUserNameFirst//, Vorname des Users der die Node beendet hat. Nur bei Signal-versuchen die nach Abschluss der Node versucht werden | ||
- | Nach dem Signal sind folgende Variablen Verfügbar: //nodename//-lastActor //nodename//-signalDateTime (Format: "yyyy-MM-dd HH:mm:ss") | + | Nach dem Signal sind folgende Variablen verfügbar: //nodename//-lastActor //nodename//-signalDateTime (Format: "yyyy-MM-dd HH:mm:ss") |
---- | ---- | ||
Zeile 133: | Zeile 133: | ||
==== Ablauf ==== | ==== Ablauf ==== | ||
- | Zuerst wird auf das im Timer angegeben Postfach geöffnet und die Mails abgeholt. Standardmäßig wird der Ordner //Inbox// abgeholt, was aber in den loom.properties mit dem Parameter //inbox-name-signal-by-mail-reply// konfiguriert werden kann.\\ | + | Zuerst wird das Postfach geöffnet, welches im Timer hinterlegt wurde und die Mails abgeholt. Standardmäßig wird der Ordner //Inbox// abgeholt, dies kann aber in den loom.properties mit dem Parameter //inbox-name-signal-by-mail-reply// konfiguriert werden.\\ |
- | Dann werden die ersten 5 gefunden Mails abgearbeitet. Die Anzahl kann über den Parameter //inbox-name-signal-by-mail-reply// in den loom.properties konfiguriert werden. In jeder Mail wird zuerst im Inhalt und dann im Betreff nach einem Text in der Form —–(1234)—– gesucht. Dabei handelt es sich um die TIM-Prozessinstanz-ID.\\ | + | Danach werden die ersten 5 gefunden Mails abgearbeitet. Die Anzahl kann über den Parameter //inbox-name-signal-by-mail-reply// in den loom.properties konfiguriert werden. In jeder Mail wird zuerst im Inhalt und dann im Betreff nach einem Text in der Form wie —–(1234)—– gesucht. Dabei handelt es sich um die TIM-Prozessinstanz-ID.\\ |
- | Wird keine Instanzid gefunden oder zu der Id keine Prozessinstanz in TIM gefunden, Wird die Nachricht ignoriert.\\ | + | Lässt sich keine Prozessinstanz-ID oder zu der ID keine Prozessinstanz in TIM finden, wird die Nachricht ignoriert.\\ |
- | Im nächsten Schritt wird mit der Absende-E-Mail ein TIM-User gesucht. Wird keiner gefunden, erhält der Absender eine entsprechende Mail.\\ | + | Im nächsten Schritt wird mit der Absende-Email ein TIM-User gesucht. Sollte kein User gefunden werden, erhält der Absender eine entsprechende Mail.\\ |
- | Nun wird mit der [[:software:tim:timer:signalbymailreply#nodenameregexp|NodeNameRegExp]] der Name einer Aktivität im Mailtext und dann im Betreff gesucht. Wird eine Name gefunden, wird geprüft ob die gefundene Prozessinstanz von der übergebenen [[:software:tim:timer:signalbymailreply#pdname|Prozessdefinition]] ist. Ist das nicht der Fall Ist die Mail nicht für diesen Timer bestimmt und auch diese Nachricht wird ignoriert. Es gibt keine Antwortmail.\\ | + | Nun sucht der Timer mit der [[:software:tim:timer:signalbymailreply#nodenameregexp|NodeNameRegExp]] nach dem Namen einer Aktivität im Mailtext und darauf im Betreff. Ist ein Name gefunden worden wird geprüft, ob die gefundene Prozessinstanz von der übergebenen [[:software:tim:timer:signalbymailreply#pdname|Prozessdefinition]] stammt. Sollte dies nicht der Fall sein war die Mail nicht für diesen Timer bestimmt und auch diese Nachricht wird ignoriert. Es gibt keine Antwortmail.\\ |
- | Ist dieser Timer für diese Mail zuständig, wird geprüft ob der Prozess an der richtigen Aktivität steht. Ist das der Fall wird die Mail als Notiz an die Aktivität angehängt. Wenn der Prozess schon weitergeleitet ist bekommt der Absender eine entsprechende Nachricht.\\ | + | Sollte dieser Timer für die Mail zuständig sein, wird geprüft, ob der Prozess an der richtigen Aktivität steht. Ist dies der Fall, wird die Mail als Notiz an die Aktivität angehängt. Wenn der Prozess schon weitergeleitet wurde bekommt der Absender eine entsprechende Nachricht.\\ |
- | Jetzt wird geprüft ob der TIM-User der die E-Mail geschickt hat, für eine der Tasks auf der aktuellen Aktivität zuständig ist. Ist das nicht der Fall wird er informiert.\\ | + | Jetzt wird geprüft, ob der TIM-User der die E-Mail geschickt hat, für eine der Tasks auf der aktuellen Aktivität zuständig ist. Ist das nicht der Fall wird er informiert.\\ |
- | Nun wird geprüft ob es mehrere Folgeaktivitäten gibt. Ist es nur eine vorhanden, wird der User als Actor auf den Aufgaben der Aktivität gesetzt. Gibt es mehrere Möglichkeiten den Prozess fortzusetzen wird geprüft ob die Mail eine [[:software:tim:timer:signalbymailreply#leavingtransition|Entscheidung]] dazu enthält.\\ | + | Nun wird geprüft, ob es mehrere Folge-Aktivitäten gibt. Sollte nur eine vorhanden sein, wird der User als Actor auf die Aufgaben der Aktivität gesetzt. Gibt es mehrere Möglichkeiten den Prozess fortzusetzen wird geprüft, ob die Mail eine [[:software:tim:timer:signalbymailreply#leavingtransition|Entscheidung]] dazu enthält.\\ |
- | Dann wird auch in diesem Fall der User Actor auf den Task. Jetzt werden Prozessvariablen gesetzt und der Prozess weiter geschickt. Wenn [[:software:tim:timer:signalbymailreply#signalsuccessmail|gewünscht]] wird auch dann eine Antwort verschickt.\\ | + | Dann wird auch in diesem Fall der User Actor auf den Task. Jetzt werden Prozessvariablen gesetzt und der Prozess weiter geschickt. Falls [[:software:tim:timer:signalbymailreply#signalsuccessmail|gewünscht]] wird auch dann eine Antwort verschickt.\\ |
- | Alle Mails die beantwortet wurden, werden, wenn er vorhanden ist, in den Ordner errorMessages verschoben. Die Mail die den Prozess weitergeschickt hat wird in den [[:software:tim:timer:signalbymailreply#movefolder|konfigurierten]] Ordner verschoben. | + | Alle Mails die beantwortet wurden, werden, falls vorhanden, in den Ordner errorMessages verschoben. Die Mail, die den Prozess weitergeschickt hat wird in den [[:software:tim:timer:signalbymailreply#movefolder|konfigurierten]] Ordner verschoben. |
- | <note important>Derjenige der auf die Email antwortet, muss entweder direkter Bearbeiter der Aufgabe sein oder sich in der aktuell eingetragenen Gruppe befinden.</note> | + | <note important>Derjenige, der auf die Email antwortet, muss entweder direkter Bearbeiter der Aufgabe sein oder sich in der aktuell eingetragenen Gruppe befinden.</note> |
---- | ---- |