CreatePreflightReportEx
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 Preflight-Bericht für eine externe PDF-Datei und konvertiert ihn in das angeforderte Ausgabeformat. Dies ist das formatbewusste Gegenstück zu CreatePreflightReport, das stets den Klartextbericht zurückgibt
Syntax
Delphi
Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: 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 einzubeziehenden Prüfungen: 1 für PDF/A, 2 für PDF/UA, 3 oder 0 für beide. |
| Options | Bitflags, die an jede ausgewählte Konformitätsprüfung weitergegeben werden. Übergeben Sie 1, um jede Prüfung nach ihrem ersten Problem zu beenden |
| ReportFormat | Auswahl des Ausgabeformats. 0 — Klartext. 1 — JSON-Objekt mit Headerfeldern, Abschnitten pro Prüfung, Problemlisten und Zusammenfassungsfeldern. 2 — eigenständiges HTML-Dokument mit dem maskierten Textbericht. 3 — CSV-Zeilen mit Metadaten, ausgewählten Prüfungen, Problemcodes und Meldungen sowie abschließenden Zusammenfassungszeilen. |
Rückgabewert
Gibt den erstellten Bericht im ausgewählten Format zurück. Bei unbekannten Werten für ReportFormat wird auf das Klartextformat zurückgegriffen
Anmerkungen
Die Formate JSON, HTML und CSV werden aus demselben Textbericht erzeugt, den CreatePreflightReport verwendet, sodass Bestanden-/Fehlgeschlagen-Status und Problemzahlen in allen Berichtsformaten konsistent bleiben
Das JSON-Objekt stellt Kopffelder, ein Array sections, Arrays mit Problemzeichenfolgen und ein Objekt summary bereit. Die HTML-Form ist ein eigenständiges Dokument, das den Textbericht in einem vorformatierten Block maskiert. Die CSV-Form verwendet feste Spalten kind,section,status,code,message und trennt Metadaten, Prüfstatus, Problemzeilen und Zusammenfassungszeilen für die Verarbeitung in Tabellenkalkulationen oder CI-Systemen
Den vollständigen Vertrag für Berichtsformate und Befehlszeilenbeispiele der Demo finden Sie unter Preflight Reports
Beispiel
JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);Siehe auch
Preflight-Berichte, CreatePreflightReport, SavePreflightReportEx, ComparePreflightReports, CheckFileCompliance