CheckFileCompliance

Overholdelse, dokumentinspektion

Beskrivelse

Læser en ekstern PDF-fil og validerer den mod en valgt ISO-overholdelsesstandard. Den returnerede værdi er enten nul (filen består den valgte test fejlfrit) eller et StringListID-handle forskelligt fra nul, som lister hvert fundet problem. Hver indgang i listen er en kort kode, et kolon og en menneskelæsbar meddelelse — præcis samme kodeformat, som GetPDFUADiagnostics bruger. Oplist resultatet med GetStringListCount og GetStringListItemPDF/A-testen dækker alle seks overholdelsestilstande (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) og læser XMP-indgangene

pdfaid:part/pdfaid:conformance for at afgøre, hvilket regelsæt der skal anvendesPDF/UA-1-testen (tilføjet i v3.56.0) tjekker en ekstern PDF mod ISO 14289-1 og udsender diagnostiske koder i

10xxx-intervallet, så de forbliver visuelt adskilt fra PDF/A-koderne 00xxx

Syntaks

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

Returværdier

PDF/A-problemkoder (ComplianceTest = 1)

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

Bemærkninger

PDF/A-testen er beregnet som en hurtig selvtjek før levering. Den fanger de dokumentniveau-problemer, der diskvalificerer en fil fuldstændigt (forkert PDF-version, manglende OutputIntent, manglende strukturtræ på A-niveauet, kryptering, lag i PDF/A-1). Den gennemgår ikke hver enkelt operator i indholdsstreamen og verificerer ikke skrifttypeindlejring eller farverumsreferencer for hvert malet objekt — de valideringer kræver en dedikeret PDF/A-validator (såsom veraPDF). Brug denne funktion som en første kontrol og som en regressionsport i byggepipelines. Brug CreatePreflightReport eller SavePreflightReport, når du ønsker, at biblioteket skal formatere problemlisterne til en genbrugelig tekstrapport. Brug CreatePreflightReportEx eller SavePreflightReportEx til rapportoutput i tekst, JSON, HTML eller CSV, eller se Preflight Reports for den komplette rapportarbejdsgangCompanion-API'en

GetPDFUADiagnostics udfører tilsvarende kontroller for PDF/UA-1 (ISO 14289-1) på det dokument i hukommelsen, der bygges lige nu, frem for på en ekstern filNår du producerer PDF/A-output med dette bibliotek, skal du kalde

SetPDFAMode, før du tilføjer indhold. Vagten på genereringssiden i SetPDFAMode blokerer de operationer, som den valgte del forbyder, så et dokument bygget på den måde normalt består CheckFileCompliance automatisk

Eksempel

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

Se også

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

Overholdelsestest 3 auditorer PDF/X (ISO 15930): udgaveidentifikation, output intent, sidegeometri, indlejrede skrifttyper og sættet af forbudte funktioner; for PDF/X-6 validerer den også annoteringsflag og faste udseender, AcroForm- og signaturudseender, XFA- og viewer-genererede udseendeudelukkelser, handlingsplacering, handlingskæder, det tilladte sæt af navngivne handlinger og hver UseBlackPtComp-værdiOverholdelsestest 4 auditorer PDF/VT-3-identifikationsmetadata, dens PDF/X-6-familiebase, DPartRoot- og DPart-grafen, DPM-navne og -værdier, postniveau, siderækkefølge og nøjagtig bladdækning; de sammensatte kontroller deler én parserkørselOverholdelsestest 5 auditorer PDF/R-1-markørplacering, version og kryptering, indirekte objekter af generation nul, begrænsede ordbøger og filtre, sideprogrammer i én enkelt stream, ordnede rasterstriber, billedkodninger, sidedækning og effektiv opløsning; den kan genbruge en delt valideringspipeline-parseOverholdelsestest 6 auditorer PDF/X-fundamentet og PDF/VCR-1 XMP-identifikation, den enlige direkte skabelonrod, deklarerede felter, valgfrit sidevalgsfelt og hver blad-PassThrough-erstatningspladsholder, sidebinding, MCID og afgrænsningsboks; den kan genbruge en delt valideringspipeline-parseOverholdelsestest 7 auditorer PDF/E-1-identifikation og livscyklusmetadata, traileridentifikatorer, tilladt kryptering, output intents og enhedsfarverum, indholdsoperatorer, skrifttyper, annoteringer, formularer, valgfrit indhold, handlinger, referencer til eksterne filer, grafiktilstande og 3D-stream-begrænsninger; den kan genbruge en delt valideringspipeline-parse