Testing und Werkzeuge
PDF-Overlays
Referenz-PDFs für visuelle Dokumentprüfungen verwalten und in Template-Tests anwenden
PDF-Overlays sind Referenz-PDFs, die über ein gerendertes Dokument gelegt werden. So prüfen Sie schnell, ob Layout, Briefpapier, Seitenränder, Falzmarken oder feste Formularelemente zur erwarteten Vorlage passen.
Der Overlay-Vergleich verändert weder die gespeicherte Vorlage noch den Renderprozess. Er erzeugt nur eine Vergleichsansicht für die aktuelle Dokumentprüfung.
Diese Seite zeigt eine Liste aller Elemente, und darüber diverse Aktionen, die du ausführen kannst:
Overlay-Liste
Die Liste zeigt alle gespeicherten Referenz-PDFs, die für Dokumentprüfungen genutzt werden können. Die Suche findet Treffer im Namen und im Dateinamen. Sortieren erfolgt wie in den anderen Tabellen direkt über die Spaltenköpfe.
| ID | Name | Dateiname | Erstellt am | Aktionen |
|---|---|---|---|---|
| 1 | Deutsche Post | pfs_template_anschreiben_din_a4.pdf | 07.05.2026 10:19 |
Mandant und Vererbung
Overlays sind mandantenbezogen. Wenn Umgebungs-Mandanten aktiv sind, können Overlays einem bestimmten Mandanten zugeordnet oder als Standard für Umgebungs-Mandanten freigegeben werden.
| Umgebungs-Mandant | Standard für Umgebungs-Mandanten |
|---|---|
| (1880) Submarke 1 | NO |
| Null | YES |
Zugeordneter Mandant des/der Overlay. Ermöglicht Mandanten-spezifische Konfiguration.
Kennzeichnet Overlay als Standard und vererbt (verfügbar) für alle Umgebungs-Mandanten.
Erstellt am und Aktualisiert am
Zeitstempel helfen zu erkennen, ob eine Referenz-PDF noch zum aktuellen Stand eines Briefpapiers oder Formulars passt.
| Erstellt am | Aktualisiert am |
|---|---|
Erstellt am
Zeitstempel der Overlay-Erstellung.
Aktualisiert am
Zeitstempel der letzten Änderung. Zeigt wann Overlay-Konfiguration zuletzt bearbeitet wurde.
Kontext-Aktionen
Aktions-Dropdown
Aktions-Dropdown
Klicken Sie auf das Drei-Punkte-Menü am Ende jeder Zeile für Aktionen mit dem jeweiligen Overlay.
Overlay herunterladen
Lädt die Quell-Datei des Overlay auf Ihren Computer herunter.
Anzeigen
Öffnet die Detailansicht mit Vorschau und Download der gespeicherten Referenz-PDF.
Ändern
Öffnet das Bearbeitungsformular. Name, Mandantenzuordnung und optional die PDF-Datei können geändert werden.
Die Detailansicht zeigt die PDF-Vorschau im Browser. Von dort kann die Referenz-PDF heruntergeladen werden, um sie lokal zu prüfen oder mit Fachbereichen abzustimmen.
Overlay erstellen
Beim Erstellen eines Overlays werden ein sprechender Name und eine PDF-Datei gespeichert. Andere Dateitypen werden abgelehnt.
Verwenden Sie einen Namen, der die Referenz eindeutig beschreibt, zum Beispiel Briefpapier, Formularversion oder Postdienstleister.
Nur PDF-Dateien können als Overlay verwendet werden.
Mandantenzuordnung
Zuordnung zu einem spezifischen Umgebungs-Mandanten oder Standard-Verwendung für alle Mandanten.
Wählen Sie einen Umgebungs-Mandanten, wenn das Overlay nur für dessen Dokumentprüfungen sichtbar sein soll. Für eine gemeinsam nutzbare Referenz bleibt die Auswahl leer und kann, je nach Berechtigung, als Standard für Umgebungs-Mandanten markiert werden.
Formular-Aktionen
Aktions-Buttons zum Speichern und Verwalten der Overlay-Konfiguration.
Verwenden Sie "Erstellen und weiteres Element hinzufügen" für effizientes Batch-Erstellen mehrerer Elemente.
Overlay im Template-Test anwenden
Öffnen Sie eine docx-Vorlage über die Kontext-Aktion Testen. Nach einem erfolgreichen Rendering erscheint im Preview-Bereich die Overlay-Prüfung.
Die Vorlage wird mit den aktuellen JSON-Testdaten als PDF gerendert.
Wählen Sie ein gespeichertes Overlay oder laden Sie eine temporäre PDF hoch.
Die Vergleichs-PDF ersetzt die Preview. Mit Zurücksetzen kehren Sie zum Roh-Rendering zurück.
Gespeichertes Overlay
Gespeicherte Overlays sind ideal für regelmäßig genutzte Referenzen wie Briefpapier, Versanddienstleister-Formulare oder finale Formularhintergründe. Nach Auswahl eines gespeicherten Overlays kann der Vergleich erneut angewendet werden, ohne das Dokument neu zu rendern.
Temporärer PDF-Upload
Für einmalige Prüfungen kann im Template-Test eine temporäre PDF hochgeladen werden. Diese Datei wird nur für den aktuellen Vergleich verwendet und nicht in der Overlay-Liste gespeichert.
Temporäre Overlays eignen sich für Abstimmungen mit Fachbereichen, Zwischenstände oder Dateien, die nicht dauerhaft als Referenz dienen sollen.
Zurücksetzen
Die Aktion Zurücksetzen stellt die ursprüngliche, gerenderte PDF wieder her. Das ist hilfreich, wenn Sie zwischen Rohdokument und Overlay-Vergleich wechseln möchten.
Best Practices
- Verwenden Sie Overlays mit derselben Seitengröße wie das gerenderte Dokument, zum Beispiel DIN A4.
- Benennen Sie Referenzen nach Zweck und Version, etwa
dp_briefpapier_2026oderformular_kuendigung_v3. - Prüfen Sie nach Änderungen an Briefpapier, Logo, Rändern oder Fußzeilen immer mit einem aktuellen Overlay.
- Speichern Sie häufig genutzte Referenzen dauerhaft und nutzen Sie temporäre Uploads nur für Einzelfälle.
- Nutzen Sie Testdaten, um die Vorlage mit realistischen Payloads zu rendern, bevor Sie das Overlay anwenden.
Verwandte Bereiche
- docx-Vorlagen: Testumgebung über die Kontext-Aktion einer Vorlage öffnen.
- Vorlagen-Editor: .docx-Dateien mit JSON-Daten rendern und prüfen.
- Testdaten: Reproduzierbare JSON-Datensätze für Template-Tests verwalten.