Kapitel 9. Hilfsprogramme zur Testunterstützung

9.1. Allgemeine Hinweise für alle Hilfsprogramme

PDFUnit stellt Hilfsprogramme zur Verfügung, die Teilinformationen von PDF-Dokumenten in Dateien extrahieren, die anschließend in Tests genutzt werden können:

// Utility programs belonging to PDFUnit:

ConvertUnicodeToHex           9.12: „Unicode-Texte in Hex-Code umwandeln“ 
ExtractBookmarks              9.6: „Lesezeichen nach XML extrahieren“ 
ExtractEmbeddedFiles          9.2: „Anhänge extrahieren“ 
ExtractFieldsInfo             9.4: „Feldeigenschaften nach XML extrahieren“ 
ExtractFontsInfo              9.9: „Schrifteigenschaften nach XML extrahieren“ 
ExtractImages                 9.3: „Bilder aus PDF extrahieren“ 
ExtractJavaScript             9.5: „JavaScript extrahieren“ 
ExtractNamedDestinations      9.11: „Sprungziele nach XML extrahieren“ 
ExtractSignaturesInfo         9.10: „Signaturdaten nach XML extrahieren“ 
ExtractXFAData                9.13: „XFA-Daten nach XML extrahieren“ 
ExtractXMPData                9.14: „XMP-Daten nach XML extrahieren“ 
RenderPdfClippingAreaToImage  9.8: „PDF-Seite ausschnittweise in PNG umwandeln“ 
RenderPdfToImages             9.7: „PDF-Dokument seitenweise in PNG umwandeln“ 

Die Hilfsprogramme erzeugen Dateien, deren Namen sich aus dem der jeweiligen Eingabedatei ableiten. Damit es keine Namenskonflikte mit eventuell bestehenden Dateien gibt, gelten diese Namenskonventionen:

  • Die Namen beginnen mit einem Unterstrich.

  • Die Namen besitzen zwei Suffixe. Das vorletzte lautet .out, das letzte ist der übliche Dateityp.

Beispielsweise wird aus der Datei foo.pdf die Ausgabe _bookmarks_foo.out.xml erzeugt. Benennen Sie sie um, wenn Sie diese Datei in Ihren Tests verwenden. Schließlich ist es dann ja keine Ausgabedatei mehr.

In den folgenden Kapiteln werden Batchdateien abgebildet, die zeigen, wie die Programme gestartet werden. Die Batchdateien sind Teil des Releases, Sie müssen aber Teile der Inhalte, nämlich Classpath, Eingabedatei und Ausgabeverzeichnis an Ihre projektspezifischen Gegebenheiten anpassen.

Werden die Programme fehlerhaft gestartet, wird auf der Konsole ein Hilfetext mit der vollständigen Aufrufsyntax angezeigt.

Die Hilfsprogramme laufen auch in Shell-Skripten für Unix-Systeme. Entwickler im Unix-Umfeld sind sicherlich in der Lage, die hier gezeigten Vorlagen von Windows in Shell-Skripte zu übertragen. Falls Sie Hilfe benötigen, wenden Sie sich an support[at]pdfunit.com.