ValidatePdfE - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Prüft das aktuell geöffnete PDF auf PDF/E-1-Konformitätsmarker und liefert ein strukturiertes Ergebnis mit der erkannten Konformitätsstufe sowie der Menge der gefundenen konkreten Probleme

Syntax

function ValidatePdfE: TPdfEValidationResult;

Beschreibung

ValidatePdfE durchläuft das geöffnete Dokument und sucht nach den in ISO 24517-1:2008 definierten PDF/E-1-Dateiformat-Markern:

Einen XMP-Metadaten-Stream, der pdfe:ISO_PDFEVersion enthält (§5 + §13.3)
Die passende pdfaExtension:schemas-Beschreibung für den pdfe-Namespace (Anforderung an Erweiterungsschemas der XMP Specification 2004, geerbt über §13.1)
Einen Document Information Dictionary-Eintrag /ISO_PDFEVersion mit einem Literal-String-Wert (§5 SHALL)
Gleichheit zwischen dem Info-Dictionary-Wert und dem XMP-Wert (§6.5 / §13.1)
Ein Trailer-/ID-Array (§6.2)
xmp:CreateDate- und xmp:ModifyDate-Einträge in XMP (geerbt von ISO 19005-1 §6.7 über §13.1)

Das Ergebnis ist ein TPdfEValidationResult-Record:

Conformance — die erkannte Stufe: pec1 (PDF/E-1-Identifikator gefunden und nicht leer), pecNone (kein PDF/E-Marker) oder pecUnknown (Parsen fehlgeschlagen oder Marker vorhanden, aber Wert fehlt)
Issues — eine TPdfEValidationIssues-Menge, die keinen oder mehrere der Werte enthält: pveiMissingXmpMetadata, pveiMissingPdfEIdentifier, pveiMissingExtensionSchema, pveiMissingInfoVersionEntry, pveiInfoVersionMismatch, pveiMissingTrailerId, pveiMissingXmpDates
IsCompliant — liefert True, wenn Conformance eine echte PDF/E-Stufe ist und Issues leer ist

ValidatePdfE ist eine rein lesende Prüfung — sie verändert das Dokument nicht und kann gefahrlos wiederholt aufgerufen werden. Setzen Sie sie ein, bevor eine PDF/E-Nutzlast in ein technisches Archiv eingespeist wird, um die Dateiformat-Level-Nonkonformitäten offenzulegen, die diese Bibliothek erkennen kann. Für die häufige Prüfung „Ist das PDF/E-1?“, die keine Problemliste benötigt, ziehen Sie die schlankere Eigenschaft PdfEConformance vor

Hinweise

Bei Dokumenten mit gültiger XRef-Kette löst die Validierung aktive Dictionarys auf und dekodiert Metadaten über begrenzte Sparse-Lesevorgänge, statt die komplette Quelle in den Speicher zu kopieren; nicht unterstützte Strukturen behalten den kompatiblen Validierungspfad
ValidatePdfE ist eine Prüfung auf Dateiformat-Ebene — sie erzwingt keine PDF/E-Regeln auf Inhaltsebene (vollständige Schriftart-Einbettung, ToUnicode-CMaps, verbotene Reference-XObjects / PostScript-XObjects / TR / TR2 != Default / XFA-Formulare / JavaScript-Aktionen usw.). Für eine vollwertige Validierung kombinieren Sie diese Methode mit einem externen Werkzeug wie callas pdfaPilot oder axesPDF
Der Validator meldet pveiInfoVersionMismatch nur, wenn sowohl Info /ISO_PDFEVersion als auch XMP pdfe:ISO_PDFEVersion vorhanden sind und auseinanderlaufen. Fehlt der Info-Eintrag, meldet der Validator ausschließlich pveiMissingInfoVersionEntry (keine falsche Diskrepanz)
Der Aufruf von ValidatePdfE bei einem inaktiven Dokument liefert einen Record mit Conformance = pecUnknown und einer leeren Issues-Menge
PDF/E-1 erlaubt Verschlüsselung (§6.3), sofern die Trailer-/ID-Strings direkte Objekte bleiben. Der Validator kennzeichnet Verschlüsselung daher NICHT als Nonkonformität

Beispiel

uses System.TypInfo;

var
  Outcome: TPdfEValidationResult;
  Issue: TPdfEValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\drawing.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfE;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfEConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfEValidationIssue), Ord(Issue)));
end;

Siehe auch

PdfEConformance, SaveAsPdfE, SaveAsPdfEToStream, ValidatePdfA, ValidatePdfUa