Eine E-Mail-Vorlage in der Vorschau anzeigen und rendern

Bevor eine E-Mail-Vorlage die Empfänger erreicht, zeigen Sie eine Vorschau an. Der MobilityManager rendert Ihren Betreff und Text mit realistischen Beispieldaten, sodass Sie fehlerhafte Platzhalter und Markup-Fehler gefahrlos erkennen können. Dieser Artikel erläutert die zwei Vorschaumodi und wie das Ergebnis zu lesen ist.

Erforderliche Berechtigung

Die Vorschau erfordert email-templates:view — dieselbe Berechtigung, mit der Sie eine Vorlage öffnen. Sie benötigen keine Verwaltungsrechte für die Vorschau, sodass Prüfer den Wortlaut kontrollieren können, ohne ihn ändern zu können.

Zwei Möglichkeiten zur Vorschau

Eine gespeicherte Vorlage in der Vorschau anzeigen

Öffnen Sie die Vorlage unter /admin/email-templates.
Wählen Sie Vorschau.
Die Plattform lädt die Vorlage, erstellt einen Beispielkontext aus ihrem Kontext-Entitätstyp und gibt den gerenderten Betreff und Text zurück.

Ungespeicherte Inhalte in der Vorschau anzeigen

Sie können auch einen noch nicht gespeicherten Entwurf in der Vorschau anzeigen, indem Sie einen Betreff, einen HTML-Text und einen Kontext-Entitätstyp angeben. Diese "Roh"-Vorschau rendert genau das, was Sie eingegeben haben, anhand von Beispieldaten, was ideal ist, während Sie noch bearbeiten.

Wie Beispieldaten generiert werden

Die Vorschau verwendet keine echten Datensätze. Stattdessen generiert sie für jedes Feld einen Platzhalterwert basierend auf seinem Datentyp:

Datentyp	Beispielwert
`string` / `enum`	Der Anzeigename des Feldes in Klammern, z. B. `[License Plate]`
`number`	`42`
`decimal`	`99.99`
`boolean`	`true`
`date`	Das heutige Datum im ISO-Format
`guid`	Eine feste Beispielkennung

Das Erscheinen von [License Plate] in der Ausgabe bestätigt, dass der Platzhalter zu einem echten Feld aufgelöst wurde. Wenn ein Platzhalter stattdessen leer gerendert wird, existiert der Pfad wahrscheinlich nicht auf dieser Kontext-Entität.

Hinweis: Da die Beispielwerte synthetisch sind, verwenden Sie die Vorschau, um Struktur und Platzhalterauflösung zu überprüfen, nicht die endgültigen Zahlen. Genaue Beträge und Daten stammen aus Live-Datensätzen, wenn die E-Mail tatsächlich versendet wird.

Render-Fehler lesen

Der Renderer analysiert Betreff und Text getrennt. Wenn eines von beiden ein Syntaxproblem aufweist, gibt die Vorschau einen Fehler mit einer Meldung zurück, die benennt, wo der Fehler liegt:

Subject parse error — die Betreffvorlage konnte nicht analysiert werden.
Body parse error — die HTML-Textvorlage konnte nicht analysiert werden.

Häufige Ursachen sind ein nicht geschlossener {{ }}-Ausdruck oder eine fehlerhafte Schleife. Beheben Sie den gemeldeten Abschnitt und zeigen Sie erneut eine Vorschau an.

Tipp: Zeigen Sie sowohl die DE- als auch die EN-Variante derselben Nachricht in der Vorschau an. Es sind separate Vorlagen, sodass eine Korrektur in einer Sprache nicht auf die andere übertragen wird.

Warnung: Aktivieren Sie niemals eine Vorlage, die Sie nicht in der Vorschau angezeigt haben. Ein Analysefehler blockiert das Rendern vollständig, und ein nicht aufgelöster Platzhalter erzeugt eine Leerstelle im Posteingang des Empfängers.