CheckFileCompliance

Konformität, Dokumentinspektion

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

Liest eine externe PDF-Datei und prüft sie gegen einen gewählten ISO-Konformitätsstandard. Der Rückgabewert ist entweder null (Datei besteht den gewählten Test fehlerfrei) oder ein von null verschiedenes StringListID-Handle, das jede erkannte Problematik auflistet. Jeder Eintrag der Liste besteht aus einem Kurzcode, einem Doppelpunkt und einer verständlichen Meldung — exakt dasselbe Codeformat wie bei GetPDFUADiagnostics. Zählen Sie das Ergebnis mit GetStringListCount und GetStringListItem aufDer PDF/A-Test deckt alle sechs Konformitätsmodi ab (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) und liest die XMP-Einträge

pdfaid:part/pdfaid:conformance, um zu entscheiden, welcher Regelsatz anzuwenden istDer PDF/UA-1-Test (seit v3.56.0) prüft eine externe PDF gegen ISO 14289-1 und erzeugt Diagnosecodes im Bereich

10xxx, damit sie visuell getrennt von den PDF/A-Codes 00xxx bleiben

Syntax

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

Parameter

Rückgabewerte

PDF/A-Problemcodes (ComplianceTest = 1)

PDF/UA-1-Problemcodes (ComplianceTest = 2)

Anmerkungen

Der PDF/A-Test ist als schneller Selbstcheck vor der Auslieferung gedacht. Er findet die Dokumentebenen-Problematiken, die eine Datei unmittelbar disqualifizieren (falsche PDF-Version, fehlender OutputIntent, fehlender Strukturbaum auf A-Stufe, Verschlüsselung, Ebenen in PDF/A-1). Er durchläuft nicht jeden Content-Stream-Operator und prüft weder Schrifteinbettung noch Farbraumreferenzen für jedes gezeichnete Objekt — diese Validierungen erfordern einen spezialisierten PDF/A-Validator (etwa veraPDF). Verwenden Sie diese Funktion als Erstprüfung und als Regressionstor in Build-Pipelines. Verwenden Sie CreatePreflightReport oder SavePreflightReport, wenn die Bibliothek die Problemlisten in einen wiederverwendbaren Textbericht formatieren soll. Verwenden Sie CreatePreflightReportEx oder SavePreflightReportEx für Berichtsausgabe als Text, JSON, HTML oder CSV, oder sehen Sie sich Preflight Reports für den vollständigen Berichts-Workflow anDie zugehörige API

GetPDFUADiagnostics führt analoge Prüfungen für PDF/UA (ISO 14289-1) am gerade im Speicher aufgebauten Dokument aus, nicht an einer externen DateiRufen Sie beim Erzeugen von PDF/A-Ausgabe mit dieser Bibliothek

SetPDFAMode auf, bevor Sie Inhalt hinzufügen. Die Sperre auf der Erzeugungsseite in SetPDFAMode blockiert die vom gewählten Teil verbotenen Operationen, sodass ein so erzeugtes Dokument CheckFileCompliance normalerweise automatisch besteht

Beispiel

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

Siehe auch

Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, ComparePreflightReports, SetPDFAMode, GetPDFUADiagnostics, GetStringListCount, GetStringListItem, SetPDFUAMode

Konformitätstest 3 prüft PDF/X (ISO 15930): Ausgabenidentifikation, Output Intent, Seitengeometrie, eingebettete Schriften und den verbotenen Funktionsumfang; für PDF/X-6 validiert er zusätzlich Anmerkungsflags und feste Darstellungen, AcroForm- und Signaturdarstellungen, XFA- und Viewer-generierte Darstellungsausschlüsse, Aktionsplatzierung, Aktionsketten, den zulässigen benannten Aktionsumfang und jeden UseBlackPtComp-Wert

Konformitätstest 4 prüft die PDF/VT-3-Identifikationsmetadaten, seine PDF/X-6-Familienbasis, den DPartRoot- und DPart-Graphen, DPM-Namen und -Werte, Record-Level, Seitenreihenfolge und exakte Blattabdeckung; die kombinierten Prüfungen teilen sich einen Parserdurchlauf

Konformitätstest 5 prüft die PDF/R-1-Markerplatzierung, Version und Verschlüsselung, Indirektobjekte der Generation null, eingeschränkte Wörterbücher und Filter, Ein-Stream-Seitenprogramme, geordnete Rasterstreifen, Bildcodierungen, Seitenabdeckung und effektive Auflösung; er kann eine geteilte Validierungspipeline-Parsung wiederverwenden

Konformitätstest 6 prüft das PDF/X-Fundament und die PDF/VCR-1-XMP-Identifikation, die einzelne direkte Vorlagenwurzel, deklarierte Felder, das optionale Seitenauswahlfeld und jeden Blatt-PassThrough-Ersetzungsplatzhalter, Seitenbindung, MCID und Begrenzungsboxen; er kann eine geteilte Validierungspipeline-Parsung wiederverwenden

Konformitätstest 7 prüft die PDF/E-1-Identifikation und Lebenszyklusmetadaten, Trailer-Identifikatoren, zulässige Verschlüsselung, Output Intents und Gerätfarbräume, Inhaltsoperatoren, Schriften, Anmerkungen, Formulare, optionalen Inhalt, Aktionen, externe Dateiverweise, Grafikzustände und 3D-Streambeschränkungen; er kann eine geteilte Validierungspipeline-Parsung wiederverwenden