CheckFileComplianceA

Konformität, Dokumentprüfung

Beschreibung

Das abschließende A kennzeichnet den ANSI-DLL-Einstiegspunkt (char); die ActiveX/COM-Oberfläche stellt nur die Unicode-Form bereit. Das Verhalten ist identisch mit CheckFileCompliance, und Zeichenfolgenargumente werden mit der aktuellen Codepage von SetAnsiMode interpretiert

Liest eine externe PDF-Datei und validiert sie anhand eines ausgewählten ISO-Konformitätsstandards. Der zurückgegebene Wert ist entweder null, wenn die Datei die gewählte Prüfung ohne Beanstandung besteht, oder ein von null verschiedenes Handle StringListID, das jedes erkannte Problem aufführt. Jeder Listeneintrag besteht aus einem kurzen Code, einem Doppelpunkt und einer lesbaren Meldung — exakt dasselbe Codeformat, das GetPDFUADiagnostics verwendet. Enumerieren Sie das Ergebnis mit GetStringListCount und GetStringListItem

Der 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 den anzuwendenden Regelsatz zu bestimmen

Der PDF/UA-1-Test (hinzugefügt in v3.56.0) prüft ein externes PDF gegen ISO 14289-1 und gibt Diagnosecodes im Bereich 10xxx aus, damit sie sich visuell von den PDF/A-Codes 00xxx unterscheiden.

Syntax

Delphi

Function DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * 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 schnelle Selbstprüfung vor der Auslieferung gedacht. Er erkennt Probleme auf Dokumentebene, die eine Datei unmittelbar disqualifizieren (falsche PDF-Version, fehlender OutputIntent, fehlender Strukturbaum auf A-Ebene, Verschlüsselung, Ebenen in PDF/A-1). Er durchläuft nicht jeden Inhaltsstromoperator und prüft auch nicht für jedes gezeichnete Objekt die Einbettung von Schriften oder Farbraumreferenzen — diese Prüfungen erfordern einen speziellen PDF/A-Validator wie veraPDF. Verwenden Sie diese Funktion als erste Prüfung und als Regressionstor in Build-Pipelines. Verwenden Sie CreatePreflightReport oder SavePreflightReport, wenn die Bibliothek die Problemlisten als wiederverwendbaren Textbericht formatieren soll. Verwenden Sie CreatePreflightReportEx oder SavePreflightReportEx für Berichtsausgaben als Text, JSON, HTML oder CSV, oder lesen Sie unter Preflight-Berichte den vollständigen Berichtsablauf nach

Die zugehörige API GetPDFUADiagnostics führt entsprechende Prüfungen für PDF/UA-1 (ISO 14289-1) am aktuell im Speicher erstellten Dokument statt an einer externen Datei durch

Rufen Sie beim Erzeugen einer PDF/A-Ausgabe mit dieser Bibliothek SetPDFAMode auf, bevor Sie Inhalte hinzufügen. Die erzeugungsseitige Schutzprüfung in SetPDFAMode blockiert die vom ausgewählten Teil verbotenen Vorgänge, sodass ein auf diese Weise erstelltes 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