PDF to PDF/A Konverter mit Ordnerüberwachung, Commandline und SOAP/REST Web-Service.

Allgemein

Als Basis für unsere bestehenden als auch für zukünftige Anwendungen haben wir die Funktionen zum Konvertieren von PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format in einer eigenen .NET Komponente zusammengefasst.

PDF2PDFA Funktionen:

  • Konvertiert PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format
  • Eigenständige C# / .NET Komponente
  • Für Multithreading / Parallele Verarbeitung geeignet
  • Status-Rückmeldung - sowie, falls keine direkte Konvertierung / Korrektur möglich ist, die Ursache
  • PDF/A Image Konvertierung - Bei Konvertier Problemen, welche nicht direkt in der PDF Datenstruktur behebbar sind, können optional die betroffenen Seiten durch Umwandlung in ein Image PDF/A mit unterlegtem Suchtext verarbeitet werden.
  • Verwaltung der Einstellungen über Profile (XML Dateien) - Profilfunktionen: Neu, Kopieren, Umbenennen, Löschen, Import, Export Einzeln, Export Alle
  • Einbetten von externen Dateien als PDF Anhänge (PDF/A-3b und ZUGFeRD)
  • Konfigurierbares Userinterface - Bestimmte Optionen lassen sich ein- und ausblenden - Profile, Info, Drop Zone, Ergebnis-Ausgabe
  • Verarbeitet ZIP Dateien - Zusätzliche Datei-Anhänge können direkt in das PDF eingebettet werden

Produkt Übersicht

PDF2PDFA-FM

PDF2PDFA-FM wird als MS-Windows Dienst installiert, kann mehrere Ordner überwachen, basiert auf unserer PDF/A Konverter Komponente und dient dazu PDF automatisiert in das PDF/A-1b, 2b, 3b bzw. ZUGFeRD Format zu konvertieren.

Funktionen:

  • Konvertiert PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format
  • MS-Windows Dienst
  • Mehrere Jobs können angelegt werden um mehrere Eingangsordner zu überwachen
  • Multithreading / Parallele Verarbeitung
  • Logging aller Events, sowie der Ursache falls keine direkte PDF/A Konvertierung nicht möglich ist
  • PDF/A Image Konvertierung - falls eine direkte PDF/A Konvertierung nicht möglich ist
  • Zuordnung der PDF/A Konverter Parameter über Profile
  • Einbetten von externen Dateien als PDF Anhänge (PDF/A-3b und ZUGFeRD)
  • Verarbeiten von ZIP Containern - mehrere PDF Dateien auf einmal verarbeiten, um einzubettende Anhänge sowie ZUGFeRD XML mitzugeben
  • Nur der Start Ordner oder auch die ganze Unterordnerstruktur können abgearbeitet werden
  • Ordnerinhalte können nach der Verarbeitung gelöscht oder die Ordnerstruktur kann erhalten bleiben
  • Ordnerstruktur aus dem Eingangs-Ordner kann auch in den Zielordner übernommen werden
  • Dateiverarbeitung über Filter - Name, Erweiterung, Erstellt von/bis, Geändert von/bis
  • Sortierte Abarbeitung nach Name/Datum sowie auf-/absteigend möglich
  • Erzeugung eines neuen Dateinamens über Variablen (Datum, Zeit, Zähler, Ursprungs-Name/Erweiterung)
  • Löschen der Ursprungs-Datei (Verschieben), Kopieren bzw. Erzeugen einer Archivkopie
  • Ordner-Überwachung und Verarbeitungsstart über Datei-System Events - sofort bzw. mit einer einstellbaren Verzögerung (0-999sek.) bzw. über einen Zeit-Intervall (in min.)
  • Start der Verarbeitung zu einem eingestellten Datum/Uhrzeit mit optional täglicher/wöchentlicher Wiederholung
  • Einstellbare Anzahl an Wiederholungs-Versuchen / Zeit-Intervall falls eine Datei blockiert sein sollte

PDF2PDFA-CL

PDF2PDFA-CL ist eine Kommandozeile Anwendung, basierend auf unserer PDF/A Konverter Komponente und dient dazu PDF in das PDF/A-1b, 2b, 3b bzw. ZUGFeRD Format zu konvertieren.

Funktionen:

  • Konvertiert PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format
  • Kommandozeilen Anwendung
  • Verarbeitet - Einzeldateien (PDF, ZIP), Listen aus TXT Dateien, Ordner sowie ganze Ordnerstrukturen
  • Nur ein angegebener Ordner oder auch ganze Ordnerstrukturen können abgearbeitet werden
  • Konfiguration über Benutzerinterface
  • Logging aller Events sowie der Ursache, falls eine direkte PDF/A Konvertierung nicht möglich ist
  • Zuordnung der PDF/A Konverter Parameter über Profile
  • Einbetten von externen Dateien als PDF Anhänge (PDF/A-3b und ZUGFeRD)
  • Verarbeitet ZIP Container - um mehrere PDF Dateien auf einmal zu konvertieren bzw. um einzubettende Anhänge sowie ZUGFeRD XML mitzugeben

PDF2PDFA-CS

Der als MS-Windows Dienst installierte PDF2PDFA-CS Konverter Service konvertiert bestehende PDF Dateien über die REST bzw. SOAP Web-Service Schnittstelle in das für die Langzeitarchivierung normierte PDF/A-1b, 2b, 3b sowie ZUGFeRD Format. Die Verarbeitung basiert auf unserer .NET PDF2PDFA Konverter Komponente.

Funktionen:

  • Konvertiert PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format
  • MS-Windows Dienst
  • Multithreading / Parallele Verarbeitung
  • Logging aller Events, sowie der Ursache, falls eine direkte PDF/A Konvertierung nicht möglich ist
  • PDF/A Image Konvertierung - falls eine direkte PDF/A Konvertierung nicht möglich ist
  • Zuordnung der PDF/A Konverter Parameter über Verarbeitungs-Profile
  • Einbetten von externen Dateien als PDF Anhänge (PDF/A-3b, ZUGFeRD) über ZIP Eingangsdatei
  • Verarbeitet ZIP Container um einzubettende Anhänge sowie ZUGFeRD XML übergeben zu können
  • Kommunikation per HTTP/HTTPS - Web-Service Schnittstelle über REST oder SOAP
  • Web-Service Schnittstelle kompatibel zum FileConverterPro
  • .NET C# Beispiel und Test-Clients für REST und SOAP inkl. VisualStudio Projekte im Source Code enthalten
  • Client Anwendung für Hotfolder sowie Kommandozeilen Verarbeitung als kostenlose Erweiterung für den PDF2PDFA-CS Server verfügbar

Weitere Anwendungen für PDF2PDFA

PDF2PDFA-CS-FM

Hotfolder / Ordner Überwachung für den PDF2PDFA-CS Konverter Dienst.

PDF2PDFA-CS-FM ist eine für den PDF2PDFA-CS Konverter Dienst kostenlos verfügbare Zusatz Anwendung, um einen oder mehrere Eingangs-Ordner zu überwachen und alle vorhandenen oder neu hinzukommenden Dateien (PDF, ZIP) nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format zu konvertieren und in dem festgelegten Ausgangs-Ordner abzulegen.

Die Funktionen entsprechen voll und ganz der PDF2PDFA-FM Anwendung, jedoch erfolgt die Verarbeitung nicht "Lokal", sondern "Remote" mittels HTTPS über die SOAP Web-Service Schnittstelle.

PDF2PDFA-CS-CL

Kommandozeilen Anwendung für den PDF2PDFA-CS Konverter Dienst.

PDF2PDFA-CS-CL ist eine für den PDF2PDFA-CS Konverter Dienst kostenlos verfügbare Zusatz Anwendung, um PDF nach PDF/A-1b, 2b, 3b sowie in das ZUGFeRD Format zu konvertieren. Die Funktionen entsprechen voll und ganz der PDF2PDFA-CL Anwendung, jedoch erfolgt die Verarbeitung nicht "Lokal", sondern "Remote" mittels HTTPS über die SOAP Web-Service Schnittstelle auf einem PDF2PDFA-CS Server.

Installation / Update

Installation

  • Download des Installations-ZIP-Paketes von pdfa.at
  • Im Download Ordner Doppelklick auf die ZIP Datei
  • Ausführen der Setup.exe mit Administratorrechten
  • Folgen Sie den Anweisungen am Bildschirm

Die Setups und EXE Dateien sind signiert - Verisign Class 3 - Code Sign Zertifikat.

Lizenz aktivieren

Unsere Produkte werden als Demo Version am Arbeitsplatz installiert und können 30 Tage lang mit allen Funktionen getestet werden. Nach den 30 Tagen wird ein Demo Stempel auf den erzeugten Dokumenten aufgebracht. Ein Terminal Server wird automatisch erkannt und die Demo Version aktiviert sich bis 25 User/Session für 30 Tage.

Beim Setup wird zusätzlich ein Lizenz-Manager installiert über den Lizenzen aktiviert und freigegeben werden können. Zu finden ist der Lizenz-Manager über den "Aktivieren"-Button im Info-Bereich vom Benutzer Interface oder unter dem Pfad "C:\Program Files\<Produktname>\LicMan.exe".

Mehr Informationen zum Lizenz-Manager finden Sie HIER >>>

Update

Bei einem Update auf eine neue Version sind folgende Schritte zu beachten:

  • Dienst stoppen / Anwendung beenden
  • Deinstallation der alten Version
  • Neue Version installieren
  • Benutzer Account für den Dienst neu konfigurieren (bleibt nicht erhalten)
  • Dienst starten

Die Einstellungen, Konvertier Profile und die Lizenz bleiben trotz Deinstallation erhalten.

Konfiguration

PDF2PDFA Komponente - Konfiguration

Die PDF2PDFA Komponente ist in allen PDF2PDFA Produkten ident. Das Konfigurations-Interface für die PDF2PDFA Komponente kann über die Profile aufgerufen werden.

PDF2PDFA Konvertier Profile

Die Konvertier Einstellungen werden über Profile (XML Dateien) verwaltet. Profil Aktionen - Aktualisieren, Neu, Kopieren, Name ändern, Löschen, Export, Import, Alle Exportieren.

Die Profile werden als XML Dateien unter "C:\ProgramData\PDF2PDFA" gespeichert.

PDF/A Stufe

Diese Einstellung legt fest in welches PDF/A Format das Dokument konvertiert werden soll. Folgende PDF/A Stufen stehen zur Auswahl:

  • PDF/A-1b, 2b, 3b
  • ZUGFeRD
  • PDF/A-1a, 2a, 3a

PDF/A-1a, 2a, 3a:

Ab der Version 1.1.0 können PDF Dateien auch nach PDF/A-1a, 2a und 3a konvertiert werden. Dabei ist jedoch zu beachten, dass nicht jede beliebige PDF Datei konvertiert werden kann und, dass eine automatische Konvertierung nur dann möglich ist bzw. auch nur dann sinnvoll ist, falls die Eingangsdatei bereits die erforderliche Strukturinformation / Tags enthält. Z.B. kann aus MS-Word heraus eine PDF über die "Speichern unter / PDF" Funktion erstellt werden, welche bereits diese erforderliche Zusatzstruktur enthält.

Parallele Verarbeitung

Es gibt die Option die maximale Anzahl an parallelen Konverter Prozessen festzulegen. Damit lässt sich die Ressourcen Nutzung limitieren. Ein Wert = 0 bedeutet, dass alle verfügbaren Ressourcen voll ausgenutzt werden. Die beste Performance wird erreicht wenn der Wert dem der verfügbaren CPU Hyperthreads entspricht. Wird der Parameter zu hoch eingestellt so gehen Ressourcen durch das dadurch erforderliche Rotieren der Threads verloren.

Konvertier Fehler - in Bild umwandeln

Bei Konvertier Problemen, welche nicht direkt in der PDF Datenstruktur behebbar sind, können optional die betroffenen Seiten durch Umwandlung in ein Image-PDF/A mit unterlegtem Suchtext verarbeitet werden.

Datei Anhänge

Bei PDF/A-3b und damit auch für ZUGFeRD Dokumente ist es möglich zusätzliche Datei Anhänge direkt in das PDF einzubetten und damit die PDF Datei wie einen Daten-Container für die Weitergabe oder Archivierung der Anhänge zu nutzen.

ZUGFeRD Standard

Die für die Konvertierung benötigte ZUGFeRD XML Datei muss bereits vorhanden sein! Sie wird nicht durch den PDF2PDFA Konvertier Vorgang erstellt.

Folgende ZUGFeRD Standards und Profile stehen zur Auswahl:

  • ZUGFeRD 1.0 - BASIC, COMFORT, EXTENDED
  • ZUGFeRD 2.0 - MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED
  • Factur-X - MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED

ZUGFeRD 2.0 Profile:

Bei ZUGFeRD 2.0 sowie Factur-X sind mehrere Profile vorgesehen. Das Profil "EN 16931" löst das ZUGFeRD 1.0 Profil "COMFORT" ab und entspricht vollständig der EU-Norm, die jedoch nur die Kernelemente einer Rechnung festlegt. Mit dem Profil "EXTENDED" können in einer elektronischen Rechnung zusätzliche Angaben erfasst werden, etwa nach Branche oder nach gesetzlichen Vorgaben. Darüber hinaus wurden mit "BASIC" und "BASIC WL" zwei weitere Profile für kleinere Lieferanten festgelegt.

ZUGFeRD eignet sich für Organisationen aller Größen und erhält dank der EN 16931 Konformität eine erweiterte internationale Bedeutung. Das Profil "EN 16931" wird von allen europäischen Verwaltungen anerkannt. Seit November 2018 sind E-Rechnungen im Business to Government (B2G) Verkehr in der EU vorgeschrieben.

Verarbeitung von ZIP Dateien

PDF2PDFA kann neben PDF auch ZIP Dateien verarbeiten. Damit ergeben sich zusätzliche Möglichkeiten:

  • Es können in einer ZIP Datei mehrere PDF Dateien zur Konvertierung nach PDF/A-1b, 2b, 3b sowie ZUGFeRD übergeben werden.
  • Die im ZIP enthaltene Ordnerstruktur kann auch für die Ausgabe verwendet werden. Damit wird im Zielordner die gleiche Datenstruktur erzeugt wie im ZIP vorhanden.
  • Anhänge können über die ZIP Datei zum Einbetten in die PDF/A-3b bzw. ZUGFeRD Datei mitgegeben werden. Dazu muss in der gleichen Ordnerebene in der sich die PDF Datei befindet ein Unterordner mit dem gleichen Namen wie das PDF + "$" davor und dahinter vorhanden sein. Z.B. für die Datei "Test.pdf" ein Unterordner mit dem Namen "$Test$". Ist ein solcher Ordner vorhanden, so werden alle darin enthaltenen Dateien als Anhänge in die Ausgabedatei eingefügt.
  • Falls in einem $...$ Ordner eine ZUGFeRD XML Datei mit dem Namen "ZUGFeRD-invoice.xml" vorhanden ist, so kann damit auch ein ZUGFeRD konformes PDF erzeugt werden. Befindet sich in einem Ordner nur ein einziges PDF so muss für die ZUGFeRD XML nicht unbedingt ein $...$ Unterordner angelegt werden - in dem Fall reicht es aus die "ZUGFeRD-invoice.xml" in der gleichen Ordnerebene abzulegen. Ein $...$ Unterordner wäre nur erforderlich falls sich auf der gleichen Ebene mehrere PDF befinden oder falls neben dem XML zusätzliche Anhänge mitgegeben werden sollen.

PDF2PDFA-FM - Konfiguration

MS-Windows Dienst mit Ordnerüberwachung - konvertiert PDF nach PDF/A-1b, 2b, 3b sowie ZUGFeRD.

Allgemeine Einstellungen

Windows Service Konfiguration:

Der Benutzer unter dem der Dienst läuft lässt sich konfigurieren. Der für einen Windows Service standardmäßig verwendete lokale System Account hat keinen Zugriff auf Netzwerk Ressourcen (z.B.: Netzwerklaufwerke, Netzwerkdrucker). Sollten Netzwerk Ressourcen verwendet werden, so muss ein Benutzer Account angelegt und konfiguriert werden, der Zugriff auf die verwendeten Ressourcen hat.

Sprache:

Die Sprache ist per Default an die Betriebssystem Sprache angepasst, kann aber in den Allgemeinen Einstellungen zwischen Deutsch und Englisch umgeschaltet werden. Bei einer Änderung der Sprache muss die Anwendung beendet und neugestartet werden.

Log:

Die Log Funktion von PDF2PDFA-FM ist standardmäßig deaktiviert und kann in den Allgemeinen Einstellungen aktiviert werden. Dabei lässt sich einstellen welche Informationen im Log ausgegeben werden sollen - Alles, Fehler, Events. Der Default Pfad unter dem die Logs erstellt werden ist "C:\ProgramData\PDF2PDFA\PDF2PDFA-FM". Sowohl der Pfad als auch der Name der Log-Datei können konfiguriert werden.

Job Konfiguration

Mehrere Jobs können angelegt werden um mehrere Eingangsordner zu überwachen und eigehende Dokumente zu verarbeiten.

Ordner konfigurieren

Folgende Ordner können pro Job konfiguriert werden:

  • Eingangs-Ordner:
    Dieser Ordner wird überwacht und enthaltene bzw. neu hinzukommende Dateien werden nach PDF/A konvertiert.
  • Ausgabe-Ordner:
    Im Ausgabe Ordner werden die erfolgreich konvertierten Dateien nach der Verarbeitung abgelegt.
  • Fehler Ordner:
    Dateien die nicht konvertiert werden können, landen im Fehler Ordner.
  • Archiv Ordner:
    Falls die Option "Archivkopie erstellen" aktiv ist wird die Original-Datei nach der Verarbeitung nicht gelöscht, sondern in den Archiv Ordner verschoben (kopiert).

Wenn Netzwerk-Ordner verwendet werden, muss der Dienst unter einem Benutzer Account laufen, da der lokale System Account keinen Zugriff darauf hat. Außerdem sollte für die Ordner Überwachung die Variante "Blockweise Verarbeitung" gewählt werden.

Ordner Überwachung

Zeitgesteuert:

Die Ordner können in einem einstellbaren Intervall gescannt werden oder zu einem bestimmten Datum/Uhrzeit. Ein fix eingestelltes Datum/Uhrzeit kann täglich oder wöchentlich wiederholt werden.

Datei System Events:

Dabei wird eine Betriebssystem Funktion genutzt um Änderungen an Dateien sowie neue Dateien in einem Ordner/Ordnerstruktur zu erkennen und um die Verarbeitung unmittelbar zu starten. Diese Option sollte nur für lokale Ordner/Ordnerstrukturen, nicht jedoch für die Verarbeitung von Netzwerkfreigaben verwendet werden.

Blockweise Verarbeitung:

Dabei wird der Ordner "blockweise" eingelesen, d.h. es werden immer Blöcke in der eingestellten maximalen Anzahl von Dateien eingelesen und verarbeitet. Nach der Verarbeitung eines Blocks startet der nächste Block usw. bis alle Dateien abgearbeitet sind. Falls keine weiteren Dateien gefunden werden, so wird der Ordner danach alle 10msek. nach neuen Dateien abgefragt. Die "Blockweise Verarbeitung" sollte für die Ordnerüberwachung von Netzwerklaufwerken verwendet werden.

"*.rd" Trigger verwenden:

Es gibt auch die Möglichkeit den Start der Verarbeitung nicht nur über die zu verarbeitenden PDF Dateien selbst, sondern über eine "*.rd" Datei zu triggern. Wird eine Datei mit der Endung "*.rd" in einen überwachten Ordner kopiert bzw. ist eine solche zu einem bestimmten Zeitpunkt vorhanden, so werden alle zu diesem Event im Ordner vorhandenen PDF Dateien verarbeitet. Damit ist es möglich den Zeitpunkt zu dem die Konvertierung der PDF Dateien starten soll genau festzulegen und extern zu triggern.

Verzögerter Start:

Der Start der Verarbeitung in einer neu erkannten Datei erfolgt normalerweise sofort, jedoch kann es auch Gründe geben um die Verarbeitung verzögert zu starten. Für jeden überwachten Ordner gibt es eine Einstellung um den Start der Verarbeitung um x Sekunden zu verzögern. Dabei wird zuerst die eingestellte Zeit in Sekunden abgewartet und erst dann wird die Verarbeitung gestartet.

PDF2PDFA-CL - Konfiguration

PDF2PDFA-CL ist eine Kommandozeilen Anwendung basierend auf unserer PDF/A Konverter Komponente und dient dazu PDF in das PDF/A-1b, 2b, 3b bzw. ZUGFeRD Format zu konvertieren.

Die PDF/A Konverter Konfiguration wird über das startbare Benutzerinterface durchgeführt. Es können verschiedene Konvertier Profile angelegt werden, die beim Kommandozeilen Aufruf ausgewählt werden können.

Kommandozeilen Parameter

ParameterBeschreibung
/src=["]<Ursprungs-Datei>["]

Pfad zur Ursprungs-Datei (oder Verzeichnis).
Es können PDF bzw. ZIP Dateien verarbeitet werden, bzw. können auch TXT Dateien verwendet werden um mehrere Dateien oder Ordner auf einmal zu verarbeiten. Die TXT Datei enthält den Pfad zu den Dateien bzw. Ordnern die verarbeitet werden sollen. Falls in einer Zeile, getrennt mit ";", ein weiterer Pfad zu einer Datei/Ordner angegeben ist, so wird dieser als Ziel Pfad für die konvertierte Datei angenommen. Für diesen 2ten Pfad kann auch nur ein Ordner angegeben werden, dann wird als Ziel-Dateiname der Ursprungs-Dateiname angenommen. In der Kommandozeile kann auch nur der Dateiname ohne Erweiterung benutzt werden. Standardmäßig wird der aktuelle Pfad von dem aus die Anwendung gestartet wurde sowie als Standard-Erweiterung "*.pdf" angenommen.

/zfxml=["]<ZUGFeRD XML>["]Pfad zur XML Datei um eine ZUGFeRD konforme PDF Datei für elektronische Rechnungslegung zu erzeugen. Der Parameter kann nur zusammen mit einem ZUGFeRD PDF/A Konvertier Profil verwendet werden. Eine im ZUGFeRD Konvertier Profil vorgegebene XML Datei wird dadurch überschrieben. Um für das XML den gleichen Namen wie für die PDF Datei zu verwenden kann der Schlüsselname "pdfname" verwendet werden - z.B.: /zfxml=["]pdfname["]. Die XML muss im gleichen Ordner wie die PDF Datei vorhanden sein.
/dst=["]<Ziel Datei>["]Pfad zur Ziel-Datei (oder Verzeichnis).
  
  
  
  
  
  
  
  

 

Tags:
Erstellt von Gregor Herdy am 05/12/19, 16:49
XKey Wiki 2019