Wiki-Quellcode von IMAP-Plugin

Verstecke letzte Bearbeiter

version	line-number	content
35.1	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)
34.21	2
30.1	3	{{content/}}
	4
52.2	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.
1.2	6
5.1	7	== Funktionalitäten ==
	8
34.2	9	; Sofortige Benachrichtigung
34.17	10	: Über die {{smallcaps}}Imap{{/smallcaps}}-Schnittstelle wird der Bneutzer sofort über neue oder geänderte Formulareingänge informiert.
34.2	11	; Konfigurierbarer Inhalt
34.17	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.
34.2	13	; Bereitstellung von Dateien
48.1	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.
34.17	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.
5.1	19
34.16	20	Der zur Verfügung gestellte {{smallcaps}}Smtp{{/smallcaps}}-Server ist aktuell ohne Funktionalität, sodass abgesendete Nachrichten von diesem komplett verworfen werden.
15.1	21
34.14	22	== Installation ==
1.2	23
34.17	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.
1.2	25
13.1	26	{{info}}
34.17	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.
13.1	28	{{/info}}
	29
34.14	30	== Konfiguration des Plugins ==
1.2	31
2.4	32	{{figure image="config_de.png"}}
34.2	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.
2.4	34	{{/figure}}
1.2	35
34.2	36	Nach der Installation des Plugins stehen die in der Abbildung dargestellten Konfigurationsparameter zur Verfügung. Folgende Einstellungsmöglichkeiten gibt es dabei:
2.3	37
45.1	38	=== Konfiguration der Mail-Server ===
1.2	39
35.1	40	{{id name="server_config"/}}
1.3	41
34.2	42	; smtp.binding.address
44.2	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.
34.2	44	; smtp.binding.port
34.16	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.
34.2	46	; imap.binding.address
34.17	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.
34.2	48	; imap.binding.port
34.17	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.
47.1	50	; imap.batch.size (ab {{version major="2" minor="1"/}})
50.1	51	: Standardwert: //50//. Gibt die Anzahl der gleichzeitig auszuliefernden Nachrichten an. Ein geringerer Wert reduziert die Speicherlast, verringert aber ebenso die Performance.
1.2	52
45.1	53	=== Konfiguration der Mail Nachrichten ===
1.2	54
35.1	55	{{id name="message_files_config"/}}
1.2	56
34.2	57	; mail.to.template
36.1	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.
34.2	59	; mail.from.template
34.17	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.
34.2	61	; mail.subject.template
34.17	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.
34.2	63	; mail.body.template
34.17	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.
47.1	65	; mail.attachment.limit (ab {{version major="2" minor="1"/}})
49.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).
47.1	67	; mail.attachment.sum.limit (ab {{version major="2" minor="1"/}})
49.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).
1.3	69
50.1	70	=== Konfiguration der Synchronisation ===
45.1	71
50.1	72	; sync.max.threads (ab {{version major="2" minor="1"/}})
45.1	73	: Standard: //4//. Anzahl der Threads mit welcher die Synchronisation von Nachrichten durchgeführt werden soll.
50.1	74	; sync.page.size (ab {{version major="2" minor="1"/}})
45.1	75	: Standard: //50//. Anzahl der Nachrichten mit welcher ein Threads die Synchronsiation durchführen soll.
	76
50.1	77	=== Konfiguration des Caches ===
45.1	78
50.1	79	; cache.heap.size (ab {{version major="2" minor="1"/}})
45.1	80	: Standard: //200//. Größe des zu verwendeten Arbeitsspeichers in MB.
50.1	81	; cache.disk.size (ab {{version major="2" minor="1"/}})
45.1	82	: Standard: //500//. Größe des zu verwendeten Festplatten-Speichers in MB.
50.1	83	; cache.tti (ab {{version major="2" minor="1"/}})
45.1	84	: Standard: //900//. Maximales Alter eines Cache-Eintrags in Sekunden.
	85
34.14	86	== Konfiguration der E-Mail-Inhalte und Felder ==
5.2	87
36.1	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.
5.2	89
34.5	90	; Inhalt
34.17	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:
34.4	92
	93	{{code language="html"}}
36.1	94	<html>
7.1	95	<head></head>
	96	<body>
	97	<p><a href="[%$FORM_INBOX_LINK%]">Link</a> zum Vorgang ([%$PROCESS_ID%]).</p>
	98	</body>
34.4	99	</html>
	100	{{/code}}
34.8	101
34.5	102	; Betreff
34.17	103	: Standardwert: //mail_subject.txt//. Gibt den Betreff der Nachricht an. Beispiel:
5.2	104
34.4	105	{{code language="none"}}
	106	ID: [%$RECORD_ID%] - [%$STATUS_NAME%]
	107	{{/code}}
34.8	108
34.5	109	; Empfänger
34.17	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:
34.4	111
	112	{{code language="none"}}
	113	XIMA FORMCYCLE <no-reply@example.com>
	114	{{/code}}
34.8	115
34.5	116	; Absender
34.17	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:
34.4	118
	119	{{code language="none"}}
	120	[%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com>
	121	{{/code}}
	122
34.14	123	== Konfiguration des E-Mail-Programms ==
5.2	124
34.17	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:
5.2	126
34.9	127	; SMPT-Server
	128	: //<Server-Adresse>//
	129	; SMPT-Port
	130	: //siehe //[[Konfiguration Mail-Server Service>>\|\|anchor="server_config"]]
34.16	131	; {{smallcaps}}Imap{{/smallcaps}}-Server
34.9	132	: //<Server-Adresse>//
34.16	133	; {{smallcaps}}Imap{{/smallcaps}}-Port
34.9	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
34.17	141	; SSL-Verschlüsselung und Verbindungssicherheit
34.9	142	: keine
11.2	143
34.16	144	== Beispielskonfiguration für Thunderbird ==
18.3	145
34.12	146	1. Die Verwaltung der E-Mail-Konten über //Extras// > //Konto-Einstellungen// öffnen.{{lightbox image="thunderbird_1.png" group="g0" width="300"/}}
34.11	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"/}}
34.17	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"/}}
51.1	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
52.1	174	* Initialer Release

Wiki-Quellcode von IMAP-Plugin

Navigation