CheckFileCompliance

Naleving, documentinspectie

PDF/UA-lezerprofielkeuze

PDF/UA-controles kiezen deel 2 wanneer XMP pdfuaid:part=2 identificeert en behouden anders de deel 1-controles; van de hier beschreven oudere PDF/UA-1-controles mag niet worden aangenomen dat ze voor deel 2 gelden

Het PDF/UA-2-profiel implementeert kerncontroles voor identificatie, naamruimten, rollen en structuur; gestructureerde rapporten gebruiken PDF/UA-2 en ISO 14289-2 en vermelden fullCertification=false en de niet-geverifieerde reikwijdte

Gebruik CheckFilePDFUACompliance of RunPDFUAValidationPipelineTask om een doeldeel af te dwingen en GetPDFUAReadValidationCoverageJSON om de grenzen van de mogelijkheden te bekijken

Beschrijving

Leest een extern PDF-bestand en valideert dit tegen een gekozen ISO-nalevingsstandaard. De teruggegeven waarde is nul (het bestand doorstaat de gekozen test volledig) of een niet-nul StringListID-handle die elk gedetecteerd probleem opsomt. Elke invoer in de lijst bestaat uit een korte code, een dubbele punt en een voor mensen leesbare melding — exact hetzelfde codeformaat dat GetPDFUADiagnostics gebruikt. Som de resultaten op met GetStringListCount en GetStringListItemDe PDF/A-test bestrijkt alle zes conformantiemodi (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) en leest de XMP-invoeren

pdfaid:part/pdfaid:conformance om te bepalen welke regelset moet worden toegepastDe PDF/UA-1-test (toegevoegd in v3.56.0) controleert een externe PDF tegen ISO 14289-1 en geeft diagnostische codes in het

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

Syntaxis

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

Parameters

Retourwaarden

PDF/A-probleemcodes (ComplianceTest = 1)

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

Opmerkingen

De PDF/A-test is bedoeld als snelle zelfcontrole vóór oplevering. Hij vangt de problemen op documentniveau die een bestand ronduit diskwalificeren (verkeerde PDF-versie, ontbrekende OutputIntent, ontbrekende structuurboom op A-niveau, versleuteling, lagen in PDF/A-1). Hij doorloopt niet elke contentstream-operator en verifieert evenmin lettertype-insluiting of kleurruimteverwijzingen per getekend object — die validaties vereisen een specifieke PDF/A-validator (zoals veraPDF). Gebruik deze functie als eerste controle en als regressiepoort in buildpipelines. Gebruik CreatePreflightReport of SavePreflightReport wanneer u wilt dat de bibliotheek de probleemlijsten opmaakt in een herbruikbaar tekstrapport. Gebruik CreatePreflightReportEx of SavePreflightReportEx voor rapportuitvoer in tekst, JSON, HTML of CSV, of zie Preflight Reports voor de volledige rapportworkflowDe companion-API

GetPDFUADiagnostics voert vergelijkbare controles voor PDF/UA (ISO 14289-1) uit op het in-memory document dat momenteel wordt gebouwd, in plaats van op een extern bestandWanneer u met deze bibliotheek PDF/A-uitvoer produceert, roept u

SetPDFAMode aan voordat u inhoud toevoegt. De generation-side guard in SetPDFAMode blokkeert de bewerkingen die het gekozen onderdeel verbiedt, zodat een document dat op die manier wordt gebouwd normaal gesproken automatisch door CheckFileCompliance komt

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

Nalevingstest 3 controleert PDF/X (ISO 15930): editie-identificatie, output intent, paginageometrie, ingesloten fonts en de verboden-functieset; voor PDF/X-6 valideert hij ook annotatievlaggen en vaste appearances, AcroForm- en handtekeningappearances, uitsluitingen voor XFA en viewergegenereerde appearances, actieplaatsing, actieketens, de toegestane set named actions en elke UseBlackPtComp-waarde

Nalevingstest 4 controleert PDF/VT-3-identificatiemetadata, de PDF/X-6-familiebasis daarvan, de DPartRoot- en DPart-graaf, DPM-namen en -waarden, recordniveau, paginavolgorde en exacte bladdekking; de samengestelde controles delen één parserpassage

Nalevingstest 5 controleert PDF/R-1-markerplaatsing, -versie en -versleuteling, indirecte objecten van generatie nul, beperkte woordenboeken en filters, paginaprogramma's in één stream, geordende rasterstroken, afbeeldingscoderingen, paginadekking en effectieve resolutie; hij kan een gedeelde validatiepijplijnpassage hergebruiken

Nalevingstest 6 controleert de PDF/X-basis en de PDF/VCR-1 XMP-identificatie, de enkele directe templateroot, de gedeclareerde velden, het optionele paginaselectieveld en elke PassThrough-vervangplaceholder op bladniveau, pagina­binding, MCID en bounding box; hij kan een gedeelde validatiepijplijnpassage hergebruiken

Nalevingstest 7 controleert PDF/E-1-identificatie en lifecycle-metadata, trailer-identificatoren, toegestane versleuteling, output intents en apparaatkleurruimten, inhoudsoperators, fonts, annotaties, formulieren, optional content, acties, verwijzingen naar externe bestanden, graphics states en 3D-streambeperkingen; hij kan een gedeelde validatiepijplijnpassage hergebruiken