CheckFileCompliance

Efterlevnad, dokumentinspektion

PDF/UA-läsaprofilval

PDF/UA-kontrollerna väljer del 2 när XMP identifierar pdfuaid:part=2 och behåller i övrigt del 1-kontrollerna; de äldre PDF/UA-1-kontroller som beskrivs här anses inte gälla del 2

PDF/UA-2-profilen implementerar kärnkontroller för identifikation, namnrymd, roll och struktur; strukturerade rapporter använder PDF/UA-2 och ISO 14289-2 och redovisar fullCertification=false och overifierad omfattning

Använd CheckFilePDFUACompliance eller RunPDFUAValidationPipelineTask för att tvinga en mål-del och GetPDFUAReadValidationCoverageJSON för att granska förmågesgränser

Beskrivning

Läser en extern PDF-fil och validerar den mot en vald ISO-efterlevnadsstandard. Returvärdet är antingen noll (filen klarar det valda testet rent) eller ett icke-noll StringListID-handtag som listar vartje upptäckt problem. Varje post i listan är en kort kod, ett kolon och ett mänskligt läsbart meddelande — exakt samma kodformat som GetPDFUADiagnostics använder. Uppräkna resultatet med GetStringListCount och GetStringListItemPDF/A-testet täcker alla sex efterlevnadslägen (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) och läser XMP-posterna

pdfaid:part/pdfaid:conformance för att avgöra vilken regeluppsättning som ska tillämpasPDF/UA-1-testet (tillagt i v3.56.0) kontrollerar en extern PDF mot ISO 14289-1 och avger diagnostikkoder i intervallet

10xxx, så att de förblir tydligt åtskilda från PDF/A-koderna 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);

Parametrar

Returvärden

PDF/A-problemkoder (ComplianceTest = 1)

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

Anmärkningar

PDF/A-testet är avsett som en snabb självkontroll före leverans. Det fångar de problem på dokumentnivå som underkänner en fil direkt (fel PDF-version, saknad OutputIntent, saknat strukturträd på A-nivå, kryptering, lager i PDF/A-1). Det går inte igenom varje innehållsströmsoperator och verifierar varken teckensnittsinbäddning eller färgrymdsreferenser för varje ritat objekt — dessa valideringar kräver en särskild PDF/A-validare (såsom veraPDF). Använd funktionen som en kontroll i första linjen och som en regressionsgrind i byggpipelines. Använd CreatePreflightReport eller SavePreflightReport när du vill att biblioteket ska formatera problemlistorna till en återanvändbar textrapport. Använd CreatePreflightReportEx eller SavePreflightReportEx för rapportutdata som text, JSON, HTML eller CSV, eller se Preflight Reports för det fullständiga rapportflödetSyster-API:t

GetPDFUADiagnostics utför motsvarande kontroller för PDF/UA (ISO 14289-1) på det minnesdokument som för närvarande byggs, i stället för på en extern filNär du producerar PDF/A-utdata med detta bibliotek anropar du

SetPDFAMode innan innehåll läggs till. Bevakningen på genereringssidan i SetPDFAMode blockerar de operationer som den valda delen förbjuder, så ett dokument som byggs på det sättet klarar normalt CheckFileCompliance automatiskt

Exempel

// 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 även

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

Efterlevnadstest 3 granskar PDF/X (ISO 15930): utgåvoidentifikation, OutputIntent, sidgeometri, inbäddade teckensnitt och uppsättningen förbjudna funktioner; för PDF/X-6 validerar det också anteckningsflaggor och fixerade utseenden, AcroForm- och signaturutseenden, XFA- och visargenererade utseendeundantag, åtgärdsplacering, åtgärdskedjor, den tillåtna uppsättningen namngivna åtgärder och vartje UseBlackPtComp-värde

Efterlevnadstest 4 granskar PDF/VT-3-identifikationsmetadata, dess PDF/X-6-familjebas, DPartRoot- och DPart-grafen, DPM-namn och -värden, postnivå, sidordning och exakt lövtäckning; de sammansatta kontrollerna delar ett parserpass

Efterlevnadstest 5 granskar PDF/R-1-markörplacering, version och kryptering, indirekta objekt av generation noll, begränsade dictionaries och filter, sidprogram i en enda ström, ordnade rasterremsor, bildkodningar, sidtäckning och effektiv upplösning; det kan återanvända ett delat valideringspipeline-pass

Efterlevnadstest 6 granskar PDF/X-grunden och PDF/VCR-1 XMP-identifiering, den enda direkta mallroten, deklarerade fält, valfritt sidvalsfält och varje löv-PassThrough-ersättningsplatshållare, sidbindning, MCID och begränsningsruta; det kan återanvända ett delat valideringspipeline-pass

Efterlevnadstest 7 granskar PDF/E-1-identifiering och livscykelmetadata, traileridentifierare, tillåten kryptering, utdataintent och enhetsfärgrymder, innehållsoperatorer, teckensnitt, annoteringar, formulär, valfritt innehåll, åtgärder, referenser till externa filer, grafiktillstånd och 3D-strömbegränsningar; det kan återanvända ett delat valideringspipeline-pass