CreatePreflightReport

Konformität, Dokumentprüfung

Auswahl des PDF/UA-Reader-Profils

PDF/UA-Prüfungen wählen Teil 2, wenn XMP pdfuaid:part=2 ausweist, und behalten andernfalls die Prüfungen von Teil 1 bei; die hier beschriebenen älteren PDF/UA-1-Prüfungen gelten nicht automatisch für Teil 2

Das PDF/UA-2-Profil implementiert zentrale Identifikations-, Namespace-, Rollen- und Strukturprüfungen; strukturierte Berichte verwenden PDF/UA-2 und ISO 14289-2 und legen fullCertification=false und den nicht verifizierten Umfang offen

Verwenden Sie CheckFilePDFUACompliance oder RunPDFUAValidationPipelineTask, um einen Zielteil zu erzwingen, und GetPDFUAReadValidationCoverageJSON, um Fähigkeitsgrenzen zu prüfen

Beschreibung

Erstellt einen Klartext-Preflight-Bericht für eine externe PDF-Datei, indem die vorhandenen PDF/A- und PDF/UA-1-Dateikonformitätsprüfungen ausgeführt und ihre Ergebnisse zu einem wiederverwendbaren Berichtstext formatiert werden. Diese Komfort-API ist vorgesehen, wenn eine Anwendung einen lesbaren Bericht benötigt, anstatt CheckFileCompliance, GetStringListCount, GetStringListItem und ReleaseStringList manuell aufzurufen

Syntax

Delphi

Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;

Parameter

InputFileName	Vollständiger Pfad der zu validierenden PDF-Datei. Die Datei wird schreibgeschützt geöffnet und nicht geändert
Password	Zum Öffnen der Datei verwendetes Kennwort. Für unverschlüsselte Dokumente eine leere Zeichenfolge übergeben
ComplianceTests	Bitmaske zur Auswahl der einzuschließenden Prüfungen. 1 — PDF/A. 2 — PDF/UA-1. 3 — sowohl PDF/A als auch PDF/UA-1. Die Übergabe von `0` führt ebenfalls beide Prüfungen aus
Options	Bitflags, die an jede zugrunde liegende Konformitätsprüfung weitergegeben werden. 0 — Jedes in jeder ausgewählten Prüfung gefundene Problem melden. 1 — Jede ausgewählte Prüfung nach dem ersten Problem beenden

Rückgabewert

Gibt einen UTF-16-Textbericht mit dem Berichtskopf, einem Abschnitt pro ausgewählter Konformitätsprüfung und einer abschließenden Zusammenfassung mit den Zeilen Total issues und Result zurück

Anmerkungen

Wenn mehrere Standards ausgewählt sind, wird die Datei einmal analysiert, und beide Prüfungen verwenden denselben Reader, Sicherheitszustand, Dokumentobjektgraphen und verzögerten Objektcache

Die Berichts-API ersetzt keinen dedizierten externen PDF/A-Validator. Sie bündelt die integrierten grundlegenden PDF/A- und PDF/UA-1-Diagnosen der Bibliothek in einem stabilen anwendungsorientierten Bericht. Verwenden Sie CreatePreflightReportEx für Text-, JSON-, HTML- oder CSV-Ausgabe und CheckFileCompliance direkt, wenn einzelne Problemlistenhandles statt formatiertem Text benötigt werden

Der Klartextbericht ist die kanonische Quelle für jeden formatierten Bericht. Er enthält flüchtige Generated:-Metadaten, einen Input:-Pfad, die ausgewählten Prüfungen, den Modus der Problemsammlung, einen Abschnitt für jede ausgewählte Konformitätsprüfung und eine abschließende Zusammenfassung mit Total issues und Result.

Informationen zu Befehlszeilen- und Stapelberichtsabläufen finden Sie unter Preflight-Berichte.

Beispiel

var
  Report: WideString;
begin
  Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
  WriteLn(Report);
end;

Siehe auch

Preflight-Berichte, CreatePreflightReportEx, SavePreflightReport, ComparePreflightReports, CheckFileCompliance, GetPDFUADiagnostics, SetPDFAMode, SetPDFUAMode