Wie kann ich auf Basis der Absenderdomäne unterschiedliche Designs verwenden?
Dieser Artikel beschreibt, wie Sie ab NoSpamProxy 11.x die Templates für das Design der System-Mails von NoSpamProxy (inkl. der PDF-Mails) so anpassen, dass auf Basis der Absenderdomäne unterschiedliche Designs verwendet werden. Als Basis für die dynamische Änderung verwendet NoSpamProxy die Template-Engine für .NET “Razor”.
Die zu editierenden CSHTML-Dateien liegen im Verzeichnis %Program Files%\Net at Work Mail Gateway\Intranet Role\Templates. Nach der Änderung werden die Dateien automatisch auf alle angeschlossenen Gateway Rolle repliziert.
WICHTIG
Sie benötigen zumindest rudimentäre HTML-Kenntnisse, um die Anpassungen durchführen zu können.
Anpassung der Template-Dateien
Vorgefertigte Beispieldateien mit unterschiedlichen Designs können Sie gerne beim NoSpamProxy Support anfordern. Diese Datei ist erst ab NoSpamProxy 11.0 verwendbar. In diesem Beispiel werden zwei unterschiedliche Designs für die Absenderdomänen netatwork.de und nospamproxy.de angewandt. Sie können die Anzahl der Domänen jederzeit erweitern oder reduzieren.
Entpacken Sie nach dem Herunterladen die ZIP-Datei zunächst in einen temporären Ordner. Sie enthält folgende Dateien:
- CommonMailTemplate.cshtml
- CommonMailTemplateNaw.cshtml
- CommonMailTemplateNsp.cshtml
- ConvertMailContentToPdfAttachmentActionPdfHeader.cshtml
- ConvertMailContentToPdfAttachmentActionTeaser.cshtml
- EncryptedMailNotificationTemplate.cshtml
Fangen Sie mit den Dateien an, die mit “CommonMailTemplate” beginnen. Hier bestimmen Sie das Aussehen aller E-Mails, die bei der PDF-Mail erforderlich sind. Achten Sie darauf, dass Sie das Standarddesign in der CommonMailTemplate.cshtml hinterlegen. Passen Sie die StyleSheets in den jeweiligen Dateien entsprechend Ihrer Bedürfnisse an. Auch die Einbindung der entsprechenden Logos erfolgt in diesen Dateien. Im späteren Wirkbetrieb, müssen die Logodateien mit dem korrekten Namen ebenfalls im Ordner Templates-Ordner verfügbar sein.
Anschließend passen Sie die Datei “ConvertMailContentToPdfAttachmentActionPdfHeader.cshtml” an. Diese Datei bestimmt das Layout der PDF-Datei als solches. Im Gegensatz zu den CommonMailTemplate-Dateien benötigen Sie hier nur eine Datei, um die Ausnahmen zu definieren. Die Anpassungen finden im oberen Teil statt. Ein Beispiel für drei unterschiedliche Designs ist eingebaut. Wichtig ist: Sie legen das Design für die unterschiedlichen Domänen fest. Falls NoSpamProxy im Wirkbetrieb die entsprechende Absende-Domäne nicht findet, verwendet er das Standard-Design, das Sie mit dem Template-Editor in der Admin-GUI bestimmen können.
Wenn alle Dateien angepasst sind, kopieren Sie sämtliche CSHTML Dateien in den Templates-Ordner Ihrer Programmversion. Machen Sie vorher eine Sicherung aller enthaltener Dateien!
Beachten Sie, dass die Dateien beim Patchen/Upgraden überschrieben werden. Bitte kopieren Sie nach einem Versionsupgrade nicht die älteren, angepassten Dateien über die neueren, sondern passen diese neu an. Ansonsten besteht die Gefahr, dass neue, notwendige Angaben in den Vorlagendateien fehlen.
Übersicht der verfügbaren Template-Dateien
Die folgende Auflistung vermittelt einen Überblick über die Funktion der einzelnen Dateien:
ApplySymmetricEncryptionPasswordNotice.cshtml
Wenn ein Benutzer eine E-Mail als PDF-Mail verschickt, bekommt er eine Benachrichtigung über das verwendete Passwort, oder eine Info, dass dem Empfänger das Passwort per SMS zugeschickt wurde oder dass die Erstellung der PDF-Mail fehlgeschlagen ist. Der Text der jeweiligen Benachrichtigung steht in dieser Datei. Das Aussehen bzgl. Farben und Logo wird über das CommonMailTemplate festgelegt.
AttachmentManager.cshtml
Wenn über die Inhaltsfilter-Regeln eine Datei von einer E-Mail entfernt wird, erhält der Empfänger eine Info darüber. Der Anhang kann entweder entfernt und gelöscht werden, er kann in das Web Portal hochgeladen werden und er kann ins Web Portal hochgeladen und mit einer Admin-Freigabe belegt werden. Für jede der drei vorgesehenen Aktionen ist ein eigener Text verfügbar, der in dieser Datei editiert werden kann. Das Aussehen bzgl. Farben und Logo wird über das CommonMailTemplate festgelegt.
AttachmentManagerNotificationForBlockedAttachmentsModel.cshtml
Wenn über die Inhaltsfilter-Regeln E-Mails mit bestimmten Datei-Anhängen abgewiesen werden, erhält der Absender eine Info über die Abweisung. Der Inhalt dieser Nachricht kann in dieser Datei festgelegt werden. Das Aussehen bzgl. Farben und Logo wird über das CommonMailTemplate festgelegt.
AttachmentQuarantine.cshtml
Wenn über die Inhaltsfilter-Regeln eine Datei in das Web Portal verschoben und mit einer Admin-Freigabe belegt wird, erhält der Administrator eine Info-Mail darüber. Der Inhalt dieser E-Mail wird in dieser Datei festgelegt. Das Aussehen bzgl. Farben und Logo wird über das CommonMailTemplate festgelegt.
AttachmentQuarantineApproval.cshtml
Wenn über die Inhaltsfilter-Regeln eine Datei in das Web Portal verschoben, mit einer Admin-Freigabe belegt und anschließend durch den Administrator freigegeben wird, erhält der eigentliche Empfänger der Datei eine Info über die Freigabe. Der Inhalt dieser E-Mail wird in dieser Datei festgelegt. Das Aussehen bzgl. Farben und Logo wird über das CommonMailTemplate festgelegt.
CommonMailTemplate.cshtml
In dieser Datei wird das generelle Aussehen von Benachrichtigungen festgelegt. Hier werden zum Beispiel die Farben und die zu verwendenden Logos als HTML-Tag hinterlegt. Alle anderen Dateien außer der “ConvertMailContentToPdfAttachmentActionPdfHeader.cshtml” enthalten nur die Textbausteine.
ConvertMailContentToPdfAttachmentActionPdfHeader.cshtml
Das Aussehen der PDF-Datei wird in dieser Datei festgelegt. Hier müssen erneut Farben und Logos definiert werden.
ConvertMailContentToPdfAttachmentActionTeaser.cshtml
In dieser Datei steht der Text für die Träger-Mail der PDF-Datei. Der Empfänger einer PDF-Mail wird darüber informiert, dass der eigentliche Inhalt der E-Mail im angehängten PDF-Dokument steht. Das Aussehen wird über das CommonMailTemplate festgelegt.
ConvertOfficeDocumentToPdfPreface.cshtml
Mit der “ConvertOfficeDocumentToPDF”-Action ist es möglich, Office-Dokumente in PDF zu wandeln, um dem Empfänger eine Voransicht ohne aktive Inhalte zur Verfügung zu stellen. Vor das erzeugte PDF-Dokument wird eine Information gestellt. Der Inhalt dieser Information wird mit dieser Datei festgelegt.
DeliveryNotificationReport.cshtml
Hier steht der Inhalt des Sendeberichts, wenn ein Benutzer diesen in Outlook angefordert hat. Das Aussehen wird über das CommonMailTemplate festgelegt.
DeMailConnectorIssueEscalationMail.cshtml
Falls NoSpamProxy wiederholt keine De-Mail abholen oder senden kann, wird ein Administrator darüber benachrichtigt. Der Inhalt dieser Nachricht kann hier festgelegt werden.
EncryptedMailNotificationTemplate.cshtml
Wenn ein Benutzer eine E-Mail als “Automatisch verschlüsseln” kennzeichnet und enQsig verfügt über keinen kryptografischen Schlüssel, wird der Empfänger darüber informiert. In dieser Info-Mail steht, welche Optionen er hat. Der Inhalt dieser E-Mail wird in dieser Vorlage festgehalten. Das Aussehen wird über das CommonMailTemplate festgelegt.
EncryptionDelayedNotificationForSender.cshtml
Wenn ein Benutzer eine E-Mail als “Automatisch verschlüsseln” kennzeichnet und enQsig hat keinen kryptografischen Schlüssel, wird der Absender über die Verzögerung informiert. Der Inhalt der Verzögerungsnachricht wird hier festgelegt. Das Aussehen wird über das CommonMailTemplate festgelegt.
EncryptionFailureNotificationForSender.cshtml
Wenn ein Benutzer eine E-Mail als “Automatisch verschlüsseln” kennzeichnet und es tritt ein Fehler bei der Verschlüsselung auf, wird der Absender darüber informiert. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
EncryptionSucceededNotificationForSender.cshtml
Wenn ein Benutzer eine E-Mail als “Automatisch verschlüsseln” kennzeichnet, bekommt er eine Benachrichtigung, sobald die E-Mail verschlüsselt wurde. Das Aussehen wird über das CommonMailTemplate festgelegt.
LargeFileDownloadNotification.cshtml
Wenn der Empfänger einer Datei, die zuvor in das Web Portal verschoben wurde, sie herunterlädt, wird der Absender darüber benachrichtigt. Der Inhalt dieser Information wird mit dieser Datei festgelegt.
MailOnHoldExpired.cshtml
Wenn ein Benutzer eine E-Mail als “Automatisch verschlüsseln” kennzeichnet und enQsig hat keinen kryptografischen Schlüssel und der Empfänger der E-Mail hinterlegt innerhalb von 5 Tagen keinen kryptografischen Schlüssel, wird die E-Mail verworfen und der Absender darüber informiert. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
MailValidationError.cshtml
Wenn eine De-Mail nicht über den De-Mail Konnektor versendet werden kann, wird der Absender darüber benachrichtigt. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
PolicyFailureNonDeliveryMessage.cshtml
Verstößt eine E-Mail gegen Richtlinien im Regelwerk, wird der Absender darüber benachrichtigt. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
QualifiedSignatureIssueEscalationMail.cshtml
Wenn die Prüfung oder Erstellung einer qualifizierten Signatur fehlschlägt, wird eine Benachrichtigung an eine festgelegte Adresse geschickt. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
SampleAutoReply.cshtml
Mit der Aktion “AutoReply” ist es möglich, E-Mails mit einer automatisch erzeugten E-Mail zu beantworten. Der Inhalt dieser Antwort wird hier festgelegt.
SymmetricPasswordUpdateNotification.cshtml
Wenn ein externer Empfänger ein Passwort für die PDF-Mail auf dem WebPortal hinterlegt hat, wird er über die Änderung benachrichtigt. Der Inhalt dieser Nachricht steht hier. Das Aussehen wird über das CommonMailTemplate festgelegt.
WordFilterMatchNotification.cshtml
Der Wortfilter bietet die Möglichkeit einer Benachrichtigung an eine beliebige E-Mail-Adresse, wenn bestimmte Wörter in E-Mails gefunden werden. Der Inhalt dieser Benachrichtigung kann hier definiert werden.
