Ü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
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.
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“.
-
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.
-
„Neu“ klicken
Klicken Sie auf den Button „Neu“, um eine neue Vorlage anzulegen. Es öffnet sich die Detail-Seite.
-
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“.
Schritt 2: Betreff und Nachrichteninhalt definieren
Wechseln Sie zum Reiter „Nachricht“. Hier definieren Sie den Betreff und den Nachrichtentext.
-
Betreff eingeben
Der Betreff kann ebenfalls Platzhalter enthalten. Beispiel:
Auftragsbestätigung Nr. {{Auftragsnummer}} -
Nachrichtentext verfassen
Geben Sie den Nachrichtentext ein. Verwenden Sie Platzhalter in der Form
{{Feldname}}, um dynamische Daten einzufügen.
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 |
Ihr Auftrag wurde am 03.05.2026 versendet. Voraussichtliche Lieferung: 06.05.2026.
Platzhalter aufgelöst Express: Nein
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 |
| 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.
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:
-
Datenobjekt öffnen
Navigieren Sie zur Konfiguration des Objekts, das die Nachricht auslösen soll (z. B. „Auftrag“).
-
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).
-
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.
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ätigtbeschränkt - Einen erfolgreichen Testlauf mit realen Vorschaudaten
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 |
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. |