Erfahren Sie in diesem Artikel,
- welche Möglichkeiten über den PDF Editor geboten und
- welche Optionen damit definiert werden.
1. Einführung
Der $PRODUCT_NAME_PDF_EDITOR stellt eine direkte Verbindung zu Enfocus Switch über die offizielle Switch Web API her. Zusätzliche Komponenten sind für die Integration nicht erforderlich. Voraussetzung ist eine entsprechende Lizenzierung von Switch, beispielsweise ber die Optionen Switch Client Modules oder Switch Web Service.
Der $PRODUCT_NAME_PDF_EDITOR fungiert dabei als Client und ermöglicht die Übergabe, Bearbeitung und Rückgabe von PDF-Aufträgen innerhalb eines Switch-Workflows. Unterstützt werden ausschließlich PDF-Dateien.
2. Verbindung zu Enfocus Switch
Die Integration stellt eine durchgängige Verarbeitung von PDF-Jobs innerhalb eines Workflows sicher und umfasst folgende Funktionen:
- Übermittlung von PDF-Jobs an Switch
- Öffnen und Bearbeiten von Jobs aus Switch heraus
- Rückgabe (Check-in) von bearbeiteten Jobs in den Workflow
- Vollständige Unterstützung von Metadaten (Lesen und Schreiben)
- Anzeige von Preflight-Berichten direkt im PDF Editor
Durch diese Funktionen kann der PDF Editor sowohl für manuelle Eingriffe als auch für kontrollierte Korrekturschritte innerhalb automatisierter Prozesse eingesetzt werden.
2.1. Einstiegspunkte in den Workflow
Für die Integration in Switch stehen zwei zentrale Einstiegspunkte zur Verfügung, über die der Datenaustausch erfolgt:
Submit Point
Der Submit Point dient zur Übergabe von Jobs aus dem PDF Editor an Switch. Dabei werden zwei Modi unterstützt:
- Job only – ws wird ausschließlich die PDF-Datei übergeben
- Job and metadata – zusätzlich zur PDF-Datei werden Metadaten mit übertragen
In beiden Fällen erfolgt die Übergabe dateibasiert. Werden Metadaten mitgegeben, stehen diese im weiteren Workflow vollständig zur Verfügung.
Checkpoint
Der Checkpoint ermöglicht den gezielten Zugriff auf Jobs innerhalb des Workflows. Hier können PDF-Dateien geöffnet, bearbeitet und anschließend wieder in Switch zurückgeführt werden.
Zusätzlich stehen im Checkpoint folgende Funktionen zur Verfügung:
- Öffnen und Bearbeiten von PDF-Jobs
- Ersetzen bestehender Dateien
- Definition mehrerer Ausgabevarianten
- Vollständige Unterstützung von Metadaten
- Sperren und Entsperren von Jobs
Beim Öffnen eines Jobs kann dieser gesperrt werden, um parallele Zugriffe zu verhindern. Die Sperre wird automatisch aufgehoben, sobald der Job wieder in den Workflow zurückgegeben wird.
2.2. Preflight-Berichte
Der $PRODUCT_NAME_PDF_EDITOR unterstützt die Anzeige von Preflight-Berichten, sofern diese als Datensatz am Job vorhanden sind. Voraussetzung hierfür ist ein JSON-Dataset mit dem Namen pdfEditorReportFull, das der Spezifikation von PrePress Digital entspricht.
Ist ein entsprechender Datensatz vorhanden, wird der Report automatisch im $PRODUCT_NAME_PDF_EDITOR angezeigt und kann im Rahmen der Bearbeitung eingesehen werden. Dadurch wird eine direkte Qualitätskontrolle innerhalb des Editors ermöglicht.
Da pdfToolbox Preflight-Berichte standardmäßig im XML-Format erzeugt, ist für die Anzeige im PDF Editor eine Konvertierung in das erforderliche JSON-Format notwendig. Hierfür wird eine vordefinierte XSL-Transformation bereitgestellt, die im pdfToolbox Switch-Konfigurator eingesetzt werden kann.
XSL-Datei
Die XSL-Datei, die in den pdfToolBox Switch-Konfigurator eingesetzt werden muss, steht hier zu Download bereit.
Zur Einrichtung der Report-Anzeige sind folgende Schritte erforderlich:
- Verarbeitung eines PDF-Dokuments in Switch mittels pdfToolbox
- Erstellung eines Preflight-Berichts im XML-Format
- Anwendung der bereitgestellten XSL-Transformation im pdfToolbox Switch-Konfigurator
- Anhängen des erzeugten JSON-Datensatzes mit dem Namen pdfEditorReportFull an den Job
- Öffnen des Jobs im PDF Editor zur Anzeige des Reports
2.3. Ablage der XSL-Datei
Für die Verwendung der bereitgestellten XSL-Transformation ist es erforderlich, die Datei an einem geeigneten Speicherort innerhalb der Switch- bzw. pdfToolbox-Umgebung abzulegen. Empfohlen wird die Ablage in der dafür vorgesehenen Verzeichnisstruktur der pdfToolbox-Installation, sodass die Datei im Switch-Konfigurator direkt ber die Funktion Select from Library ausgewählt werden kann.
In der Regel erfolgt die Ablage im Bereich der Report- bzw. XSLT-Ressourcen innerhalb der pdfToolbox-Verzeichnisse. Durch die Ablage in diesem Verzeichnis wird sichergestellt, dass die XSL-Datei zentral verfügbar ist und in der Workflow-Konfiguration konsistent verwendet werden kann.
2.4. Beispiel eines Workflows
Ein typischer Ablauf innerhalb des Workflows umfasst folgende Schritte:
- Übergabe eines PDF-Jobs an Switch über den $PRODUCT_NAME_PDF_EDITOR
- Verarbeitung des Jobs in Switch – beispielsweise Preflight oder Korrekturen
- Weiterleitung an einen Checkpoint
- Öffnen des Jobs im $PRODUCT_NAME_PDF_EDITOR
- Sperren des Jobs während der Bearbeitung
- Bearbeitung des PDFs und optionales Prüfen des Reports
- Rückgabe des Jobs an Switch
- Fortsetzung der Verarbeitung im Workflow
Switch Flow zum Download
Wie eine funktionierende Anbindung mit dem PDF-Editor und Enfocus Switch in der Praxis aussehen könnte, können Sie aus diesem Switch Flow entnehmen.
Artikel Update: $PRODUCT_NAME_PDF_EDITOR 1.14 – 03/2026