Testing und Werkzeuge

Vorlagen-Editor

Editor für .docx-Vorlagen-Bearbeitung mit Live-Preview

Der Vorlagen-Editor ist ein Rendering-Engine-Editor für .docx-Vorlagen für Live-Previews ihrer Vorlagen. Laden Sie eine .docx-Vorlage hoch oder verlinken Sie eine Datei aus OneDrive oder DropBox, bearbeiten Sie dazu JSON-Testdaten und sehen Sie dann das gerenderte PDF in Echtzeit.

Der Vorlagen-Editor bietet Live-Preview-Funktionalität für die Entwicklung und das Testen von .docx-Vorlagen. Änderungen an JSON-Daten werden sofort im Preview-Bereich sichtbar.

Quellen

Der Vorlagen-Editor unterstützt drei verschiedene Methoden zum Laden von .docx-Vorlagen. Generieren Sie einen Link zum Teilen über OneDrive oder Dropbox und fügen Sie den Link in das entsprechende Feld ein. Der Vorlagen-Editor wird bei jedem Klick auf "Rendern" die aktuelle Version des Dokuments herunterladen und verwenden. Alternativ können Sie das bearbeitete Dokument unter "Direct Upload" hochladen.

OneDrive-Link *

Fügen Sie den OneDrive-Link in das Datei-Feld ein.

Rendern

Editor-Bereich

Der Editor-Bereich ist in zwei Spalten aufgeteilt: Links befinden sich die Konfigurationsfelder, rechts die Live-Preview.

Legacy-Modus

Legacy

Aktiviert die Legacy-Rendering-Engine mit LibreOffice Version 5.2.7.2.

Vorlagen mit aktiviertem Legacy-Flag werden auf einer Rendering-Engine mit der Legacy LibreOffice Version 5.2.7.2 gerendert.

Umgebungs-Mandant

Wählen Sie einen Umgebungs-Mandanten aus, um die Vorlage so zu rendern, wie sie in der entsprechenden Mandanten-Umgebung gerendert würde. Diese Option ist nur sichtbar, wenn Sie Administrator einer gesamten Umgebungs-Instanz sind.

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.

JSON-Daten

Jedes Testrendering benötigt einen Datensatz, um Felder und Platzhalter in der Vorlage einzusetzen. Sie können die JSON-Daten manuell schreiben oder über den "Testdaten laden" Button gespeicherte Testdaten aus dem Backend laden. Die geladenen Testdaten können vor jedem Rendern bearbeitet werden.

Testdaten laden
[
{
"key": "value",
"items": [1, 2, 3]
},
{
"nested": {
"property": "value"
}
}
]
Ein JSON-Array mit strukturierten Daten für Vorlage.

Verwenden Sie den "Testdaten laden" Button, um schnell gespeicherte Testdaten aus dem Testdaten-Bereich zu laden.

Diagramme

Diagramme

Wählen Sie Diagramme aus, die für diese Vorlage verfügbar sein sollen.

chart_identifier, chart_identifier2, ...
Mehrfachauswahl möglich. Die ausgewählten Diagramme werden für die Vorlage vorgerendert.
Autocomplete mit freihändiger Eingabe: Das Feld unterstützt Autocomplete für bereits im System angelegte Identifier. Sie können jedoch auch freihändig neue Identifier eingeben, die noch nicht im System existieren. Mehrere Identifier werden durch Komma getrennt.
Vorschau: Dropdown mit Autofill-Vorschlägen
rechn
rechnung_januar_2024
rechnung_februar_2024
rechnung_muster_kunde
rechnungsvorlage_standard
Beispiel: Bei Eingabe von "rechn" werden passende Identifier-Vorschläge angezeigt. Sie können einen Vorschlag auswählen oder die Eingabe fortsetzen.

Ohne diese Vorauswahl können Bildmarken für Diagramme in ihren docx-Vorlagen nicht mit dynamisch vorgerenderten Diagrammen ersetzt werden.

Eine detaillierte Einführung in die Verwendung von Diagrammen und deren Integration in Vorlagen finden Sie unter Datenvisualisierung mit Tabellen und Diagrammen.

QR-Codes

QR-Codes

Wählen Sie QR-Codes aus, die für diese Vorlage verfügbar sein sollen.

qrcode_identifier, qrcode_identifier2, ...
Mehrfachauswahl möglich. Die ausgewählten QR-Codes werden für die Vorlage vorgerendert.
Autocomplete mit freihändiger Eingabe: Das Feld unterstützt Autocomplete für bereits im System angelegte Identifier. Sie können jedoch auch freihändig neue Identifier eingeben, die noch nicht im System existieren. Mehrere Identifier werden durch Komma getrennt.
Vorschau: Dropdown mit Autofill-Vorschlägen
rechn
rechnung_januar_2024
rechnung_februar_2024
rechnung_muster_kunde
rechnungsvorlage_standard
Beispiel: Bei Eingabe von "rechn" werden passende Identifier-Vorschläge angezeigt. Sie können einen Vorschlag auswählen oder die Eingabe fortsetzen.

Ohne diese Vorauswahl können Bildmarken für QR-Codes in ihren docx-Vorlagen nicht mit dynamisch vorgerenderten QR-Codes ersetzt werden.

Eine detaillierte Einführung in die Erstellung und Integration von QR-Codes finden Sie unter QR-Codes: Kundenkommunikation interaktiv weiterleiten.

Preview-Bereich

Der Preview-Bereich zeigt das gerenderte PDF in Echtzeit. Nach dem Klick auf "Rendern" wird die Vorlage mit den konfigurierten JSON-Daten gerendert und im Preview-Bereich angezeigt.

Vorschau Dokument

Das gerenderte PDF wird hier nach dem Rendering angezeigt. Anschließend können Sie den Download direkt auslösen oder mit neuen Testdaten weiter rendern.

Preview wird nach dem Rendern angezeigt

Dokument herunterladen
Nach jedem Render-Schritt steht das dokument zum Download bereit. Fehler werden unterhalb des Panels angezeigt.

PDF-Overlay-Vergleich

Nach einem erfolgreichen Rendering kann das gerenderte PDF mit einem PDF-Overlay verglichen werden. Wählen Sie dafür ein gespeichertes Overlay oder laden Sie eine temporäre Referenz-PDF hoch. Die Vergleichsansicht ersetzt die Preview und kann jederzeit wieder auf das rohe Rendering zurückgesetzt werden.

Overlays eignen sich besonders für Briefpapier, feste Formularhintergründe, Falzmarken und Layoutprüfungen gegen externe Referenzen.

Fehlerbehandlung

Bei Rendering-Fehlern wird eine Fehlermeldung im Preview-Bereich angezeigt:

Fehlermeldung wird hier angezeigt

Verwandte Bereiche

  • Testdaten: Verwalten Sie gespeicherte Testdaten für den Vorlagen-Editor
  • PDF-Overlays: Referenz-PDFs für visuelle Dokumentprüfungen verwalten
  • docx-Vorlagen: Verwaltung von .docx-Vorlagen im Backend
  • Output.Rocks-Syntax: Vollständige Syntax-Dokumentation für Vorlagen