10.3 Nachrichtenvorlagen — E-Mail- und Benachrichtigungsvorlagen erstellen

10.3 Nachrichtenvorlagen — E-Mail- und Benachrichtigungsvorlagen erstellen

Definieren Sie Vorlagen für automatisch versendete E-Mails, interne Benachrichtigungen und Push-Nachrichten — mit Platzhaltern, Empfängerregeln und Versandbedingungen.

1

Übersicht

Nachrichtenvorlagen definieren den Inhalt und das Format von automatisch versendeten E-Mails und Benachrichtigungen. Sie verwenden Platzhalter für dynamische Daten, die beim Versand durch die tatsächlichen Werte aus dem jeweiligen Datenobjekt ersetzt werden.

Eine Vorlage besteht aus mehreren Bereichen:

  • Nachricht — Betreff und Inhalt mit Platzhaltern
  • Versand — Empfänger (Benutzer, Rollen, Bereiche, E-Mail-Adressen)
  • Versandbedingung — Filterregeln, wann die Nachricht gesendet wird
  • Test — Vorschau und Testversand mit echten Daten
Unser Beispiel für diese Anleitung
Auftragsbestätigung per E-Mail

Sie möchten bei jedem neuen Auftrag automatisch eine Bestätigungs-E-Mail an den Kunden senden. Die Vorlage enthält Platzhalter für Kundenname, Auftragsnummer und Datum. Der Versand erfolgt nur, wenn der Auftragsstatus auf „Bestätigt“ gesetzt wird.

2

Schritt 1: Nachrichtenvorlage anlegen

Navigieren Sie in der Admin-Oberfläche zum Bereich „Nachrichtenvorlagen“. Dieser befindet sich im Kontextmenü einer App unter dem Punkt „Nachrichtenvorlagen“.

  1. App öffnen und „Nachrichtenvorlagen“ wählen

    Wählen Sie die App aus, in der die Vorlage erstellt werden soll. Im Bereich „Nachrichtenvorlagen“ sehen Sie die Liste aller bestehenden Vorlagen.

  2. „Neu“ klicken

    Klicken Sie auf den Button „Neu“, um eine neue Vorlage anzulegen. Es öffnet sich die Detail-Seite.

  3. Grunddaten eingeben

    Vergeben Sie einen Vorlagennamen (z. B. Auftragsbestätigung) und optional eine Beschreibung. Wählen Sie das Objekt (Entity) aus, auf das sich die Vorlage bezieht — in unserem Beispiel die Tabelle „Auftrag“.

3

Schritt 2: Betreff und Nachrichteninhalt definieren

Wechseln Sie zum Reiter „Nachricht“. Hier definieren Sie den Betreff und den Nachrichtentext.

  1. Betreff eingeben

    Der Betreff kann ebenfalls Platzhalter enthalten. Beispiel: Auftragsbestätigung Nr. {{Auftragsnummer}}

  2. Nachrichtentext verfassen

    Geben Sie den Nachrichtentext ein. Verwenden Sie Platzhalter in der Form {{Feldname}}, um dynamische Daten einzufügen.

HTML vs. Klartext Der Nachrichtentext wird als Klartext eingegeben. Für E-Mail-Versand wird der Text automatisch in ein HTML-Template eingebettet. Wenn Sie ein eigenes HTML-Layout benötigen, können Sie über die Code-Funktion eine individuelle Report-Vorlage zuordnen.
4

Schritt 3: Platzhalter einfügen

Platzhalter werden in doppelten geschweiften Klammern geschrieben: {{Feldname}}. Beim Versand ersetzt UDM jeden Platzhalter durch den tatsächlichen Wert des jeweiligen Datensatzes.

Sie können Platzhalter auf zwei Wegen einfügen:

  • Manuell — Schreiben Sie {{Feldname}} direkt in den Text
  • Per Auswahl — Wählen Sie ein Feld aus der Dropdown-Liste „Platzhalter einfügen“. Der Platzhalter wird automatisch an der Cursor-Position eingefügt.

Platzhalter-Typen und Formatierung

Platzhalter-Typ Beispiel Ausgabe
Textfeld {{Kundenname}} Müller GmbH
Zahlenfeld {{Auftragsnummer}} 2026-00142
Datumsfeld {{Auftragsdatum}} 13.03.2026
Nachschlagefeld (Lookup) {{Status}} Bestätigt
Boolsches Feld {{IstExpress}} Ja / Nein
Tipp: Inhaltsdatenquelle verwenden Standardmäßig stehen die Felder der zugeordneten Entity als Platzhalter zur Verfügung. Wenn Sie zusätzliche Daten benötigen (z. B. berechnete Felder oder verknüpfte Tabellen), können Sie eine Inhaltsdatenquelle (Content-Datasource) zuordnen. Die Felder dieser Datenquelle stehen dann ebenfalls als Platzhalter bereit.
AdminClient → Nachrichtenvorlage → Inhalt & Empfänger
Vorlage
Titel
Auftragsbestätigung Versand
Kanal
E-Mail
Entität
Auftrag
Inhalt
Empfänger
{{KundeEmail}}
Betreff
Ihre Bestellung {{AuftragsNr}} ist unterwegs
Inhalt
Hallo {{KundeName}}, Ihr Auftrag wurde am {{Versanddatum}} versendet…
UserClient → Vorschau der gerenderten E-Mail
Ihre Bestellung A-2026-0418 ist unterwegs
an: maria.muster@acme.de
Hallo Maria Muster,
Ihr Auftrag wurde am 03.05.2026 versendet. Voraussichtliche Lieferung: 06.05.2026.
Platzhalter aufgelöst Express: Nein
5

Schritt 4: Empfänger konfigurieren

Wechseln Sie zum Reiter „Versand“. Hier legen Sie fest, an wen die Nachricht gesendet wird.

Jeder Empfänger hat einen Typ, der den Versandkanal bestimmt:

Empfänger-Typ Beschreibung
Intern UDM-interne Benachrichtigung an einen Benutzer, eine Rolle oder einen Bereich
Mail E-Mail an eine feste Adresse oder ein Adressfeld im Datensatz
Push Push-Benachrichtigung an die Smartphone-App des Empfängers
SMS SMS an eine Telefonnummer (Feld oder feste Nummer)

In unserem Beispiel: Wir fügen zwei Empfänger hinzu:

  • Typ Mail mit dem Quellfeld KundenEmail — die E-Mail-Adresse wird aus dem Auftragsdatensatz gelesen
  • Typ Intern an die Rolle „Vertrieb“ — damit das Vertriebsteam ebenfalls informiert wird

Zusätzlich können Sie pro Empfänger eine Lesebestätigung anfordern. UDM protokolliert dann, ob und wann die Nachricht gelesen wurde.

6

Schritt 5: Vorlage einer Aktion zuordnen

Damit die Nachricht automatisch versendet wird, muss die Vorlage einer Aktion zugeordnet werden. Die Zuordnung erfolgt über die Konfiguration des Datenobjekts:

  1. Datenobjekt öffnen

    Navigieren Sie zur Konfiguration des Objekts, das die Nachricht auslösen soll (z. B. „Auftrag“).

  2. Aktion konfigurieren

    Im Bearbeitungsdialog oder über die Aktions-Konfiguration ordnen Sie die Nachrichtenvorlage zu. Die Vorlage wird ausgeführt, wenn der entsprechende Trigger eintritt (z. B. Datensatz gespeichert).

  3. Versandbedingung definieren (optional)

    Im Reiter „Versandbedingung“ der Vorlage können Sie einen Filter definieren. Die Nachricht wird nur gesendet, wenn der Datensatz die Filterbedingung erfüllt — z. B. nur wenn Status = Bestätigt.

Tipp: Vorlagen testen Bevor Sie eine Vorlage produktiv einsetzen, nutzen Sie den Reiter „Test“. Dort sehen Sie eine Vorschau mit echten Datensätzen und können einen Testversand auslösen. Der Test-Modus erstellt die Nachricht, ohne sie tatsächlich zu versenden. Mit dem „Echt-Test“ wird die Nachricht real zugestellt — verwenden Sie dies nur mit Testempfängern.
7

Ergebnis unseres Beispiels

Nach der Konfiguration haben wir:

  • Eine Nachrichtenvorlage „Auftragsbestätigung“ mit Platzhaltern für Kundenname, Auftragsnummer und Datum
  • Zwei Empfänger: E-Mail an die Kunden-Adresse aus dem Datensatz und intern an die Rolle „Vertrieb“
  • Eine Versandbedingung, die den Versand auf Status = Bestätigt beschränkt
  • Einen erfolgreichen Testlauf mit realen Vorschaudaten
8

Konfigurationsoptionen im Überblick

Einstellung Beschreibung
Vorlagenname Eindeutiger Name der Vorlage (wird in der Vorlagenliste und bei der Zuordnung angezeigt)
Beschreibung Optionale Beschreibung zum Verwendungszweck der Vorlage
Objekt (Entity) Das Datenobjekt, dessen Felder als Platzhalter verfügbar sind und das den Versand auslöst
Inhaltsdatenquelle Optionale Datenquelle mit zusätzlichen Feldern (z. B. berechnete Spalten, Joins)
SMTP-Konto Das E-Mail-Konto, über das der Versand erfolgt (nur bei E-Mail-Empfängern relevant)
Bearbeitungsdialog Optionale Zuordnung eines Dialogs, der bei interner Benachrichtigung geöffnet wird
Report-Vorlage Optionale Zuordnung einer Report-Vorlage für individuelles E-Mail-Layout
Achtung: SMTP-Konfiguration erforderlich Für den E-Mail-Versand muss ein SMTP-Konto in den Systemeinstellungen konfiguriert sein. Ohne gültiges SMTP-Konto werden E-Mails nicht zugestellt. Interne Benachrichtigungen und Push-Nachrichten funktionieren unabhängig davon.
9

Häufige Fragen

Frage Antwort
Was passiert, wenn ein Platzhalter keinen Wert hat? Der Platzhalter wird durch einen leeren String ersetzt. Die Nachricht wird trotzdem versendet.
Kann eine Vorlage mehrere Empfänger haben? Ja. Sie können beliebig viele Empfänger mit unterschiedlichen Typen (Mail, Intern, Push, SMS) hinzufügen.
Kann ich die E-Mail-Adresse dynamisch aus einem Feld lesen? Ja. Wählen Sie beim Empfänger ein Quellfeld aus. Die Adresse wird dann zur Laufzeit aus dem Datensatz gelesen.
Wie teste ich eine Vorlage, ohne echte E-Mails zu versenden? Nutzen Sie den Button „Testen“ im Test-Reiter. Er erstellt die Nachricht intern, ohne sie tatsächlich zuzustellen. Den generierten Inhalt sehen Sie in der Nachrichten-Übersicht.
Kann ich eigenen Code für die Nachrichtenerzeugung verwenden? Ja. Über den Button „Code“ können Sie einen benutzerdefinierten Code-Container anlegen, der die Nachrichtenerzeugung individuell steuert.
Werden gesendete Nachrichten protokolliert? Ja. Im Reiter „Nachrichten“ sehen Sie alle erzeugten Nachrichten mit Status, Zeitstempel und Statustext.
Kann ich eine Versandbedingung definieren? Ja. Im Reiter „Versandbedingung“ können Sie einen Filter konfigurieren. Die Nachricht wird nur gesendet, wenn der auslösende Datensatz die Bedingung erfüllt.