Änderungen von Dokument IMAP-Plugin

Von Version < 34.16 >

bearbeitet von awa
am 24.03.2020, 21:18

Auf Version < 34.17 >

bearbeitet von awa
am 24.03.2020, 21:36

< >

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -5,24
          +5,24 @@
  == Funktionalitäten ==
  ; Sofortige Benachrichtigung
--: Über die {{smallcaps}}Imap{{/smallcaps}}-Schnittstelle werden Sie sofort über neue oder geänderte Formular-Eingänge informiert
++: Über die {{smallcaps}}Imap{{/smallcaps}}-Schnittstelle wird der Bneutzer sofort über neue oder geänderte Formulareingänge informiert.
  ; Konfigurierbarer Inhalt
--: Über entsprechende Vorlagen ist der Inhalt der Benachrichtigungen sowie deren Betreff-, Absender- und Empfänger-Felder frei konfigurierbar. Da hier der [[Platzhalter>>doc:Formcycle.UserInterface.Variables||target="_blank"]]-Mechanismus greift, ist können neben einzelnen Werten oder Meta-Daten des Formular-Eingangs auch Links zur Wiederanzeige direkt innerhalb des Postfachs erzeugt werden.
++: Ü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.
  ; Bereitstellung von Dateien
--: Einer Nachricht werden automatisch die innerhalb des Formulars hochgeladenen oder während der Statusverarbeitung erzeugten Dateien angehanden und stehen damit direkt in Ihrem E-Mail-Programm zur Verfügung
--; Abbildung der verfügbaren Postfach-Struktur
--: Da für die Abbildung der {{formcycle/}}-Postfächer innerhalb Ihres E-Mail-Programms entsprechende Ordner angelegt werden, hat der Benutzer auch hier nur Zugriff auf Formular-Eingänge die er je nach Benutzergruppen-Konfiguration haben darf. Zusätzlich wird der Ordner "Posteingang" als Sammelpostfach zur Darstellung aller ihm zugänglichen Formular-Eingänge benutzt.
--; Verwalten von Formular-Eingängen
--: 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.
++: 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.
++; Abbildung der verfügbaren Postfachstruktur
++: 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.
++; Verwalten von Formulareingängen
++: 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.
  Der zur Verfügung gestellte {{smallcaps}}Smtp{{/smallcaps}}-Server ist aktuell ohne Funktionalität, sodass abgesendete Nachrichten von diesem komplett verworfen werden.
  == Installation ==
--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 {{smallcaps}}Imap{{/smallcaps}}-Server mehrere Minuten andauern.
++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.
  {{info}}
--Da das {{smallcaps}}Imap{{/smallcaps}}-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.
++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.
  {{/info}}
  == Konfiguration des Plugins ==
@@ -33,38
          +33,38 @@
  Nach der Installation des Plugins stehen die in der Abbildung dargestellten Konfigurationsparameter zur Verfügung. Folgende Einstellungsmöglichkeiten gibt es dabei:
--=== Konfiguration Mail-Server-Services ===
++=== Konfiguration des E-Mail-Server-Services ===
   {{id name="server_config"/}}
  ; smtp.binding.address
--: Standardwert: //0.0.0.//. 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.
++: Standardwert: //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.
  ; smtp.binding.port
  : 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.
  ; imap.binding.address
--: 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 IP. Eine Änderung dieses Wertes ist nur nötig, falls mehrere Netzwerkadapter im Einsatz sind oder die automatische Ermittlung fehlschlägt.
++: 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.
  ; imap.binding.port
--: Standardwert: //143//. Gibt den zu verwendenten Port des {{smallcaps}}Imap{{/smallcaps}}-Servers an. Der Standardwert sollte nur geändert werden, falls dieser Port nicht zur Verfügung steht.
++: 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.
--=== Konfiguration Mail Message ===
++=== Konfiguration der E-Mail-Nachricht ===
   {{id name="message_files_config"/}}
  ; mail.to.template
--: Standardwert: //mail_to.txt//. 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.
++: Standardwert: //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.
  ; mail.from.template
--: Standard: //mail_from.txt//. 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//. 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.
  ; mail.subject.template
--: Standard: //mail_subject.txt//. 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//. 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.
  ; mail.body.template
--: Standard: //mail_body.txt//. 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//. 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.
  == Konfiguration der E-Mail-Inhalte und Felder ==
--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.
++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 Formulardateien 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.
  ; Inhalt
--: Standardwert: //mail_body.txt//. Definiert den Inhalt der E-Mail-Nachricht. Hier besteht als einziges die Möglichkeit HTML zu hinterlegen. Beispiel:
++: Standardwert: //mail_body.txt//. Gibt den Inhalt der E-Mail-Nachricht an. Nur hier besteht die Möglichkeit, {{smallcaps}}Html{{/smallcaps}} zu hinterlegen. Beispiel:
  {{code language="html"}}
    <html>
@@ -76,7
          +76,7 @@
  {{/code}}
  ; Betreff
--: Standardwert: //mail_subject.txt//. Definiert den Betreff der Nachricht. Beispiel:
++: Standardwert: //mail_subject.txt//. Gibt den Betreff der Nachricht an. Beispiel:
  {{code language="none"}}
    ID: [%$RECORD_ID%] - [%$STATUS_NAME%]
@@ -83,7
          +83,7 @@
  {{/code}}
  ; Empfänger
--: Standardwert: //mail_to.txt//. 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:
++: 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:
  {{code language="none"}}
    XIMA FORMCYCLE <no-reply@example.com>
@@ -90,7
          +90,7 @@
  {{/code}}
  ; Absender
--: Standardwert: //mail_from.txt//. Definiert den Absender der Nachricht. Dieser ist nach dem Muster //Name <user@example.com>// anzugeben und hat keinerlei Auswirkungen auf das Absenden der Nachricht. Beispiel:
++: 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:
  {{code language="none"}}
    [%$PROJECT_NAME%] <[%$PROJECT_NAME%]@example.com>
@@ -98,7
          +98,7 @@
  == Konfiguration des E-Mail-Programms ==
--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:
++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:
  ; SMPT-Server
  : //<Server-Adresse>//
@@ -114,7
          +114,7 @@
  : //<FORMCYCLE-Benutzer-Passwort>//
  ; Authentifizierung
  : Passwort, normal
--; SSL-Verschlüsselung/Verbindungssicherheit
++; SSL-Verschlüsselung und Verbindungssicherheit
  : keine
  == Beispielskonfiguration für Thunderbird ==
@@ -121,6
          +121,6 @@
 . Die Verwaltung der E-Mail-Konten über //Extras// > //Konto-Einstellungen// öffnen.{{lightbox image="thunderbird_1.png" group="g0" width="300"/}}
 . Ü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"/}}
--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"/}}
--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 Benutzer-Name //user// und es werden die Standard-Ports benutzt.{{lightbox image="thunderbird_4.png" group="g0" width="500"/}}
--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 Formular-Eingänge.{{lightbox image="thunderbird_5.png" group="g0" width="700"/}}
++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"/}}
++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"/}}
++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"/}}

Änderungen von Dokument IMAP-Plugin

Zusammenfassung

Details

Navigation