Vorlagen bearbeiten

Worum es geht

Alle Vorlagen liegen in der Datenbank: je Mail und Sprache die Standardfassung, dazu die Fassungen einzelner Mandanten. Sie lassen sich zur Laufzeit ändern, ohne neue Auslieferung. Weil eine Mail im Namen der Plattform verschickt wird, ist genau geregelt, wer was ändern darf.

Die Aufrufe

Ein Editor sieht in der Liste jede Vorlage, ein Mandanten-Administrator nur die Fassungen seines Mandanten. Die Aufrufe gibt es nur, wenn codamai.cias.notification.enabled, persistence: jpa und rest eingeschaltet sind. Sonst antworten sie mit 404, als gäbe es sie nicht.

Eine Vorlage speichern

POST /cias/notification/templates
Authorization: Bearer <Token von Anna, tenant-admin in nordbau>
{
  "key": "WELCOME",
  "locale": "de",
  "subject": "Willkommen bei Nordbau",
  "body": "Guten Tag,\n\nIhr Zugang ist bereit: ${loginUrl}\n\nIhr Nordbau-Team",
  "html": false
}

HTTP 200
{
  "id": "7d2c…",
  "key": "WELCOME",
  "tenantKey": "nordbau",
  "locale": "de",
  "subject": "Willkommen bei Nordbau",
  "body": "Guten Tag, …",
  "html": false,
  "updatedBy": "5c9e…",
  "updatedAt": "2026-10-01T10:15:00Z",
  "origin": "EDITED",
  "isDefault": false
}

Eine Vorlage ist durch Mail, Mandant und Sprache bestimmt. Ohne Mandanten gibt es je Mail und Sprache genau eine: Speichern ohne tenantKey ändert die Standardfassung, es legt nie eine zweite an. Zweimal mit denselben Merkmalen speichern ergibt ebenso eine Vorlage.

Die Prüfung

Wer was darf, je Installation

Welche Rollen Editor sind, stellt codamai.cias.notification.editor-roles ein, oder die Umgebungsvariable CIAS_NOTIFICATION_EDITOR_ROLES. Standard ist platform-admin,mail-template-admin. Welche Mails Mandanten ändern dürfen, legt jede Installation fest. Dafür gibt es absichtlich keinen Standard: Eine Installation, die sich die Frage nicht gestellt hat, startet nicht.

mail-template-admin ist eine Realm-Rolle, siehe Die Realm-Rollen der Plattform. Sie reicht an die Texte aller Mandanten und wird deshalb nie innerhalb eines Mandanten vergeben.

Die Liste für Mandanten ist eine Erlaubnisliste, keine Sperrliste. Neue Mails sind also zunächst für Mandanten gesperrt. Warum gerade diese nicht freigegeben sind:

• VERIFY_EMAIL und PASSWORD_SETUP tragen einen Link, der ein Konto öffnet. Wer sie umformulieren kann, schreibt eine überzeugende Phishing-Mail vom Absender der Plattform.
• ALREADY_REGISTERED geht womöglich an jemanden aus einem ganz anderen Mandanten.
• APPROVAL_PENDING und REJECTED formulieren eine Entscheidung. Wer entscheidet, soll sie nicht nachträglich umschreiben.

Die Ausprägungen

Was eine Vorlage kann

Vorlagen sind in FreeMarker geschrieben, einer Vorlagensprache. Du kannst Platzhalter einsetzen (${loginUrl}) und einfache Bedingungen schreiben:

<#if passwordUrl?has_content>
Vergeben Sie jetzt Ihr Passwort: ${passwordUrl}
<#else>
Melden Sie sich an: ${loginUrl}
</#if>

Mehr nicht. Weil jemand anderes als die Entwickler Vorlagen schreibt, ist FreeMarker abgeriegelt: Eine Vorlage kann keine Klassen erzeugen, keine Methoden aufrufen und nicht an die Objekte dahinter gelangen. Sie sieht nur die Werte des Kontexts, dazu in jeder Mail ${application} und ${flow}.

Beim Speichern erzeugt CIAS die Vorlage einmal probeweise, mit derselben abgeriegelten Einstellung und mit leeren Werten für alle Platzhalter. Eine Vorlage, die sich so nicht erzeugen lässt, wird abgelehnt. Prüfe trotzdem mit einer echten Mail, ob der Text so ankommt, wie du willst: Platzhalter mit Werten verhalten sich manchmal anders als leere.

Fehler auf einen Blick

Fallen

Weiter

• Wie die passende Vorlage gefunden wird
• Versand und Branding
• Die Verwaltungsoberfläche