Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- mail:start [2019/01/07 17:28] – 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 70: / Zeile 68: @@
 Der grundsätzliche Aufbau einer XSL-Datei für die Mail ist folgender:
-<HTML>
+<code>
 <?xml version="1.0" encoding="ISO-8859-1"?>
 <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
@@ Zeile 100: / Zeile 98: @@
 </xsl:stylesheet>
-</HTML>
+</code>
 Dabei sollten nur die Inhalte der Tags <subject>, <message> und <attachments> verändert werden. Zusätzlich zu den Vorlagen für die Mailtypen werden mit dem Update vom 03.12.2018 weitere Dateien ausgeliefert, die teilweise in die Vorlagen eingebunden sind oder die für das Erstellen neuer Mailvorlagen genutzt werden können. Diese Dateien befinden sich auch unabhängig von den Updates auf dem FTP-Server im Verzeichnis XSL/Mail und können dort heruntergeladen werden.
@@ Zeile 147: / Zeile 145: @@
 Beispiel aus der Vorlage für die Anmeldungsbestätigung (**anmeldungsmail.xsl**)
-<HTML>
+<code>
 <p>
 <xsl:call-template name="text"><xsl:with-param name="id" select="'anmeldungsmail_text'"/></xsl:call-template>
 </p>
-</HTML>
+</code>
 Damit wird auf die folgenden Texte in der Datei texte.xml zugegriffen:
-<HTML>
+<code>
 <text id="anmeldungsmail_text" sprache="1">Sie wurden zur folgenden Prüfung angemeldet:</text>
 <text id="anmeldungsmail_text" sprache="2">You have been registered for the following exam:</text>
-</HTML>
+</code>
 Für Daten, die aus der Modellierung der Prüfungsordnungen resultieren, werden alle existierenden sprachspezifischen Bezeichner automatisch in der XML-Struktur angeboten.
@@ Zeile 167: / Zeile 165: @@
 ===== Individuelle Datenbankabfragen =====
-Ebenso wie beim Datenexport besteht nun auch in den XSL-Vorlagen der Mails die Möglichkeit Datenbankabfragen zu integrieren, mit denen auch Daten ermittelt werden können, die nicht in der XML-Struktur enthalten sind. Detaillierte Erklärungen hier zu gibt es unter [[export:individuelle_datenbankabfragen_fuer_den_export|export:individuelle_datenbankabfragen_fuer_den_export]].
+Ebenso wie beim Datenexport besteht nun auch in den XSL-Vorlagen der Mails die Möglichkeit Datenbankabfragen zu integrieren, mit denen auch Daten ermittelt werden können, die nicht in der XML-Struktur enthalten sind. Detaillierte Erklärungen hier zu gibt es unter [[export:start#individuelle_datenbankabfragen_fuer_den_export|Datenexport beim Druck]].
 ===== Setup-Einstellungen =====
@@ 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).