Statische Anhänge sind zentral gepflegte Dateien, die unabhängig vom Render-Payload gespeichert werden. Sie können in E-Mail-Vorlagen als zusätzliche Anlagen verwendet werden und bei Dokument-Vorlagen als statische PDF-Seiten an das gerenderte PDF angefügt werden.

Einmal pflegen, mehrfach verwenden


Legen Sie zentrale Dokumente wie AGB, Widerrufsbelehrungen, SEPA-Mandate oder Tarifübersichten einmalig als statischen Anhang ab. Danach referenzieren Sie diese Dateien per Identifier in E-Mail-Vorlagen oder im Tab Statische PDF-Anhänge einer Dokument-Vorlage.

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

Statische-Anhänge-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 Statischer Anhangs.

Identifier

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

Gruppen-Identifier

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

Aktiv ab

Startdatum eines Statischer Anhangs. Statischer Anhangs werden erst ab diesem Datum beim Rendern beachtet.

Wert

Der Dateneintrag des Statischer 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 Statischer Anhang. Prüfen Ihre Bedingungen vor der Verarbeitung und aktivieren/deaktivieren das Rendering entsprechend.

Pausiert

Temporäre Deaktivierung des Statischer Anhangs. Pausierte Elemente werden nicht verarbeitet.

Aktiv

Aktivierungsstatus des Statischer Anhangs. Nur aktive Elemente werden beim Rendern berücksichtigt.

Erstellt am

Zeitstempel der Statischer Anhang-Erstellung.

Aktualisiert am

Zeitstempel der letzten Änderung. Zeigt wann Statischer 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 Statischer Anhang. Ermöglicht Mandanten-spezifische Konfiguration.

Standard für Umgebungs-Mandanten

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

Mandanten-Verknüpfungen sorgen dafür, dass ein/e Statischer 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 Statischer Anhang bei Callbacks übergeben und beherrscht Vorlagen-Syntax inkl. Zugriff auf Payload-Daten.

Farbe

Visuelle Kennzeichnung für schnelle Identifikation des/der Statischer 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 Statischer Anhang.

Anzeigen

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

Ändern

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

Löschen

Entfernt das Statischer 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 Statischer 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.

Statischen Anhang erstellen

Formular-Aktionen

Aktions-Buttons zum Speichern und Verwalten der Statischer Anhang-Konfiguration.

Erstellen und weiteres Element hinzufügen
Erstellen
Der primäre Button speichert die Statischer 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 Identifier-Daten, Dateiname, Datei-Upload sowie optionalem Gruppen-Identifier und Gruppenbedingung. Gruppenbedingungen folgen denselben Mechanismen wie bei anderen gruppierbaren Konfigurationen.

Identifier

Eindeutige Kennung für dieses/r Statischer 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 Statischer 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 Statischer 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 Statischer 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 Statischer 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 Statischer 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 Statischer Anhang hochladen und verwalten. Nach dem Upload wird hier der Name der Datei im Dateisystem der Cloud angezeigt.

Unterstützt beliebige Dateiformate. Für Dokument-Vorlagen werden nur gültige PDF-Dateien an PDF-Ausgaben angefügt.
Nicht-PDF-Dateien können weiterhin für E-Mail-Vorlagen genutzt werden. Bei Dokument-Vorlagen werden sie nicht an das gerenderte PDF angefügt.
Aktiv ab

Startdatum des Statischer Anhangs. Statischer 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 Statischer 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.

Statische Anhänge in Workflows

  • E-Mail-Vorlagen: Statische Anhänge werden direkt an die erzeugte E-Mail angehängt, ohne eigenen Rendering-Prozess.
  • Dokument-Vorlagen: Im Tab Statische PDF-Anhänge ausgewählte PDF-Dateien werden bei PDF-Ausgaben nach dem gerenderten Dokument angefügt.
  • Gruppen und Bedingungen: Wird ein Gruppen-Identifier referenziert, entscheidet die Gruppenbedingung des statischen Anhangs, ob die Datei für den konkreten Request angewendet wird.

Beim Anhängen an Dokument-Vorlagen werden statische PDFs erst nach der abrechnungsrelevanten Seitenzählung angefügt. Die angehängten Seiten erhöhen daher nicht die abrechnungsrelevanten Seiten (billablePages).

Für Dokument-Vorlagen werden ausschließlich gültige PDF-Dateien angefügt. Andere Dateitypen bleiben als statische Anhänge erhalten und können weiterhin in E-Mail-Vorlagen verwendet werden.