CheckFileCompliance

Zhoda, inšpekcia dokumentov

Popis

Načíta externý súbor PDF a overí ho voči zvolenému štandardu ISO pre zhodu. Vrátená hodnota je buď nula (súbor prejde zvoleným testom bez závad) alebo nenulový handle StringListID, ktorý obsahuje zoznam všetkých zistených problémov. Každá položka zoznamu je krátky kód, dvojbodka a ľudsky čitateľné hlásenie — presne rovnaký formát kódov, aký používa GetPDFUADiagnostics. Výsledok vymenujte pomocou GetStringListCount a GetStringListItemTest PDF/A pokrýva všetkých šesť režimov zhody (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) a načíta položky XMP

pdfaid:part/pdfaid:conformance, aby rozhodol, ktorú množinu pravidiel aplikujeTest PDF/UA-1 (pridaný vo v3.56.0) skontroluje externý PDF voči ISO 14289-1 a vydáva diagnostické kódy v rozsahu

10xxx, aby zostali vizuálne oddelené od kódov PDF/A 00xxx

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);

Parametre

Návratové hodnoty

Kódy problémov PDF/A (ComplianceTest = 1)

Kódy problémov PDF/UA-1 (ComplianceTest = 2)

Poznámky

Test PDF/A je určený ako rýchla vlastná kontrola pred dodaním. Zachytí problémy na úrovni dokumentu, ktoré súbor priamo diskvalifikujú (nesprávna verzia PDF, chýbajúci OutputIntent, chýbajúci strom štruktúry na úrovni A, šifrovanie, vrstvy v PDF/A-1). Neprechádza cez každý operátor obsahového toku ani neoveruje vkladanie písiem alebo odkazy na farebné priestory pre každý vykreslený objekt — také validácie vyžadujú špecializovaný validátor PDF/A (napríklad veraPDF). Túto funkciu používajte ako kontrolu prvej línie a ako regresnú bránu v zostavovacích linkách. Ak chcete, aby knižnica naformátovala zoznamy problémov do opakovane použiteľného textového hlásenia, použite CreatePreflightReport alebo SavePreflightReport. Pre výstup hlásení do textu, JSON, HTML alebo CSV použite CreatePreflightReportEx alebo SavePreflightReportEx, prípadne pozrite Preflight Reports pre kompletný pracovný postup hláseníSúrodé API

GetPDFUADiagnostics vykonáva obdobné kontroly PDF/UA-1 (ISO 14289-1) nad práve zostavovaným dokumentom v pamäti namiesto nad externým súboromAk s touto knižnicou vytvárate výstup PDF/A, zavolajte

SetPDFAMode pred pridaním akéhokoľvek obsahu. Ochrana na strane generovania vnútri SetPDFAMode blokuje operácie zakázané zvolenou časťou, takže takto zostavený dokument zvyčajne prejde CheckFileCompliance automaticky

Príklad

// 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;

Pozri tiež

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

Test zhody 3 kontroluje PDF/X (ISO 15930): identifikáciu vydania, výstupný zámer, geometriu stránok, vložené písma a množinu zakázaných funkcií; pri PDF/X-6 navyše overí príznaky anotácií a pevné podoby, podoby AcroForm a podpisov, vylúčenia XFA a podôb generovaných prehliadačom, umiestnenie akcií, reťazce akcií, povolenú množinu pomenovaných akcií a každú hodnotu UseBlackPtCompTest zhody 4 kontroluje metaúdaje identifikácie PDF/VT-3, jeho základ rodiny PDF/X-6, graf DPartRoot a DPart, názvy a hodnoty DPM, úroveň záznamov, poradie stránok a presné pokrytie listov; zložené kontroly zdieľajú jeden priebeh syntaktickej analýzyTest zhody 5 kontroluje umiestnenie značky PDF/R-1, verziu a šifrovanie, nepriame objekty generácie nula, obmedzené slovníky a filtre, stránkové programy s jedným tokom, usporiadané rastrové pásma, kódovania obrázkov, pokrytie stránok a efektívne rozlíšenie; môže znova použiť priebeh zdieľanej validačnej linkyTest zhody 6 kontroluje základ PDF/X a identifikáciu XMP PDF/VCR-1, jediný priamy koreň šablóny, deklarované polia, voliteľné pole výberu stránok a každý listový zástupný prvok náhrady PassThrough, väzbu na stránku, MCID a ohraničujúci obdĺžnik; môže znova použiť priebeh zdieľanej validačnej linkyTest zhody 7 kontroluje identifikáciu a metaúdaje životného cyklu PDF/E-1, identifikátory traileru, pripustené šifrovanie, výstupné zámery a farebné priestory zariadení, operátory obsahu, písma, anotácie, formuláre, voliteľný obsah, akcie, odkazy na externé súbory, grafické stavy a obmedzenia tokov 3D; môže znova použiť priebeh zdieľanej validačnej linky