Erfahren Sie in diesem Artikel,
- welche Möglichkeiten zur Anbindung an einen Enfocus Switch Flow über den PDF Editor geboten werden 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ückführung von PDF-Aufträgen innerhalb eines Switch Flows. Über den PDF Editor werden ausschließlich PDF-Dateien zur Verarbeitung unterstützt.
2. Verbindung zu Enfocus Switch
Die Integration stellt eine durchgängige Verarbeitung von PDF-Aufträgen innerhalb des Workflows in der Druckvorstufe sicher und umfasst folgende Funktionen:
- Übermittlung von PDF-Aufträgen an den gewählten Switch Flow
- Öffnen und Bearbeiten von PDF-Aufträgen direkt aus dem Switch Flow heraus
- Rückführen (Check-in) von bearbeiteten PDF-Aufträgen in den Switch Flow
- Vollständige Unterstützung von Metadaten, die in Switch Flows für weitere Bearbeitungsschritte herangezogen werden können (Lesen und Schreiben)
- Anzeige von Fehlern, Warnungen oder Informationen, die beim Prüfen von PDF-Dateien gefunden wurden, direkt im PDF Editor
Durch diese Funktionen kann der PDF Editor sowohl für manuelle Eingriffe als auch für kontrollierte Korrekturschritte innerhalb Ihrer Prozesse in der Druckvorstufe eingesetzt werden.
2.1. Einstiegspunkte in den Workflow
Zur Verbindung des PDF Editors mit einem Switch Flow stehen zwei zentrale Einstiegspunkte zur Verfügung, über die der Datenaustausch erfolgt:
Übergabepunkte
Ein Übergabepunkt in einem Switch Flow dient zur Übergabe von PDF-Dateien im PDF Editor an den gewählten Switch Flow. Dabei werden zwei Modi unterstützt:
- Nur PDF-Auftrag – es wird ausschließlich die PDF-Datei übergeben.
- PDF-Auftrag und Metadaten – zusätzlich zur PDF-Datei werden auch Metadaten übertragen.
In beiden Fällen erfolgt die Übergabe dateibasiert. Werden Metadaten mitgegeben, stehen diese für die weitere Verarbeitung in Switch Flows zur Verfügung.
Kontrollpunkte
Ein Kontrollpunkt ermöglicht den gezielten Zugriff auf PDF-Aufträge 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 Kontrollpunkt (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. Anzeige von Fehlern, Warnungen und Informationen
Der $PRODUCT_NAME_PDF_EDITOR unterstützt die Anzeige von Fehlern, Warnungen oder Informationen, sofern ein spezieller Zusatz am PDF-Auftrag vorhanden ist. Voraussetzung hierfür ist ein JSON-Dataset mit dem Namen pdfEditorReportFull, welches der Spezifikation des $PRODUCT_NAME_PDF_EDITOR entspricht.
Ist ein entsprechender Zusatz vorhanden, werden die Fehler, Warnungen und Informationen automatisch im $PRODUCT_NAME_PDF_EDITOR im Dialog Prüfergebnisse (macOS: Cmd + Shift + P | Windows: Strg + Shift + P ) angezeigt. Damit können Korrekturen direkt im PDF Editor entsprechend den Hinweisen nacheinander abgearbeitet werden.
Da Prüfberichte in callas pdfToolbox standardmäßig im XML-Format erzeugt werden, ist für die Anzeige im $PRODUCT_NAME_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 muss, um auf diese Möglichkeit der Visualisierung zurückzugreifen.
XSL-Datei
Die XSL-Datei, die im pdfToolbox Switch-Konfigurator eingesetzt werden muss, steht hier zu Download bereit.
Verwendung von Prüfberichten von Enfocus PitStop Server
Die Verwendung der Prüfberichte aus Enfocus PitStop Server kann durch Schreiben einer Transformation zu dem beschriebenen XSL einfach durch Integratoren umgesetzt werden.
Zur Einrichtung der Anzeige von Fehlern, Warnungen und Informationen sind folgende Schritte erforderlich:
- Verarbeitung eines PDF-Dokuments in Switch mittels callas pdfToolbox
- Erstellung eines Prüfberichts im XML-Format
- Anwendung der bereitgestellten XSL-Transformation im pdfToolbox Switch-Konfigurator
- Anhängen des erzeugten JSON-Datasets mit dem Namen
pdfEditorReportFullan den PDF-Auftrag - Öffnen des PDF-Auftrags im PDF Editor zur Anzeige des Reports
2.3. Ablage der XSL-Datei
Für die Verwendung der bereitgestellten XSL-Zusatzes 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 callas 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 Konfiguration des Switch-Konfigurators konsistent verwendet werden kann.
2.4. Beispiel eines Workflows
Ein typischer Ablauf innerhalb eines Druckvorstufen-Workflows umfasst folgende Schritte:
- Übergabe eines PDF-Auftrags an den gewählten Switch Flow über den $PRODUCT_NAME_PDF_EDITOR
- Verarbeitung des PDF-Auftrags im Switch Flow – beispielsweise Prüfen oder Korrekturen
- Weiterleitung an einen Kontrollpunkt
- Öffnen des PDF-Auftrags im $PRODUCT_NAME_PDF_EDITOR
- Sperren des Jobs während der Bearbeitung, um andere Personen in der Druckvorstufe den Zugriff auf die Datei zu unterbinden
- Bearbeitung des PDFs durch optionales Durchgehen der gefundenen Fehler und Warnungen
- Rückgabe des PDF-Auftrags an den Switch Flow
- Fortsetzung der Verarbeitung im Switch Flow
Switch Flow zum Download
Wie eine funktionierende Anbindung mit dem PDF Editor und Enfocus Switch in der Praxis aussehen könnte, können Sie diesem Switch Flow entnehmen.
Artikel Update: $PRODUCT_NAME_PDF_EDITOR 1.14 – 03/2026