E-Mail-Vorlagen verwalten

E-Mail-Vorlagen steuern die Betreffzeile und den HTML-Text der Benachrichtigungen, die der MobilityManager versendet. Jede Vorlage ist an eine Sprache und eine Kontext-Entität gebunden, und jede Inhaltsänderung wird als Version aufbewahrt, sodass Sie sehen können, was sich geändert hat und wer es geändert hat. Dieser Artikel zeigt, wie Sie Vorlagen erstellen, bearbeiten und außer Betrieb nehmen.

Erforderliche Berechtigung

Das Anzeigen und Auflisten von Vorlagen erfordert email-templates:view. Das Erstellen, Aktualisieren und Löschen von Vorlagen erfordert email-templates:manage. Diese werden in der Regel SystemAdmin und jeder benutzerdefinierten Rolle gewährt, die für das Nachrichtenwesen verantwortlich ist.

Felder einer Vorlage

Schlüssel — eine stabile Kennung, die zum Nachschlagen der Vorlage beim Versand verwendet wird. Die Kombination aus Schlüssel und Sprache muss eindeutig sein.
Name und Beschreibung — benutzerfreundliche Bezeichnungen für Administratoren.
Kategorie — eine Freitext-Gruppierung, die zum Filtern der Liste verwendet wird.
Sprache — die Sprache der Vorlage (zum Beispiel DE oder EN).
Betreffvorlage und HTML-Textvorlage — der Inhalt, der Platzhalter enthalten kann.
Kontext-Entitätstyp — die Entität (etwa Vehicle oder Booking), deren Felder Sie als Platzhalter referenzieren können.
Aktiv — nur aktive Vorlagen werden für den Versand verwendet.

Eine Vorlage erstellen

Öffnen Sie /admin/email-templates und wählen Sie, eine neue Vorlage hinzuzufügen.
Geben Sie einen eindeutigen Schlüssel und einen aussagekräftigen Namen ein.
Wählen Sie die Sprache und den Kontext-Entitätstyp.
Schreiben Sie den Betreff und den HTML-Text und fügen Sie Platzhalter aus dem Katalog ein.
Speichern. Eine neue Vorlage beginnt aktiv, und Version 1 wird automatisch mit dem Hinweis "Initial version" erfasst.

Hinweis: Wenn bereits eine Vorlage mit demselben Schlüssel und derselben Sprache existiert, wird das Speichern mit einem Fehler DUPLICATE_KEY abgewiesen. Verwenden Sie einen anderen Schlüssel oder bearbeiten Sie stattdessen die vorhandene Vorlage.

Eine Vorlage bearbeiten und Versionen nachverfolgen

Öffnen Sie die Vorlage aus der Liste.
Passen Sie beliebige Felder an. Sie können einen Änderungshinweis hinzufügen, der die Bearbeitung beschreibt.
Speichern.

Wenn sich der Betreffs- oder Textinhalt tatsächlich ändert, speichert die Plattform eine neue Version mit einer erhöhten Versionsnummer, der E-Mail-Adresse des bearbeitenden Benutzers, Ihrem Änderungshinweis und einem Zeitstempel. Das Ändern ausschließlich von Metadaten (Name, Kategorie, Aktiv-Kennzeichen) aktualisiert den Datensatz, ohne eine neue Inhaltsversion zu erstellen.

Tipp: Schreiben Sie bei jeder Inhaltsbearbeitung einen kurzen Änderungshinweis. Der Versionsverlauf wird so zu einem Prüfpfad, der erklärt, warum sich der Wortlaut geändert hat.

Eine Vorlage deaktivieren oder löschen

Das Löschen einer Vorlage ist ein weicher Vorgang: Es setzt die Vorlage auf inaktiv, statt sie zu entfernen. Inaktive Vorlagen werden nicht mehr für den Versand verwendet, bleiben aber zu Referenz- und Verlaufszwecken sichtbar.

Öffnen Sie die Vorlage und entfernen Sie entweder das Kennzeichen Aktiv und speichern Sie, oder verwenden Sie die Löschaktion.
Bestätigen. Die Vorlage nimmt nicht mehr am Rendern teil.

Die Liste filtern

Die Vorlagenliste kann nach Kategorie, Sprache und Aktiv-Status gefiltert werden, was hilfreich ist, wenn Sie parallele DE- und EN-Kopien derselben Nachricht pflegen.

Warnung: Bevor Sie eine bearbeitete Vorlage aktivieren, zeigen Sie eine Vorschau an. Andernfalls erreicht ein fehlerhafter Platzhalter oder fehlerhaftes Markup die Empfänger.