Wiki-Quellcode von IMAP-Plugin

Zeige letzte Bearbeiter
1 [[**Plugin-Download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/IMAP%26SMTP%20Mail-Proxy&fileid=3263||rel="noopener noreferrer" target="_blank"]] (erfordert Anmeldung)
2
3 {{content/}}
4
5 Mit dem kostenpflichtigen {{smallcaps}}Imap{{/smallcaps}}-Plugin für {{formcycle/}} besteht die Möglichkeit, Daten von Formular-Eingängen innerhalb eines E-Mail-Programms anzuzeigen, diese zu verwalten und sich sofort über neue Eingänge informieren zu lassen. Hierfür stellt dieses Plugin einen {{smallcaps}}Imap{{/smallcaps}}- und {{smallcaps}}Smtp{{/smallcaps}}-Server zur Verfügung, welcher in jedem gängigen E-Mail-Programm angebunden werden kann.
6
7 == Funktionalitäten ==
8
9 ; Sofortige Benachrichtigung
10 : Über die {{smallcaps}}Imap{{/smallcaps}}-Schnittstelle wird der Bneutzer sofort über neue oder geänderte Formulareingänge informiert.
11 ; Konfigurierbarer Inhalt
12 : Über entsprechende Vorlagen ist der Inhalt der Benachrichtigungen sowie deren Betreff-, Absender- und Empfänger-Felder frei konfigurierbar. Da hier [[Platzhalter>>doc:Formcycle.UserInterface.Variables||target="_blank"]] benutzt werden können, können neben einzelnen Werten oder Metadaten des Formulareingangs auch Links zur Wiederanzeige direkt innerhalb des Postfachs erzeugt werden.
13 ; Bereitstellung von Dateien
14 : Im Formular können Dateien hochgeladen werden und während der Statusverarbeitung werden ebenfalls manchmal Dateien erzeugt. Diese Dateien werden automatisch der versendeten Nachricht angehangen. Somit stehen diese Dateien direkt im E-Mail-Programm zur Verfügung. Ab Version {{version major="2" minor="1"/}} ist es alternativ auch möglich Limits festzulegen, ab welchem Dateien nur in einer angehangenen Textdatei aufgelistet werden sollen.
15 ; Abbildung der verfügbaren Postfachstruktur
16 : Da für die Abbildung der {{formcycle/}}-Postfächer innerhalb des E-Mail-Programms entsprechende Ordner angelegt werden, hat der Benutzer auch hier nur Zugriff auf Formulareingänge, die er je nach Benutzergruppenkonfiguration haben darf. Zusätzlich wird der Ordner //Posteingang// als Sammelpostfach zur Darstellung aller ihm zugänglichen Formulareingänge benutzt.
17 ; Verwalten von Formulareingängen
18 : Neben der eigentlichen Anzeige stehen auch Möglichkeiten zur Verwaltung von Formulareingängen zur Verfügung. So wird ein Formulareingang beim Verschieben eines Ordners in das entsprechende {{formcycle/}}-Postfach verschoben. Ferner wird der Gelesen-Status ebenso synchronisiert. Das Löschen von Formulareingängen ist bei entsprechender Berechtigung ebenso durch das Löschen der zugehörigen Nachricht oder durch das Verschieben in den Papierkorb möglich. Fehlt diese Berechtigung, taucht die Nachricht nach wenigen Sekunden wieder im E-Mail-Programm auf.
19
20 Der zur Verfügung gestellte {{smallcaps}}Smtp{{/smallcaps}}-Server ist aktuell ohne Funktionalität, sodass abgesendete Nachrichten von diesem komplett verworfen werden.
21
22 == Installation ==
23
24 Die Installation des Plugins ist über die dafür vorgesehene Verwaltungsoberfläche von Plugins durchzuführen. Hierbei muss lediglich die entsprechende {{smallcaps}}Jar{{/smallcaps}}-Datei eingespielt werden. Ferner kann die erste Installation je nach Anzahl von Formulareingängen auf Grund einer kompletten Aufbereitung der Daten für den {{smallcaps}}Imap{{/smallcaps}}-Server mehrere Minuten andauern.
25
26 {{info}}
27 Das {{smallcaps}}Imap{{/smallcaps}}-Plugin trifft bei der Anmeldung und dem Ausliefern von Nachrichten keine Unterscheidung, in welchem Mandanten es installiert ist. Es steht somit immer allen Benutzern zur Verfügung steht. Daher ist es anzuraten, das Plugin als System-Plugin zu installieren. Dies umgeht auch mögliche Probleme mit doppelt belegten Ports und ermöglicht eine zentrale Konfiguration.
28 {{/info}}
29
30 == Konfiguration des Plugins ==
31
32 {{figure image="config_de.png"}}
33 Die Konfigurationsoberfläche des Plugins. Hier werden Einstellungen zur Verbindung mit dem Mail-Server getroffen. Weiterhin wird festgelegt, wie die versendeten E-Mails aussehen sollen.
34 {{/figure}}
35
36 Nach der Installation des Plugins stehen die in der Abbildung dargestellten Konfigurationsparameter zur Verfügung. Folgende Einstellungsmöglichkeiten gibt es dabei:
37
38 === Konfiguration der Mail-Server ===
39
40 {{id name="server_config"/}}
41
42 ; smtp.binding.address
43 : Standardwert: //0.0.0.0//. Gibt die zu verwendende {{smallcaps}}ip{{/smallcaps}}-Adresse des {{smallcaps}}Smtp{{/smallcaps}}-Servers an. Der Standardwert ist //0.0.0.0// und verwendet damit eine automatisch ermittelte {{smallcaps}}ip{{/smallcaps}}. Eine Änderung dieses Wertes ist nur nötig, falls mehrere Netzwerkadapter im Einsatz sind oder die automatische Ermittlung fehlschlägt.
44 ; smtp.binding.port
45 : Standardwert: //25//. Gibt den zu verwendenten Port des {{smallcaps}}Smtp{{/smallcaps}}-Servers an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht.
46 ; imap.binding.address
47 : Standardwert: //0.0.0.0//. Gibt die zu verwendende IP-Adresse des {{smallcaps}}Imap{{/smallcaps}}-Servers an. Der Standardwert ist //0.0.0.0// und verwendet damit ebenfalls eine automatisch ermittelte {{smallcaps}}ip{{/smallcaps}}. Eine Änderung dieses Wertes ist nur nötig, falls mehrere Netzwerkadapter im Einsatz sind oder die automatische Ermittlung fehlschlägt.
48 ; imap.binding.port
49 : Standardwert: //143//. Gibt den zu nutzenden Port des {{smallcaps}}Imap{{/smallcaps}}-Servers an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht.
50 ; imap.batch.size (ab {{version major="2" minor="1"/}})
51 : Standardwert: //50//. Gibt die Anzahl der gleichzeitig auszuliefernden Nachrichten an. Ein geringerer Wert reduziert die Speicherlast, verringert aber ebenso die Performance.
52
53 === Konfiguration der Mail Nachrichten ===
54
55 {{id name="message_files_config"/}}
56
57 ; mail.to.template
58 : Standard: //mail_to.txt//. Gibt den Namen der Datei an, welche in den Mandant- und Formulardateien gesucht wird und als Vorlage für den E-Mail-Empfänger benutzt werden soll.
59 ; mail.from.template
60 : Standard: //mail_from.txt//. Gibt den Namen der Datei an, welche in den Mandant- und Formulardateien gesucht wird und als Vorlage für den E-Mail-Absender benutzt werden soll.
61 ; mail.subject.template
62 : Standard: //mail_subject.txt//. Gibt den Namen der Datei an, welche in den Mandant- und Formulardateien gesucht wird und als Vorlage für den E-Mail-Betreff benutzt werden soll.
63 ; mail.body.template
64 : Standard: //mail_body.txt//. Gibt den Namen der Datei an, welche in den Mandant- und Formulardateien gesucht wird und als Vorlage für den E-Mail-Inhalt benutzt werden soll.
65 ; mail.attachment.limit (ab {{version major="2" minor="1"/}})
66 : Standard: //10//. Maximale Größe einer Datei (in MB), ab welcher dieser nicht angehangen, sondern in einer Textdatei aufgelistet werden soll (-1 = deaktiviert, 0 = listet alle Anhänge).
67 ; mail.attachment.sum.limit (ab {{version major="2" minor="1"/}})
68 : Standard: //-1//. Maximale Summe aller Dateigrößen (in MB), ab welcher diese nicht angehangen, sondern in einer Textdatei aufgelistet werden sollen (-1 = deaktiviert, 0 = alle Anhänge immer auflisten).
69
70 === Konfiguration der Synchronisation ===
71
72 ; sync.max.threads (ab {{version major="2" minor="1"/}})
73 : Standard: //4//. Anzahl der Threads mit welcher die Synchronisation von Nachrichten durchgeführt werden soll.
74 ; sync.page.size (ab {{version major="2" minor="1"/}})
75 : Standard: //50//. Anzahl der Nachrichten mit welcher ein Threads die Synchronsiation durchführen soll.
76
77 === Konfiguration des Caches ===
78
79 ; cache.heap.size (ab {{version major="2" minor="1"/}})
80 : Standard: //200//. Größe des zu verwendeten Arbeitsspeichers in MB.
81 ; cache.disk.size (ab {{version major="2" minor="1"/}})
82 : Standard: //500//. Größe des zu verwendeten Festplatten-Speichers in MB.
83 ; cache.tti (ab {{version major="2" minor="1"/}})
84 : Standard: //900//. Maximales Alter eines Cache-Eintrags in Sekunden.
85
86 == Konfiguration der E-Mail-Inhalte und Felder ==
87
88 Die Konfiguration der Inhalte und Felder der eigentlichen Nachricht benutzt einen Vorlagenmechanismus. Dieser basiert auf den vier Dateien, die unter [[Konfiguration der E-Mail-Nachricht>>||anchor="message_files_config"]] eingestellt wurden. Diese werden bei der Installation des Plugins als Mandantdatei eingespielt und bei der Synchronisation der Nachrichten benutzt. Um eine formularspezifische Anzeige zu gewährleisten, ist es möglich, gleich benannte Dateien manuell als Formulardatei anzulegen und somit die Mandantdateien zu überlagern. In allen Dateien ist es möglich, [[Platzhalter>>doc:Formcycle.UserInterface.Variables||target="_blank"]] zu verwenden, sodass hier abgesendete Formulardaten ausgegeben werden können. Ebenso ist es damit möglich, etwa einen Link zur Anzeige des ausgefüllten Formulars zu erzeugen.
89
90 ; Inhalt
91 : Standardwert: //mail_body.txt//. Gibt den Inhalt der E-Mail-Nachricht an. Nur hier besteht die Möglichkeit, {{smallcaps}}Html{{/smallcaps}} zu hinterlegen. Beispiel:
92
93 {{code language="html"}}
94 <html>
95 <head></head>
96 <body>
97 <p><a href="[%$FORM_INBOX_LINK%]">Link</a> zum Vorgang ([%$PROCESS_ID%]).</p>
98 </body>
99 </html>
100 {{/code}}
101
102 ; Betreff
103 : Standardwert: //mail_subject.txt//. Gibt den Betreff der Nachricht an. Beispiel:
104
105 {{code language="none"}}
106 ID: [%$RECORD_ID%] - [%$STATUS_NAME%]
107 {{/code}}
108
109 ; Empfänger
110 : Standardwert: //mail_to.txt//. Gibt den Empfänger der Nachricht an. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf den eigentlichen Empfang der Nachricht. Beispiel:
111
112 {{code language="none"}}
113 XIMA FORMCYCLE <no-reply@example.com>
114 {{/code}}
115
116 ; Absender
117 : Standardwert: //mail_from.txt//. Gibt den Absender der Nachricht an. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf das Absenden der Nachricht. Beispiel:
118
119 {{code language="none"}}
120 [%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com>
121 {{/code}}
122
123 == Konfiguration des E-Mail-Programms ==
124
125 Für die Konfiguration des E-Mail-Programms sind neben der Adresse des E-Mail-Servers die unter [[Konfiguration des E-Mail-Server-Services>>||anchor="server_config"]] hinerlegten Ports zu verwenden. Die kompletten zu verwendenden Anmeldedaten setzen sich demnach wie folgt zusammen:
126
127 ; SMPT-Server
128 : //<Server-Adresse>//
129 ; SMPT-Port
130 : //siehe //[[Konfiguration Mail-Server Service>>||anchor="server_config"]]
131 ; {{smallcaps}}Imap{{/smallcaps}}-Server
132 : //<Server-Adresse>//
133 ; {{smallcaps}}Imap{{/smallcaps}}-Port
134 : //siehe //[[Konfiguration Mail-Server Service>>||anchor="server_config"]]
135 ; Benutzername
136 : //<FORMCYCLE-Benutzer>@<FORMCYCLE-Mandantname>//
137 ; Passwort
138 : //<FORMCYCLE-Benutzer-Passwort>//
139 ; Authentifizierung
140 : Passwort, normal
141 ; SSL-Verschlüsselung und Verbindungssicherheit
142 : keine
143
144 == Beispielskonfiguration für Thunderbird ==
145
146 1. Die Verwaltung der E-Mail-Konten über //Extras// > //Konto-Einstellungen// öffnen.{{lightbox image="thunderbird_1.png" group="g0" width="300"/}}
147 1. Über //Konto-Aktionen// > //E-Mail-Konto hinzufügen...// den Dialog zum Konfigurieren eines neuen Kontos öffnen.{{lightbox image="thunderbird_2.png" group="g0" width="500"/}}
148 1. Initial versucht Thunderbird, anhand der eingetragenen E-Mail-Adresse (hier //user@imap.de//) einen Server automatisch zu ermitteln. Da dies hier nicht möglich ist, kann dies über die Schaltfläche //Manuell bearbeiten// abgebrochen werden.{{lightbox image="thunderbird_3.png" group="g0" width="500"/}}
149 1. In der darauf folgenden Oberfläche der Server-Konfiguration können nun die entsprechenden Daten eingetragen werden. Im Beispiel lautet der Mandantname //imap.de// und der Benutzername //user// und es werden die Standardports benutzt.{{lightbox image="thunderbird_4.png" group="g0" width="500"/}}
150 1. Nach Fertigstellung der Konfiguration erscheinen nun die Postfächer des Benutzers als Ordner (hier //Zentrales Postfach// und //Demopostfach//) und die darin enthaltenen Nachrichten der vorhandenen Formulareingänge.{{lightbox image="thunderbird_5.png" group="g0" width="700"/}}
151
152 == Versionshistorie ==
153
154 **Version 2.1.0**
155
156 * Umstellung auf die {{formcycle/}} Version 6.5.5
157 * Aktualisierung der verwendeten Bibliotheken
158 * Optimierungen des Speicherverbrauchs und der Datenbank-Queries
159 * Einbau eines Caches für den Header und Body von Nachrichten
160 * Fehlerbehebung beim Auslesen der IMAP BODYSTRUCTURE
161 * Wiedereinbau der Konfiguration der Anhang-Limits
162 * Erweiterung der Konfigurierbarkeit der IMAP Batch-Größe und der Synchronisation
163
164 **Version 2.0.0**
165
166 * Anpassungen für die Kompatibilität mit {{formcycle/}} Version 6.0.2
167
168 **Version 1.0.1**
169
170 * Optimierungen und Erweiterungen der Konfigurierbarkeit
171
172 **Version 1.0.0**
173
174 * Initialer Release

Navigation

Copyright 2000-2024