Benutzer-Werkzeuge

Webseiten-Werkzeuge


Plugin installed incorrectly. Rename plugin directory 'swiftmail.backup' to 'swiftmail'.
software:tim:mail_configuration

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
software:tim:mail_configuration [2017/01/10 18:37]
semen.bortnik
software:tim:mail_configuration [2021/07/01 09:52] (aktuell)
Zeile 1: Zeile 1:
-====Task- und Gruppen Emails anpasssen====+==== Task- und Gruppen Emails anpasssen ====
  
-Es ist möglich die von TIM verschickten Emails, die z.B. über neue Aufgaben informieren,​ anzupassen. Der Text kann beliebig geändert werden. +Es ist möglich die von TIM verschickten Emails, die z.B. über neue Aufgaben informieren,​ anzupassen. Der Text kann beliebig geändert werden. Dafür muss die Datei **[[:​software:​tim:​tim.properties|]]** mit einem Textbearbeitungsprogramm geöffnet werden. Diese Datei befindet sich unter folgender Ordnerstruktur:​<​code>​ 
-Dafür muss die Datei **[[tim.properties]]** ​ mit einem Textbearbeitungsprogramm geöffnet werden. Diese Datei befindet sich unter folgender Ordnerstruktur:​+...\standalone\configuration\ 
 +</​code>​
  
-  ...\standalone\configuration\ +Alle Mailtexte können entweder normalen Text enthalten oder auch als [[:​software:​tim:​mail_configuration#​html-taskmails|HTML-Mails]] versendet werden.
-   +
-Alle Mailtexte können entweder normalen Text enthalten oder auch als [[:​software:​tim:​mail_configuration#​html-taskmails| HTML-Mails]] versendet werden.+
  
-------+----
  
 == Notification Mails == == Notification Mails ==
  
 Unter dem Punkt **Notification Mails** können die Benachrichtigungs Mails über erledigte Aufgaben angepasst werden. Unter dem Punkt **Notification Mails** können die Benachrichtigungs Mails über erledigte Aufgaben angepasst werden.
-  * **notification-assignee-mail-subject** : Ändert den Betreff der Mail 
-  * **notification-assignee-mail-text** : Ändert den Text dieser Mail 
  
 +   * **notification-assignee-mail-subject** ​ : Ändert den Betreff der Mail
 +  * **notification-assignee-mail-text** ​ : Ändert den Text dieser Mail
 +----
  
-------+== Archivation ==
  
-==Archivation== 
 Unter diesem Punkt können die Benachrichtigungs Mails über archivierte Instanzen angepasst werden: Unter diesem Punkt können die Benachrichtigungs Mails über archivierte Instanzen angepasst werden:
-  ***archivation-mail-subject** : Ändert den Betreff der Mail 
-  ***archivation-mail-text** : Ändert den Text dieser Mail 
  
 +  * **archivation-mail-subject** ​ : Ändert den Betreff der Mail
 +  * **archivation-mail-text** ​ : Ändert den Text dieser Mail
 +----
  
-------+== Reaktivierung(Unarchivation) ==
  
-==Reaktivierung(Unarchivation)== 
 Unter diesem Punkt können die Benachrichtigungs Mails über reaktivierte Instanzen angepasst werden: Unter diesem Punkt können die Benachrichtigungs Mails über reaktivierte Instanzen angepasst werden:
-  ***unarchivation-mail-subject** : Ändert den Betreff der Mail 
-  ***unarchivation-mail-text** : Ändert den Text dieser Mail 
  
-------+  * **unarchivation-mail-subject** ​ : Ändert den Betreff der Mail 
 +  * **unarchivation-mail-text** ​ : Ändert den Text dieser Mail 
 +----
  
-==Adhoc== +== Adhoc ==
-Unter diesem Punkt können die Benachrichtigungs Mails über [[:​software:​tim:​ad_hoc_tasks | AdHoc]] angepasst werden. +
-  * **notification-adhoc-close-subject** : Ändert den Betreff der Mail +
-  * **notification-adhoc-close-text** : Ändert den Text dieser Mail+
  
-------+Unter diesem Punkt können die Benachrichtigungs Mails über [[:​software:​tim:​ad_hoc_tasks|AdHoc]] angepasst werden.
  
-==Wieder eröffnetes Adhoc== +  ​* **notification-adhoc-close-subject** ​ : Ändert den Betreff der Mail 
-Unter diesem Punkt können die Benachrichtigungs Mails über reaktivierte [[:​software:​tim:​ad_hoc_tasks | AdHoc]] angepasst werden. +  * **notification-adhoc-close-text** ​ : Ändert den Text dieser Mail 
-  ​* **notification-adhoc-reopen-close-subject** : Ändert den Betreff der Mail +----
-  * **notification-adhoc-reopen-close-text** : Ändert den Text dieser Mail+
  
-------+== Wieder eröffnetes Adhoc == 
 + 
 +Unter diesem Punkt können die Benachrichtigungs Mails über reaktivierte [[:​software:​tim:​ad_hoc_tasks|AdHoc]] angepasst werden. 
 + 
 +  * **notification-adhoc-reopen-close-subject** ​ : Ändert den Betreff der Mail 
 +  * **notification-adhoc-reopen-close-text** ​ : Ändert den Text dieser Mail 
 +---- 
 + 
 +== Prozess-begleit-Dokumente ==
  
-==Prozess-begleit-Dokumente== 
 Unter diesem Punkt können die Benachrichtigungs Mails über neue an den Prozess angehängte Notizen angepasst werden. Unter diesem Punkt können die Benachrichtigungs Mails über neue an den Prozess angehängte Notizen angepasst werden.
-  * **business-obj-message-subject-en** : Ändert dem englischen Betreff dieser Mail 
-  * **business-obj-message-de** : Ändert den deutschen Text dieser Email 
-  * **business-obj-message-en** : Ändert den englischen Text dieser Email 
-  * **business-obj-recipient-label-de** : Ändert das deutsche Empfänger-Label 
-  * **business-obj-recipient-label-en** : Ändert das englische Empfänger-Label 
  
-------+  * **business-obj-message-subject-en** ​ : Ändert dem englischen Betreff dieser Mail 
 +  * **business-obj-message-de** ​ : Ändert den deutschen Text dieser Email 
 +  * **business-obj-message-en** ​ : Ändert den englischen Text dieser Email 
 +  * **business-obj-recipient-label-de** ​ : Ändert das deutsche Empfänger-Label 
 +  * **business-obj-recipient-label-en** ​ : Ändert das englische Empfänger-Label 
 +----
  
-==Taskmail== +== Taskmail ==
-Hier können die Mailtexte angepasst werden, die verschickt werden wenn einem Mitarbeiter oder einer Gruppe eine neue Aufgabe zugewiesen wird. +
-  * **taskmail-subject** : Ändert den Betreff der Mail +
-  * **taskmail-text** : Ändert den Text dieser Mail +
-  * **group-taskmail-subject** Ändert den Betreff dieser Mail +
-  * **group-taskmail-text** Ändert den Text dieser Mail+
  
 +Hier können die Mailtexte angepasst werden, die verschickt werden wenn einem Mitarbeiter oder einer Gruppe eine neue Aufgabe zugewiesen wird.
  
 +  * **taskmail-subject** ​ : Ändert den Betreff der Mail
 +  * **taskmail-text** ​ : Ändert den Text dieser Mail
 +  * **group-taskmail-subject** ​ Ändert den Betreff dieser Mail
 +  * **group-taskmail-text** ​ Ändert den Text dieser Mail
 Der Text der Emails, die von dem System verschickt werden und an noch nicht erledigte Aufgaben zu erinnern können ebenfalls angepasst werden Der Text der Emails, die von dem System verschickt werden und an noch nicht erledigte Aufgaben zu erinnern können ebenfalls angepasst werden
-  * **taskreminder-subject** : Ändert den Betreff der Mail 
-  * **taskreminder-text** : Ändert den Text dieser Mail 
  
 +  * **taskreminder-subject** ​ : Ändert den Betreff der Mail
 +  * **taskreminder-text** ​ : Ändert den Text dieser Mail
 Der Text der Emails, die vom System verschickt werden um an noch nicht erledigte Nodes zu errinern, können ebenfalls angepasst werden Der Text der Emails, die vom System verschickt werden um an noch nicht erledigte Nodes zu errinern, können ebenfalls angepasst werden
-  * **nodereminder-text** : Ändert den Betreff der Mail 
-  * **nodereminder-subject** Ändert den Text der Mail 
  
-------+  * **nodereminder-text** ​ : Ändert den Betreff der Mail 
 +  * **nodereminder-subject** ​ Ändert den Text der Mail 
 +---- 
 + 
 +== Mail-nicht-verschickt ==
  
-==Mail-nicht-verschickt== 
 Der Text der Email, die verschickt wird, wenn eine Email nicht verschickt werden konnte kann ebenfalls geändert werden: Der Text der Email, die verschickt wird, wenn eine Email nicht verschickt werden konnte kann ebenfalls geändert werden:
-  * **mail-not-sent-subject** Ändert den Betreff der Mail 
-  * **mail-not-sent-text** Ändert den Text der Mail 
  
-------+  * **mail-not-sent-subject** ​ Ändert den Betreff der Mail 
 +  * **mail-not-sent-text** ​ Ändert den Text der Mail 
 +----
  
-==Eskalation== +== Eskalation ==
-Die Mails die bei der [[:​software:​tim:​escalation | Eskalation]] eines Prozesses verschickt werden können ebenfalls angepasst werden+
  
-  * **escalation-email-subject** : Ändert den Betreff ​der Mail +Die Mails die bei der [[:software:​tim:​escalation|Eskalation]] eines Prozesses verschickt werden können ebenfalls angepasst werden
-  * **escalation-email-message** ​Ändert den Text dieser Mail+
  
 +  * **escalation-email-subject** ​ : Ändert den Betreff der Mail
 +  * **escalation-email-message** ​ : Ändert den Text dieser Mail
 +----
  
-------+== Variablen in Mailtexten verwenden ==
  
-== Variablen in Mailtexten verwenden == +Der Text einer Emailbenachrichtigung kann mit Systemvariablen angereichert werden. Diese werden bei der Anzeige mit den entsprechenden Werten befüllt. Das folgende Beispiel zeigt deren Verwendung in einem Mailtext.<​code>​
-Der Text einer Emailbenachrichtigung kann mit Systemvariablen angereichert werden. Diese werden bei der Anzeige mit den entsprechenden Werten befüllt. Das folgende Beispiel zeigt deren Verwendung in einem Mailtext. +
-<​code>​+
 Hallo, Hallo,
 überprüfen Sie bitte die an die Aufgabe ${SYS.TASK_NAME} angehängten Dokumente auf Korrektheit. überprüfen Sie bitte die an die Aufgabe ${SYS.TASK_NAME} angehängten Dokumente auf Korrektheit.
Zeile 100: Zeile 102:
 Vielen Dank. Vielen Dank.
 </​code>​ </​code>​
-Die Variablen **${SYS.TASK_NAME}** und **${SYS.PROCESSINSTANCE_NAME}** werden im Mailtext durch den zugehörigen Aufgabennamen bzw. Instanznamen ersetzt. Eine vollständige Liste der verfügbaren Systemvariablen finden Sie auf der [[faq:​variableshelper|Variable Helper-Seite]].+ 
 +Die Variablen **${SYS.TASK_NAME}** ​ und **${SYS.PROCESSINSTANCE_NAME}** ​ werden im Mailtext durch den zugehörigen Aufgabennamen bzw. Instanznamen ersetzt. Eine vollständige Liste der verfügbaren Systemvariablen finden Sie auf der [[:faq:​variableshelper|Variable Helper-Seite]].
  
 ---- ----
  
 +==== HTML-Taskmails ====
  
-==== HTML-Taskmails ==== +[[:software:​tim:​tim.properties#​mails|HTML-Taskmails]] können verwendet werden um den Mailinhalt aufzubereiten. Neben der Möglichkeit einfache Textlinks einzubetten können hier bspw. auch Bilder etc. verwendet werden. Dies ist bei herkömmlichen Task-Mails nicht möglich. Um HTML-Mails zu ermöglichen,​ muss der Parameter taskmail-text mit folgenden Wert beginnen:<​code>​
-[[software:​tim:​tim.properties#​Mails|HTML-Taskmails]] können verwendet werden um den Mailinhalt aufzubereiten. Neben der Möglichkeit einfache Textlinks einzubetten können hier bspw. auch Bilder etc. verwendet werden. Dies ist bei herkömmlichen Task-Mails nicht möglich. Um HTML-Mails zu ermöglichen,​ muss der Parameter taskmail-text mit folgenden Wert beginnen: +
-<​code>​+
 <​html><​head><​meta http-equiv="​Content-Type"​ content="​text/​html;​ charset=UTF-8"></​head><​body>​ <​html><​head><​meta http-equiv="​Content-Type"​ content="​text/​html;​ charset=UTF-8"></​head><​body>​
 </​code>​ </​code>​
- 
  
 **Beispiel:​** **Beispiel:​**
-<​code ​html>+ 
 +<​code ​html4strict>
 taskmail-text=<​html><​head><​meta http-equiv="​Content-Type"​ content="​text/​html;​ charset=UTF-8"></​head><​body>​Sie haben eine neue Aufgabe: ${taskName} <​br/> ​ im Prozess: ${processDefinitionName} erhalten. <br/> \nn\nDirekt zur Aufgabe: <a href="​${taskLink}">​${taskName}</​a></​body></​html>​ taskmail-text=<​html><​head><​meta http-equiv="​Content-Type"​ content="​text/​html;​ charset=UTF-8"></​head><​body>​Sie haben eine neue Aufgabe: ${taskName} <​br/> ​ im Prozess: ${processDefinitionName} erhalten. <br/> \nn\nDirekt zur Aufgabe: <a href="​${taskLink}">​${taskName}</​a></​body></​html>​
 </​code>​ </​code>​
  
- +----
------+
  
 ==== Taskmails pro Definition und Node unterschiedlich (ab v4.0) ==== ==== Taskmails pro Definition und Node unterschiedlich (ab v4.0) ====
-Es kann je Definition und/oder Node ein eigener Betreff und Mailtext benutzt werden. 
-Der Eintrag in der Datei tim.properties lautet dann wie folgt: \\  
-  taskmail-text-prozessdefinitionsname-nodename-mit-leerzeichen=Hier steht der Taskmailtext für eine bestimmte Node in einem bestimmten Prozess 
-  taskmail-subject-prozessdefinitionsname-nodename-mit-leerzeichen=Ihnen wurde die Aufgabe ${SYS.TASK_NAME} im Prozess ${SYS.PROCESSINSTANCE_NAME} zugewiesen 
  
-Es wird bei jeder Aufgabenmail versucht, einen Mailtext speziell für diese Node zu finden. Wird keiner gefunden, wird ein Mailtext ​für die Prozessdefinition gesuchtIst auch dieser nicht vorhanden, wird der Standarttext benutzt\\  +Es kann je Definition und/​oder ​Node ein eigener Betreff und Mailtext ​benutzt werdenDer Eintrag in der Datei tim.properties lautet dann wie folgt:
-Beispiel für einen individuellen Mailtext je Prozessdefinition\\  +
-  taskmail-text-prozessdefinitionsname-mit-leerzeichen=Das ist der Aufgabentext von der Prozessdefinition ${SYS.PROCESSDEFINITION_NAME} +
-  taskmail-subject-prozessdefinitionsname-mit-leerzeichen=Ihnen wurde die Aufgabe ${SYS.TASK_NAME} im Prozess ${SYS.PROCESSINSTANCE_NAME} zugewiesen+
  
-<note important>​Prozessdefinitions- und Nodename müssen **klein** geschrieben werden! Leerzeichen und Sonderzeichen werden mit einem **-** dargestellt</​note>​ +<​code>​ 
------+taskmail-text-prozessdefinitionsname-nodename-mit-leerzeichen=Hier steht der Taskmailtext für eine bestimmte Node in einem bestimmten Prozess 
 +taskmail-subject-prozessdefinitionsname-nodename-mit-leerzeichen=Ihnen wurde die Aufgabe ${SYS.TASK_NAME} im Prozess ${SYS.PROCESSINSTANCE_NAME} zugewiesen 
 +</​code>​ 
 + 
 +Es wird bei jeder Aufgabenmail versucht, einen Mailtext speziell für diese Node zu finden. Wird keiner gefunden, wird ein Mailtext für die Prozessdefinition gesucht. Ist auch dieser nicht vorhanden, wird der Standarttext benutzt. ​ Beispiel für einen individuellen Mailtext je Prozessdefinition:​ 
 + 
 +<​code>​ 
 +taskmail-text-prozessdefinitionsname-mit-leerzeichen=Das ist der Aufgabentext von der Prozessdefinition ${SYS.PROCESSDEFINITION_NAME} 
 +taskmail-subject-prozessdefinitionsname-mit-leerzeichen=Ihnen wurde die Aufgabe ${SYS.TASK_NAME} im Prozess ${SYS.PROCESSINSTANCE_NAME} zugewiesen 
 +</​code>​ 
 + 
 +<note important>​Prozessdefinitions- und Nodename müssen **klein** ​ geschrieben werden! Leerzeichen und Sonderzeichen werden mit einem **-**  dargestellt</​note>​ 
 + 
 +----
  
 ==== Mehrsprachige Emails ==== ==== Mehrsprachige Emails ====
-Abhängig von der Sprache des angemeldeten Nutzers könnnen die Mailtexte in verschiedenen Sprachen verschickt werden. Hierfür muss die Lokale des Nutzers angehängt werden: \\ 
-  de-taskmail-subject-prozessdefinitionsname-nodename = Hier steht der Betreff der Email 
-  de-taskmail-text-prozessdefinitionsname-nodename = Hier steht der Text der Email 
  
-  en-taskmail-subject-prozessdefinitionsname-nodename = This is the subject +Abhängig von der Sprache ​des angemeldeten Nutzers könnnen die Mailtexte in verschiedenen Sprachen verschickt ​werden. Hierfür muss die Lokale des Nutzers angehängt werden:
-  en-taskmail-text-prozessdefinitionsname-nodename = This is the mailtext +
-   +
-<note important>​Falls Mehrsprachigkeit im [[software:​tim:​processrepository|Process Repository]] gefplegt ist müssen Prozessdefinitions- und Nodename ​der default ​Sprache ​verwendet ​werden!</​note>​ +
------+
  
 +<​code>​
 +taskmail-subject-de-prozessdefinitionsname-nodename = Hier steht der Betreff der Email
 +taskmail-text-de-prozessdefinitionsname-nodename = Hier steht der Text der Email
 +</​code>​
 +
 +<​code>​
 +taskmail-subject-en-prozessdefinitionsname-nodename = This is the subject
 +taskmail-text-en-prozessdefinitionsname-nodename = This is the mailtext
 +</​code>​
 +
 +<note important>​Falls Mehrsprachigkeit im [[:​software:​tim:​processrepository|Process Repository]] gefplegt ist müssen Prozessdefinitions- und Nodename der default Sprache verwendet werden!</​note>​
 +
 +----
  
 ==== Taskmails (De-)aktivieren ==== ==== Taskmails (De-)aktivieren ====
-Um [[software:​tim:​taskmail|Taskmails]] für einzelne Benutzer zu deaktivieren,​ kann im [[software:​tim:​userprofil_profile|Benutzerprofil]] die Option **"​Benachrichtigung per Mail bevorzugen"​** Ein-, bzw Ausgeschalten werden. Diese Einstellung existiert auch Systemweit im [[software:​tim:​client_profile|Clientprofil]] + 
------+Um [[:software:​tim:​taskmail|Taskmails]] für einzelne Benutzer zu deaktivieren,​ kann im [[:software:​tim:​userprofil_profile|Benutzerprofil]] die Option **"​Benachrichtigung per Mail bevorzugen"​** ​ Ein-, bzw Ausgeschalten werden. Diese Einstellung existiert auch Systemweit im [[:software:​tim:​client_profile|Clientprofil]] 
 + 
 +----
  
 ==== Fehler Mails ==== ==== Fehler Mails ====
-Falls beim versenden einer Mail ein Fehler auftritt und im Client Profil das Feld "​Benachrichtigung bei Fehler"​ gepflegt ist, wird an die ausgewählte Gruppe eine Mail versendet die sich wie folgt zusammensetzt: ​\\ + 
-  mail-not-sent-subject=Mail nicht gesendet Id: ${MAIL.ID} Betreff: ${MAIL.SUBJECT} +Falls beim versenden einer Mail ein Fehler auftritt und im Client Profil das Feld "​Benachrichtigung bei Fehler"​ gepflegt ist, wird an die ausgewählte Gruppe eine Mail versendet die sich wie folgt zusammensetzt:​<​code>​ 
-  mail-not-sent-text=Beim Versand sind folgenden Probleme aufgetreten.\n\n+mail-not-sent-subject=Mail nicht gesendet Id: ${MAIL.ID} Betreff: ${MAIL.SUBJECT} 
 +mail-not-sent-text=Beim Versand sind folgenden Probleme aufgetreten.\n\n 
 +</​code>​ 
 Zusätzlich wird die Aufgetretene Exception an den Mailtext mit angehängt. Zusätzlich wird die Aufgetretene Exception an den Mailtext mit angehängt.
------+ 
 +---- 
 + 
software/tim/mail_configuration.1484069847.txt.gz · Zuletzt geändert: 2021/07/01 09:58 (Externe Bearbeitung)