Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- mail:start [2021/11/15 17:44] – pbudenz
+++ mail:start [2023/11/07 10:18] (aktuell) – [Mails in fn2Web (WIP)] christoph
@@ Zeile 28: / Zeile 28: @@
 Mit dem Update vom 03.12.2018 wurden die Mail-Benachrichtigungen der FlexNow-Module grundlegend überarbeitet. Die Inhalte und die Gestaltung der Benachrichtigungen werden nun ebenso wie die Druckerzeugnisse anhand von XSL-Dateien bestimmt. Dies ersetzt die bisherigen, teilweise fest vorgegebenen und teilweise in der Datenbank gespeicherten Mailvorlagen. Mit dem Update werden XSL-Vorlagen veröffentlicht, die die bisherigen Mails vollständig, teilweise aber visuell überarbeitet, umsetzen. Diese können als Grundlage für die Anpassung an den jeweiligen Hochschulen genutzt werden.
-**Anmerkung: Mit dem Stand vom 03.12.2018 sind noch nicht alle Bereiche auf die XSL-Vorlagen umgesetzt. Dies betrifft die Mail-Benachrichtigungen der Reporte/Kontrollisten und die Mails der FlexNow-Webschnittstelle. Diese werden in kommenden Updates aber ebenfalls angepasst.**
 Das neue Mailkonzept bietet eine Versionierung der Nachrichten - damit können z.b. unterschiedliche Varianten der gleichen Mail für die unterschiedlichen Fachbereiche/Fakultäten einer Hochschule realisiert werden. Darüber hinaus ist auch ein sprachabhängiger Versand möglich. Das Vorgehen beim Generieren einer Mail ist dabei folgendes:
@@ Zeile 41: / Zeile 39: @@
 {{ :mail:mail_baum2.png |}}
-Die grundsätzliche Struktur der in FlexNow verfügbaren Mails wird im PO-Modul bearbeitet. Dies erfolgt im Explorer unter "Einstellungen - Mails - Nachrichten". Hier werden Mails, die sich aus bestimmten Funktionen des Systems ergeben, bereits vorgegeben (z.B. Buchungsmail, Anmeldebestätigung). Diese können bearbeitet werden. Darüber hinaus können auch eigene Mailvorlagen angelegt werden, die in Zukunft bei Reporten verwendet werden können.
+Die grundsätzliche Struktur der in FlexNow verfügbaren Mails wird im PO-Modul bearbeitet. Dies erfolgt im Explorer unter "Einstellungen - Mails - Nachrichten". Hier werden Mails, die sich aus bestimmten Funktionen des Systems ergeben, bereits vorgegeben (z.B. Buchungsmail, Anmeldebestätigung). Diese können bearbeitet aber nicht gelöscht werden. Darüber hinaus können auch eigene Mailvorlagen angelegt werden, die bei Reporten verwendet werden können.
 {{ :mail:mail_mailtyp.png |}}
@@ Zeile 173: / Zeile 171: @@
 Im folgenden sind die für den Mailversand relevanten Parameter der Setup-Tabelle aufgelistet.
-  * **MAIL_XSL_VERZEICHNIS** - Verzeichnis, in dem die XSL-Dateien für die Erstellung von Mails gespeichert sind.
+  * **MAIL_XSL_VERZEICHNIS** - Verzeichnis, in dem die XSL-Dateien für die Erstellung von Mails gespeichert sind. Dieser Parameter wird von fn2Web nicht verwendet.
-  * **MAIL_ATTACHMENT_VERZEICHNIS** - Verzeichnis, in dem Dateien gespeichert sind, die als Anhang an Mails angehängt werdn können. Wenn dieser Parameter nicht gesetzt ist, dann müssen die Anhänge im gleichen Verzeichnis gespeichert sein, in dem auch die XSL-Dateien gespeichert sind.
+  * **MAIL_ATTACHMENT_VERZEICHNIS** - Verzeichnis, in dem Dateien gespeichert sind, die als Anhang an Mails angehängt werdn können. Wenn dieser Parameter nicht gesetzt ist, dann müssen die Anhänge im gleichen Verzeichnis gespeichert sein, in dem auch die XSL-Dateien gespeichert sind. Dieser Parameter wird von fn2Web nicht verwendet.
-  * **MAIL_ANMELDUNG** - Hat dieser Parameter den Wert TRUE, dann wird bei Anmeldungen, die in den Modulen PA oder PD vorgenommen wurden, nachgefragt, ob der entsprechende Studierende per Mail über diese Anmeldung informiert werden soll.
+  * **MAIL_ANMELDUNG** - Hat dieser Parameter den Wert TRUE, dann wird bei Anmeldungen, die in den Modulen PA oder PD vorgenommen wurden, nachgefragt, ob der entsprechende Studierende per Mail über diese Anmeldung informiert werden soll. Dieser Parameter wird von fn2Web nicht verwendet.
   * **MAIL_STUDENT_BEIDE_ADRESSEN** - In FlexNow können bis zu zwei Mailadressen pro Studierendenakte gespeichert sein. Standardmäßig werden Mails an Studierende immer an die erste gespeicherte Adresse gesendet. Wenn dieser Parameter jedoch den Wert "TRUE" hat, dann erfolgt der Versand immer an beide gespeicherte Mailadressen.
+===== Mails in fn2Web (WIP) =====
+Die inzwischen in fn2Web umgesetzten Mail-Funktionen werden hier aufgeführt.
+Anstelle des Setup-Parameters 'MAIL_XSL_VERZEICHNIS' werden die XSL-Dateien für den Mail-Versand in fn2Web im Verszeichnis {FN2XML.XSLPATH}/mail hinterlegt (der Init-Parameter 'FN2XML.XSLPATH' befindet sich in der context.xml der tomcat-Instalation). Bitte hierzu auch die Release-Notes [[releasenotes:fn2web2.04.08#release_20408000_vom_09092021|2.04.08.000]] beachten.
+==== An-/Abmeldung ====
+Mit der SQL-Skript-Id 1160 wird im PO-Modul die Mail "An-/Abmeldung Web" eingefügt. Unter ihr können, wie oben beschrieben, die zugehörigen Mail-Versionen hinterlegt werden.
+{{ :mail:fn2web_mail_xsls.png?direct |}}
+Bei der Erstinbetriebnahme müssen einmalig die Dateien aus .../Konfigurationsdateien/FN2HOCHSCHULE/xsl/FN2XML/mail nach {FN2XML.XSLPATH}/mail kopiert werden. Die oben gelb hinterlegten Dateien werden mit dem in 2.04.08 angepassten Kopierskript jedes mal neu überschrieben, alle anderen sind frei editierbar.
+In den Dateien 'Bsp_xml_fuer_an_abmeldung_LV.xml' und 'Bsp_xml_fuer_an_abmeldung_zentral.xml' werden jeweils Beispiele für die XML-Quelle bei zentralen und dezentralen An-/Abmeldungen hinterlegt. Zudem wird ab Version 2.04.08.010 das jeweils letzte Mail-XML in der Datei 'mail_quelle.xml' im Logging-Verzeichnis (Init-Parameter 'FN2XML.XMLPATH') abgelegt, wenn der Debug-Parameter in der web.xml von FN2XML gesetzt ist (analog z.B. zum Datenblatt-Druck).