... |
... |
@@ -2,7
+2,7 @@ |
2 |
2 |
|
3 |
3 |
== Funktionalitäten == |
4 |
4 |
|
5 |
|
-* **Sofortige Inforamtion** |
|
5 |
+* **Sofortige Benachrichtigung** |
6 |
6 |
Über die IMAP-Schnittstelle werden Sie sofort über neue oder geänderte Formular-Eingänge informiert |
7 |
7 |
|
8 |
8 |
* **Konfigurierbarer Inhalt** |
... |
... |
@@ -17,12
+17,19 @@ |
17 |
17 |
* **Verwalten von Formular-Eingängen** |
18 |
18 |
Neben der eigentlichen Anzeige stehen Ihnen auch die Möglichkeiten der Verwaltung von Formular-Eingängen zur Verfügung. So wird ein Formular-Eingang beim Verschieben einen Ordner in da entsprechenden {{formcycle/}}-Postfach verschoben. Ferner wird der Gelesen-Status ebenso synchronisiert. Das Löschen von Formular-Eingängen ist bei entsprechender Berechtigung ebenso durch das Löschen der zugehörigen Nachricht oder das Verschieben in den Papierkorb möglich. Fehlt diese Berechtigung, taucht die Nachricht nach wenigen Sekunden wieder in Ihrem E-Mail-Programm auf. |
19 |
19 |
|
|
20 |
+Der zur Verfügung gestellte SMTP-Server ist aktuell ohne Funktionalität, sodass abgesendete Nachrichten von diesem komplett verworfen werden. |
|
21 |
+ |
20 |
20 |
== Installation und Konfiguration == |
21 |
21 |
|
22 |
22 |
=== Installation === |
23 |
23 |
|
24 |
|
-Die Installation des Plugins ist über die dafür vorgesehene Verwaltungsoberfläche von Plugins durchzuführen. Hierbei muss lediglich die entsprechende jar-Datei eingespielt werden. Es macht ferner Sinn das IMAP-Plugin als System-Plugin zu installieren, da es sonst ggf. zu Mehrfachelegung der entsprechenden Ports durch den Server kommen könnte. Ferner kann die erste Installation je nach Anzahl von Formular-Eingängen auf Grund einer kompletten Aufbereitung der Daten für den IMAP-Server mehrere Minuten andauern. |
|
26 |
+Die Installation des Plugins ist über die dafür vorgesehene Verwaltungsoberfläche von Plugins durchzuführen. Hierbei muss lediglich die entsprechende jar-Datei eingespielt werden. Ferner kann die erste Installation je nach Anzahl von Formular-Eingängen auf Grund einer kompletten Aufbereitung der Daten für den IMAP-Server mehrere Minuten andauern. |
25 |
25 |
|
|
28 |
+{{info}} |
|
29 |
+Da das IMAP-Plugin bei der Anmeldung und dem Ausliefern von Nachrichten keine Unterscheidung trifft unter welchem Mandant dies installiert ist und somit immer allen Benutzern zur Verfügung steht, ist anzuraten dies als System-Plugin zu installieren. Dies umgeht auch mögliche Probleme mit doppelt belegten Ports und ermöglicht eine zentralere Konfiguration. |
|
30 |
+{{/info}} |
|
31 |
+ |
|
32 |
+ |
26 |
26 |
=== Konfiguration des Plugins === |
27 |
27 |
|
28 |
28 |
{{figure image="config_de.png"}} |
... |
... |
@@ -36,40
+36,42 @@ |
36 |
36 |
==== Konfiguration Mail-Server Service ==== |
37 |
37 |
|
38 |
38 |
|
39 |
|
-* **smtp.binding.address** |
40 |
|
-Gibt die zu verwendende IP-Adresse des SMPT-Servers an. Der Wert ist hierbei standardmäßig 0.0.0.0 und verwendet hier ein automatisch ermittelte IP. Eine Änderung dieses Wertes ist nur nötig falls mehrere Netzwerk-Adapter im Einsatz sind und/oder die automatische Ermittlung fehlschlägt. |
|
46 |
+* **smtp.binding.address** (Standard: 0.0.0.0) |
|
47 |
+Gibt die zu verwendende IP-Adresse des SMPT-Servers an. Der Standardwert ist 0.0.0.0 und verwendet damit eine automatisch ermittelte IP. Eine Änderung dieses Wertes ist nur nötig falls mehrere Netzwerk-Adapter im Einsatz sind und/oder die automatische Ermittlung fehlschlägt. |
41 |
41 |
|
42 |
|
-* **smtp.binding.port** |
43 |
|
-Gibt den zu verwendenten Port des SMPT-Servers an. Der Standardwert ist hierbei 25 und sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht. |
|
49 |
+* **smtp.binding.port** (Standard: 25) |
|
50 |
+Gibt den zu verwendenten Port des SMPT-Servers an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht. |
44 |
44 |
|
45 |
|
-* **imap.binding.address** |
46 |
|
-Gibt die zu verwendende IP-Adresse des IMAP-Servers an. Der Wert ist hierbei standardmäßig 0.0.0.0 und verwendet damit ebenfalls eine automatisch ermittelte IP. Eine Änderung dieses Wertes ist nur nötig falls mehrere Netzwerk-Adapter im Einsatz sind und/oder die automatische Ermittlung fehlschlägt. |
|
52 |
+* **imap.binding.address** (Standard: 0.0.0.0) |
|
53 |
+Gibt die zu verwendende IP-Adresse des IMAP-Servers an. Der Standardwert ist 0.0.0.0 und verwendet damit ebenfalls eine automatisch ermittelte IP. Eine Änderung dieses Wertes ist nur nötig falls mehrere Netzwerk-Adapter im Einsatz sind und/oder die automatische Ermittlung fehlschlägt. |
47 |
47 |
|
48 |
|
-* **imap.binding.port** |
49 |
|
-Gibt den zu verwendenten Port des IMAP-Servers an. Der Standardwert ist hierbei 143 und sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht. |
|
55 |
+* **imap.binding.port** (Standard: 143) |
|
56 |
+Gibt den zu verwendenten Port des IMAP-Servers an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht. |
50 |
50 |
|
51 |
51 |
{{id name="message_files_config"/}} |
52 |
52 |
|
53 |
53 |
==== Konfiguration Mail Message ==== |
54 |
54 |
|
55 |
|
-* **mail.to.template** |
56 |
|
-Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Empfänger benutzt werden soll. Standard: mail_to.txt |
57 |
57 |
|
58 |
|
-* **mail.from.template** |
59 |
|
-Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Absender benutzt werden soll. Standard: mail_from.txt |
|
63 |
+* **mail.to.template** (Standard: mail_to.txt) |
|
64 |
+Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Empfänger benutzt werden soll. |
60 |
60 |
|
61 |
|
-* **mail.subject.template** |
62 |
|
-Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Betreff benutzt werden soll. Standard: mail_subject.txt |
|
66 |
+* **mail.from.template** (Standard: mail_from.txt) |
|
67 |
+Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Absender benutzt werden soll. |
63 |
63 |
|
64 |
|
-* **mail.body.template** |
65 |
|
-Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Inhalt benutzt werden soll. Standard: mail_body.txt |
|
69 |
+* **mail.subject.template** (Standard: mail_subject.txt) |
|
70 |
+Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Betreff benutzt werden soll. |
66 |
66 |
|
|
72 |
+* **mail.body.template** (Standard: mail_body.txt) |
|
73 |
+Gibt den Namen der Datei an welche unter den Mandant/Projekt-Ressourcen gesucht und als Vorlage für den E-Mail-Inhalt benutzt werden soll. |
|
74 |
+ |
67 |
67 |
=== Konfiguration der E-Mail-Inhalte und Felder === |
68 |
68 |
|
69 |
69 |
Die Konfiguration der Inhalte und Felder der eigentlichen Nachricht benutzt einen Vorlagen-Mechanismus basierend auf den vier unter [[Konfiguration Mail Message>>||anchor="message_files_config"]] benannten Dateien. Diese werden bei der Installation des Plugins als Mandant-Datei eingespielt und bei der Synchronisation der Nachrichten benutzt. Um eine Projekt-spezifische Anzeige zu gewährleisten ist es möglich gleich benannte Dateien manuell als Projekt-Resource anzulegen und somit die Mandant-Dateien zu überlagern. In allen Dateien ist hierbei der [[Platzhalter>>doc:Formcycle.UserInterface.Variables||target="_blank"]]-Mechanismus aktiv, sodass hier Daten des Formular-Eingangs ausgegeben werden können. Ebenso ist es hierrüber möglich z.B. Link zur Anzeige des ausgefüllten Formulars zu erzeugen. |
70 |
70 |
|
71 |
71 |
* **Inhalt** (mail_body.txt) |
72 |
|
-Definiert den Inhalt der E-Mail-Nachricht. Hier besteht als einziges die Möglichkeit HTML zu hinterlegen. Beispiel: |
|
80 |
+Definiert den Inhalt der E-Mail-Nachricht. Hier besteht als einziges die Möglichkeit HTML zu hinterlegen. |
|
81 |
+//Beispiel: // |
73 |
73 |
{{code language="html"}}<html> |
74 |
74 |
<head></head> |
75 |
75 |
<body> |
... |
... |
@@ -78,22
+78,26 @@ |
78 |
78 |
</html>{{/code}} |
79 |
79 |
|
80 |
80 |
* **Betreff** (mail_subject.txt) |
81 |
|
-Definiert den Betreff der Nachricht. Beispiel: |
82 |
|
-{{code language="none"}}ID: [%$RECORD_ID%] - [%$STATUS_NAME%]{{/code}} |
|
90 |
+Definiert den Betreff der Nachricht. |
|
91 |
+//Beispiel: //{{code language="none"}}ID: [%$RECORD_ID%] - [%$STATUS_NAME%]{{/code}} |
83 |
83 |
|
84 |
84 |
* **Empfänger** (mail_to.txt) |
85 |
|
-Definiert den Empfänger der Nachricht. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf den eigentlichen Empfang der Nachricht. Beispiel: |
86 |
|
-{{code language="none"}}XIMA FORMCYCLE <no-reply@example.com>{{/code}} |
|
94 |
+Definiert den Empfänger der Nachricht. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf den eigentlichen Empfang der Nachricht. |
|
95 |
+//Beispiel: //{{code language="none"}}XIMA FORMCYCLE <no-reply@example.com>{{/code}} |
87 |
87 |
|
88 |
88 |
* **Absender** (mail_from.txt) |
89 |
|
-Definiert den Absender der Nachricht. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf das Absenden derNachricht. Beispiel: |
90 |
|
-{{code language="none"}}[%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com>{{/code}} |
|
98 |
+Definiert den Absender der Nachricht. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf das Absenden derNachricht. |
|
99 |
+//Beispiel: //{{code language="none"}}[%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com>{{/code}} |
91 |
91 |
|
92 |
92 |
=== Konfiguration der E-Mail-Programme === |
93 |
93 |
|
94 |
|
-Für die Konfiguration des E-Mail-Programms sind neben der Adresse des Servers die unter [[Konfiguration Mail-Server Service>>||anchor="server_config"]] hinerlegten Ports zu verwenden. Ferner setzten sich die Anmeldedaten wie folgt zusammen: |
|
103 |
+Für die Konfiguration des E-Mail-Programms sind neben der Adresse des Servers die unter [[Konfiguration Mail-Server Service>>||anchor="server_config"]] hinerlegten Ports zu verwenden. Die kompletten zu verwendenden Anmeldedaten setzen sich demnach wie folgt zusammen: |
95 |
95 |
|
96 |
|
-* **Benutzername:** <FORMCYCLE-Benutzer>@<FORMCYCLE-Mandantname> |
97 |
|
-* **Passwort:** <FORMCYCLE-Benutzer-Passwort> |
|
105 |
+* **SMPT-Server:** //<Server-Adresse>// |
|
106 |
+* **SMPT-Port:** //siehe //[[Konfiguration Mail-Server Service>>||anchor="server_config"]] |
|
107 |
+* **IMAP-Server:** //<Server-Adresse>// |
|
108 |
+* **IMAP-Port:** //siehe //[[Konfiguration Mail-Server Service>>||anchor="server_config"]] |
|
109 |
+* **Benutzername:** //<FORMCYCLE-Benutzer>@<FORMCYCLE-Mandantname>// |
|
110 |
+* **Passwort:** //<FORMCYCLE-Benutzer-Passwort>// |
98 |
98 |
|
99 |
99 |
|