CheckFileComplianceA

Naleving, documentinspectie

Beschrijving

Het achtervoegsel A duidt het ANSI-toegangspunt (char) van de DLL aan; het ActiveX/COM-oppervlak stelt alleen de Unicode-vorm beschikbaar. Het gedrag is identiek aan CheckFileCompliance en tekenreeksargumenten worden geïnterpreteerd met behulp van de huidige SetAnsiMode-codetabel

Leest een extern PDF-bestand en valideert het tegen een gekozen ISO-conformiteitsstandaard. De retourwaarde is nul (bestand slaagt probleemloos voor de gekozen test) of een StringListID-handle ongelijk aan nul die elke gedetecteerde bevinding opsomt. Elke entry in de lijst is een korte code, een dubbele punt en een voor mensen leesbare melding — precies hetzelfde codeformaat dat GetPDFUADiagnostics gebruikt. Inventariseer het resultaat met GetStringListCount en GetStringListItem

De PDF/A-test dekt alle zes conformit modi (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) en leest de XMP-entries pdfaid:part/pdfaid:conformance om te bepalen welke regelset van toepassing is

De PDF/UA-1-test (toegevoegd in v3.56.0) controleert een externe PDF tegen ISO 14289-1 en geeft diagnostische codes uit in het bereik 10xxx, zodat die visueel gescheiden blijven van de PDF/A-codes 00xxx

Syntaxis

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

Parameters

Retourwaarden

PDF/A issue codes (ComplianceTest = 1)

PDF/UA-1 issue codes (ComplianceTest = 2)

Opmerkingen

De PDF/A-test is bedoeld als snelle zelfcontrole vóór oplevering. Hij vangt de bevindingen op documentniveau die een bestand ronduit afkeuren (verkeerde PDF-versie, ontbrekende OutputIntent, ontbrekende structuurboom op A-niveau, versleuteling, lagen in PDF/A-1). Hij loopt niet elke contentstream-operator af en verifieert geen fontinbedding of kleurruimtereferenties per getekend object — die validaties vereisen een toegewijde PDF/A-validator (zoals veraPDF). Gebruik deze functie als eerste-lijnscontrole en als regressiepoort in buildpipelines. Gebruik CreatePreflightReport of SavePreflightReport wanneer je de library de bevindingenlijsten in een herbruikbaar tekstrapport wilt laten gieten. Gebruik CreatePreflightReportEx of SavePreflightReportEx voor rapportuitvoer als tekst, JSON, HTML of CSV, of zie Preflight Reports voor de volledige rapportworkflow

De zuster-API GetPDFUADiagnostics voert vergelijkbare controles uit voor PDF/UA-1 (ISO 14289-1) op het in-memory document dat momenteel wordt gebouwd, in plaats van op een extern bestand

Roep bij het produceren van PDF/A-uitvoer met deze library SetPDFAMode aan voordat je inhoud toevoegt. De generatiezijdige bewaking in SetPDFAMode blokkeert de bewerkingen die het gekozen deel verbiedt, dus een document dat zo wordt gebouwd slagt normaal automatisch voor CheckFileCompliance

Voorbeeld

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

Zie ook

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