E-Mail-Anhänge sind statische Dateien, die in E-Mail-Vorlagen als zusätzliche Anlagen eingebunden werden. Typischerweise handelt es sich um PDF-Formulare, Vertragsbedingungen oder Informationsblätter, die unabhängig vom Render-Payload versendet werden.

Statische Anlagen für automatisierte E-Mails


Legen Sie zentrale Dokumente wie Widerrufsbelehrungen oder Tarifübersichten einmalig als E-Mail-Anhang ab und verknüpfen Sie sie anschließend per Identifier in Ihren E-Mail-Vorlagen. Weitere Hinweise zur Verwendung finden Sie in den Use Cases zu E-Mails und Anhängen.

Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:

E-Mail-Anhang-Liste

Die Übersicht zeigt alle statischen Anhänge mit ihren Metadaten und Aktivierungsinformationen.

ID, Identifier, Gruppen-Identifier, Aktiv ab

ID Identifier Gruppen-Identifier Aktiv ab Wert
1identifier_nameNull22.05.2025Beispielwert für Standardwert

ID

Eindeutige Nummer zur internen Identifikation des E-Mail-Anhangs.

Identifier

Eindeutiger Name des E-Mail-Anhangs für Rendering und API-Aufrufe.

Gruppen-Identifier

Eindeutiger Name für eine optionale Gruppierung von verwandten E-Mail-Anhangn. Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.

Aktiv ab

Startdatum eines E-Mail-Anhangs. E-Mail-Anhangs werden erst ab diesem Datum beim Rendern beachtet.

Wert

Der Dateneintrag des E-Mail-Anhangs. Kann Text, Zahlen, Bedingungen oder andere Daten enthalten, die in Vorlagen verwendet werden.

Aktiv, Erstellt am, Aktualisiert am

Validatoren Pausiert Aktiv Erstellt am Aktualisiert am
NullNOJa22.05.2025 16:3722.05.2025 16:37
missing_streetYESNein21.05.2025 19:0022.05.2025 17:02
Validatoren

Zugewiesene Validierungsregeln für das E-Mail-Anhang. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.

Pausiert

Temporäre Deaktivierung des E-Mail-Anhangs. Pausierte Elemente werden nicht verarbeitet.

Aktiv

Aktivierungsstatus des E-Mail-Anhangs. Nur aktive Elemente werden beim Rendern berücksichtigt.

Erstellt am

Zeitstempel der E-Mail-Anhang-Erstellung.

Aktualisiert am

Zeitstempel der letzten Änderung. Zeigt wann E-Mail-Anhang-Konfiguration zuletzt bearbeitet wurde.

Mandant, Standard für Umgebungs-Mandanten

Umgebungs-Mandant Standard für Umgebungs-Mandanten Benutzerdefinierte ID Farbe
(1880) Submarke 1NONull
NullYES<<payload.value>>
Umgebungs-Mandant

Zugeordneter Mandant des/der E-Mail-Anhang. Ermöglicht Mandanten-spezifische Konfiguration.

Standard für Umgebungs-Mandanten

Kennzeichnet E-Mail-Anhang als Standard und vererbt (verfügbar) für alle Umgebungs-Mandanten.

Mandanten-Verknüpfungen sorgen dafür, dass ein/e E-Mail-Anhang nur innerhalb der passenden Submarken (oder ähnliches, wie Tarifwelten) verwendet wird oder an alle Umgebungs-Mandanten vererbt wird.
Diese Felder werden ausschließlich eingeblendet, wenn Sie als Umgebungs-Admin angemeldet sind.
Details zur Anzeige der Mandanten-Spalten finden Sie in der Mandanten-Management-Dokumentation.

Benutzerdefinierte ID

Optionale benutzerdefinierte Kennung nach dem Rendering für externe Systeme. Wird als Referenzen des/der E-Mail-Anhang bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.

Farbe

Visuelle Kennzeichnung für schnelle Identifikation des/der E-Mail-Anhang. Vor allem nützlich für Dashboard-Statistiken und Charts.

Kontext-Aktionen

Aktions-Dropdown

Anzeigen
Ändern
Löschen

Aktions-Dropdown

Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen E-Mail-Anhang.

Anzeigen

Öffnet eine reine Detailansicht der kompletten Meta-Informationen und Einstellungen des E-Mail-Anhang.

Ändern

Öffnet das Bearbeitungsformular für alle Einstellungen und den Upload einer neuen E-Mail-Anhang-Version.

Löschen

Entfernt das E-Mail-Anhang dauerhaft aus dem System. Diese Aktion kann nicht rückgängig gemacht werden.

Spalten konfigurieren

Spalten konfigurieren
Spalten-Konfiguration

Passen Sie die Anzeige der E-Mail-Anhang-Liste für bessere Übersichtlichkeit an. Spalten können per Drag-and-Drop neu angeordnet und über Checkboxen ein-/ausgeblendet werden.

Persönliche Einstellungen

Für mich anwenden : Spalten-Konfiguration wird nur für Ihren Account gespeichert und beeinflusst andere Benutzer nicht.

Instanz-weite Einstellungen

Als Standard anwenden : Konfiguration wird für alle Benutzer der Instanz übernommen und als neue Standard-Ansicht gesetzt.

E-Mail-Anhang erstellen

Formular-Aktionen

Aktions-Buttons zum Speichern und Verwalten der E-Mail-Anhang-Konfiguration.

Erstellen und weiteres Element hinzufügen
Erstellen
Der primäre Button speichert die E-Mail-Anhang-Konfiguration. Der sekundäre Button ermöglicht das Erstellen und direkte Hinzufügen weiterer Elemente.

Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.

Das Erstellungsformular besteht aus einem kompakten Abschnitt mit Identifier-Daten, Dateiname und Datei-Upload. Gruppen-Identifier und Gruppenbedingung sind optional und folgen den gleichen Mechanismen wie bei anderen Vorlagen.

Identifier

Eindeutige Kennung für dieses/r E-Mail-Anhang zur programmatischen Verwendung, Einbindung in Vorlagen, Lookups und API-Zugriff.

Identifiers sollten 'snake_case' sein, also klein geschrieben und Unterstriche verwenden, z.B. 'kunde_name' oder 'rechnung_nummer'.

Eindeutige Kennung für programmatische Verwendung und API-Zugriff
Beschreibung

Interne Beschreibung eines/r E-Mail-Anhang für Identifikation und bessere Übersicht bzw. Dokumentation. Diese Beschreibung wird im Output.Rocks-Backend verwendet und nicht im Output angezeigt.

Beschreibungen sollten kurz und prägnant sein, um Übersichtlichkeit zu gewährleisten. Längere Erklärungen sollten im Feld 'Kommentar' platziert werden.

Interne Beschreibung zur Identifikation und redaktionellen Dokumentation
Gruppen-Identifier

Eindeutige Kennung für die Gruppierung und Organisation von E-Mail-Anhangn.

Elemente einer Gruppe werden gemeinsam verarbeitet und optionale Validatoren können dabei einzelne Elemente aktivieren oder ignorieren.

Gruppen-Identifier sind optional und können bei Bedarf leer gelassen werden.

Gruppen-Identifier sollten 'snake_case' sein, also klein geschrieben und Unterstriche verwenden, z.B. 'kunde_name' oder 'rechnung_nummer'.

Verwendet für die Gruppierung und Kategorisierung von E-Mail-Anhangs
Eine detailierte Einführung in die Verwendung von Gruppen und Validatoren finden Sie unter Module und Validierungen.
Gruppenbedingung

Bedingte Logik für die Auswahl des Elements basierend auf Payload-JSON-Daten. Das Element wird angesprochen, wenn der Gruppen-Identifier mit dem Request übereinstimmt. Es wird aber nur gerendert, wenn die Bedingung erfüllt (true) ist.

kunde.vertragstyp == 'premium' && rechnung.betrag > 1000
Symfony Expression Language für bedingte E-Mail-Anhang-Auswahl. Details: Vorlagen-Gruppen, Conditional Syntax, Operatoren
Eine detailierte Einführung in die Verwendung von Gruppen und Validatoren finden Sie unter Module und Validierungen.
Ziel-Dateiname

Name für die generierte Datei beim E-Mail-Anhang-Rendering.

Name der generierten PDF-Datei (ohne .pdf-Endung)
Platzhalter verwenden:
Der Ziel-Dateiname unterstützt Platzhalter für dynamische Dateinamen. Verwenden Sie <<feldname>> für JSON-Daten und <<or.expression.timestamp({"format":"Y-m-d"})>> für Zeitstempel.

Beispiel: vertragsbestaetigung_<<contract.id>>_<<or.expression.timestamp({"format":"Y-m-d"})>> erzeugt: vertragsbestaetigung_12345_2024-03-15.pdf
Vorlage-Upload

Auswahl der Datei für die E-Mail-Anhang hochladen und verwalten. Nach dem Upload wird hier der Name der Datei im Dateisystem der Cloud angezeigt.

Unterstützt beliebige Dateiformate. Der Anhang wird statisch gespeichert und ohne Rendering versendet.
Anhänge werden unverändert versendet und dienen z.B. für PDF-Hinweise, Bildmaterial oder Textdateien mit Standardinformationen.
Aktiv ab

Startdatum des E-Mail-Anhangs. E-Mail-Anhange werden erst ab diesem Datum beim Rendern beachtet.

Die Aktiv-Checkbox ermöglicht eine sofortige De-/Aktivierung unabhängig vom Datum.

Vor-Terminierung: Mit diesem Feld können E-Mail-Anhange vor-terminiert werden. Setzen Sie ein zukünftiges Datum, um das Element automatisch ab diesem Zeitpunkt zu aktivieren.

Mehrere Elemente mit gleichem Identifier: unterschiedliches 'Aktiv ab' staffelt die Version; bei einer Anfrage gilt das aktive Element mit dem spätesten Aktiv ab (nicht Erstell- oder Änderungsdatum).

31/12/2023
Datum, ab dem das Element aktiv wird
AktivUnabhängig vom Datum sofort (de)aktivieren
Umgebungs-Mandant

Zuordnung zu einem spezifischen Umgebungs-Mandanten oder Standard-Verwendung für alle Mandanten.

None
None
(1880) Test Stadtwerk
Wählen Sie einen Umgebungs-Mandanten aus oder "None" für private Nutzer-Elemente oder Standard-Elemente
Eine detaillierte Einführung in Umgebungs-Mandanten, Vererbung von Standard-Elementen und Mandanten-Konfiguration finden Sie unter Mandanten-Management: Multi-Client Element-System.
Standard für Umgebungs-Mandanten

Markiert Element als Standard-Element, das automatisch an alle Umgebungs-Mandanten vererbt wird.

Aktiviert = Standard-Element wird an alle Umgebungs-Mandanten vererbt und ist für diese sichtbar

Fehlermeldung: Die Kombination "Standard für Umgebungs-Mandanten" + ausgewählter "Umgebungs-Mandant" erzeugt die Fehlermeldung: Tenant defaults can not be set on tenant assigned entities. Ein Element kann entweder für einen spezifischen Mandant ODER als Standard für alle Umgebungs-Mandanten konfiguriert werden.

Eine detaillierte Einführung in Standard-Elemente, Element-Vererbung und die Mandanten-Hierarchie finden Sie unter Mandanten-Management: Multi-Client Element-System.

E-Mail-Anhänge in Workflows

E-Mail-Anhänge werden häufig in folgenden Kombinationen verwendet:

  • E-Mail-Vorlagen: Statische Identifier werden im Feld „E-Mail Anhang-Identifier“ eingetragen.
  • E-Mails und Anhänge: Best Practices zur Pflege von Pflichtdokumenten für EVU-Kunden.
  • Vorlagen: Dynamische PDF-Anhänge ergänzen statische E-Mail-Anhänge für vollständige Versandpakete.