ANTRAS PDF Conversion Service

Dokumentation > Module > PDF Conversion Service

Der ANTRAS PDF Conversion Service dient zur Konvertierung ganzer PDF Dokumente oder einzelner Seiten davon in Bilder.

Dieses Modul wird von unserer Software für die Darstellung der ersten Seite von PDF Dokumenten verwendet, siehe dazu auch die entsprechende Konfiguration.

Lizenz
GNU Affero General Public License v3.0

Beinhaltet Ghostscript.NET
https://github.com/jhabjan/Ghostscript.NET

Benötigt Ghostscript® for Windows (64 bit)
https://ghostscript.com/releases/gsdnld.html

Benötigt das .NET Framework 4.8
Dies ist auf neueren Systemen in der Regel bereits installiert.

Konfiguration

Die Konfiguration wird in der Datei ANTRAS.PdfConversion.service.exe.config vorgenommen.
Folgende Einstellungen müssen vorgenommen werden:

PathToGhostscriptDll64
Vollständiger Pfad zur Datei gsdll64.dll aus dem Ghostscript Packet
InputDirecory
Der Dienst verarbeitet alle hier abgelegten PDF- und XML Dateien
OuputDirecory
Speicherort der erstellten Bilder
TempDirectory
Speicherort für temporäre Dateien
LogSuccesfulConversions
Schreibt für jede Operation einen Logeintrag (ab Version 0.6.1.14)

Auszug aus ANTRAS.PdfConversion.service.exe.config

<ANTRAS.PdfConversion.service.Properties.Settings>
  <setting name="InputDirecory" serializeAs="String">
    <value>C:\Pdf2Image\input</value>
  </setting>
  <setting name="OuputDirecory" serializeAs="String">
    <value>C:\Pdf2Image\output</value>
  </setting>
  <setting name="TempDirectory" serializeAs="String">
    <value>C:\Pdf2Image\temp</value>
  </setting>
  <setting name="PathToGhostscriptDll64" serializeAs="String">
    <value>C:\Pdf2Image\bin\gsdll64.dll</value>
  </setting>
  <setting name="LogSuccesfulConversions" serializeAs="String">
    <value>False</value>
  </setting>
</ANTRAS.PdfConversion.service.Properties.Settings>

Funktionsweise

Drag & Drop Konversion

Aus den in das unter InputDirectory konfigurierte Verzeichnis kopierten PDF Dateien wird für jede Seite ein Bild erzeugt. Die erstellten Bilder werden standardmässig mit 100 DPI erstellt. Die Dateinamen werden um die Seitenzahl und die Auflösung ergänzt.
Nach der Verarbeitung wird die PDF Datei im InputDirectory gelöscht.

Mit XML Auftragsdateien

XML Aufträge aus dem InputDirectory werden ebenfalls verarbeitet. Damit lässt sich die Konversion automatisieren und parametrieren:

PageNo 1-n 1 einzelne Seite(n) | 0=ganzes Dokument
Eine mit Kommata getrennte Liste ('1,3,8') für die Konvertierung einzelner Seiten wird ab Version 0.6.1.13 unterstützt
Dpi Auflösung 100 | 200 | ..
ImageFormat Png | Jpeg
PathToSourceDocument Vollständiger Pfad zur PDF Datei
StoreResultsInPath Pfad für die Ablage erzeugter Bilder
Optionales FileNamePattern:
{0} = PDF Dateiname ohne Extension
{1} = Seitennummer
{2} = ImageFormat, als Extension

Beispiel einer XML Auftragsdatei

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<PdfToImage PageNo="1" Dpi="100" ImageFormat="Png">
  <PathToSourceDocument><![CDATA[C:\pdftest\sourcedir\TestPdf1.pdf]]></PathToSourceDocument>
  <StoreResultsInPath><![CDATA[C:\pdftest\targetdir]]></StoreResultsInPath>
  <FileNamePattern><![CDATA[{0}_TEST_p{1}.{2}]]></FileNamePattern>
</PdfToImage>

Berechtigungen

Der Benutzerkontext, unter welchem der Dienst läuft, muss in den verwendeten Verzeichnissen über entsprechende Rechte verfügen.

Logging

Der Dienst schreibt Logeinträge nach %SystemRoot%\System32\Winevt\Logs\Application.evtx

Installation

Der Dienst wurde unter W10, W2K12, W2K19 und W2K22 getestet.

Laden sie das VisualStudio® Projekt herunter und erstellen Sie einen Release-Build.
Laden Sie Ghostscript® for Windows (64 bit) herunter und extrahieren Sie das Archiv an geeigneter Stelle. Wählen Sie dabei die für Sie passende Lizenzform https://ghostscript.com/releases/gsdnld.html.
Getestet wurden die Versionen 9.55.0 und 10.0.0
Sie können den Dienst mehrmals auf einem Server installieren. Verwenden Sie dazu eine alternative Angabe im Parameter /environment. Verwenden Sie für unterschiedliche Instanzen eigene Kopien der GhostScript DLL.

Registrierung des Windows Dienstes

InstallUtil /i /environment=Productive ANTRAS.PdfConversion.service.exe

Berechtigungen Eventlog

Das Anmeldekonto, unter welchem der Dienst ausgeführt wird, benötigt Berechtigungen für %SystemRoot%\System32\Winevt\Logs\Application.evtx.
Erteilen Sie zum Beispiel Read/Write Berechtigungen für Application.evtx allen Dienstekonten.

Fügen Sie dafür (A;;0x3;;;SU) an channelAccess hinzu.

Permissions für das Application Eventlog

// Abfragen der Informationen
wevtutil gl application

// Hinzufügen der Berechtigungen; [channelAccess] = den entsprechenden Wert aus dem vorherigende Befehl einfügen
wevtutil sl Application /ca:[channelAccess](A;;0x3;;;SU)

Ressourcen zum PDF Conversion Service

ANTRAS PDF Conversion V 0.6.1.15 (VS2022 Projekt)
Fix: Typo bei der Registrierung des Dienstes korrigiert.
ANTRAS PDF Conversion V 0.6.1.14 (VS2019 Projekt)
IMP: Logoption FIX: falscher Logeintrag betreffend Parsingfehler eliminiert FIX: Testfiles bei Servicestart werden nun entfernt
ANTRAS PDF Conversion V 0.6.1.13 (VS2019 Projekt)
Unterstützt bei XML Auftragsdateien beim Attribut PageNo per Kommata getrennte Seitennummern
ANTRAS PDF Conversion V 0.6.1.12 (VS2019 Projekt)
Ghostscript.NET auf GitHub
ghostscript.com
Laden Sie Ghostscript 9.55.0 for Windows (64 bit) herunter. Wählen Sie dabei die für Sie passende Lizenzform

Installationsservice

Gerne übernehmen wir die Installation und Konfiguration auf Ihrem System. Der Pauschalbetrag beträgt CHF 350.- exkl. MwSt. via Remote Zugang.

Wir bitten Sie, folgende Punkte vorgängig zu erledigen:

Ihr Windowssystem ist auf einem aktuellen Stand (Windows Updates)
Das .Net Framework V4.8 steht zur Verfügung und ist installiert
Ein Benutzerkonto für die Installation des Dienstes steht inkl. Passwort bereit
Sie haben Ghostscript heruntergeladen

Bitte beachten Sie, dass das verwendete Benutzerkonto auf alle verwendeten Speicherorte lesenden und schreibenden Zugriff benötigt.

Lizenzbedingungen

& Haftungsausschluss

Es besteht keine Gewährleistung für das Programm, soweit dies nach geltendem Recht zulässig ist. Sofern nicht schriftlich anders angegeben, stellen die Urheberrechtsinhaber und/oder andere Parteien das Program "wie es ist" zur Verfügung, ohne jegliche ausdrückliche oder stillschweigende Garantie, einschliesslich, aber nicht beschränkt auf die stillschweigende Garantie der Marktgängigkeit und der Eignung für einen bestimmten Zweck. Das gesamte Risiko in Bezug auf die Qualität und Leistung des Programmes liegt bei Ihnen. Sollte sich das Programme als fehlerhaft erweisen, übernehmen Sie die Kosten für alle notwendigen Wartungs-, Reparatur- oder Korrekturarbeiten.

Die Lizenzbedingungen finden Sie hier: GNU Affero General Public License v3.0