CheckFileComplianceA

Efterlevnad, dokumentinspektion

Beskrivning

Det avslutande A:et betecknar ANSI (char)-DLL-ingångspunkten; ActiveX/COM-ytan exponerar bara Unicode-formen. Beteendet är identiskt med CheckFileCompliance och strängargument tolkas med aktuell SetAnsiMode-kod sida

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-handle som listar alla upptäckta problem. Varje post i listan är en kort kod, ett kolon och ett läsbar meddelande – exakt samma kodformat som används av GetPDFUADiagnostics. Iterera resultatet med GetStringListCount och GetStringListItem.

PDF/A-testet täcker alla sex conformance-lägen (PDF/A-1a, PDF/A-1b, PDF/A-2a, PDF/A-2b, PDF/A-3a, PDF/A-3b) och läser pdfaid:part/pdfaid:conformance-XMP-posterna för att avgöra vilken regelmängd som ska tillämpas

PDF/UA-1-testet (tillagt i v3.56.0) kontrollerar en extern PDF mot ISO 14289-1 och genererar diagnostikkoder i 10xxx-intervallet så att de förblir visuellt separata från PDF/A:s 00xxx-koder

Syntax

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

Parametrar

Returvärden

PDF/A issue codes (ComplianceTest = 1)

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

Anmärkningar

PDF/A-testet är tänkt som en snabb självkontroll före leverans. Det fångar de dokumentnivåproblem som diskvalificerar 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 content stream-operator eller verifierar typsnittsinbäddning och färgrymdsreferenser för varje ritat objekt — de valideringarna kräver en dedikerad PDF/A-validator (som veraPDF). Använd den här funktionen som första linjens kontroll och som regressionsgrind i byggpipelines. Använd CreatePreflightReport eller SavePreflightReport när du vill att biblioteket formaterar problemslistorna till en återanvändbar textrapport. Använd CreatePreflightReportEx eller SavePreflightReportEx för text-, JSON-, HTML- eller CSV-rapportutdata, eller se Preflight Reports för hela rapportflödet

Kompanjon-API:t GetPDFUADiagnostics utför motsvarande kontroller för PDF/UA-1 (ISO 14289-1) på det dokument i minnet som för tillfället byggs, i stället för på en extern fil

När du producerar PDF/A-utdata med det här biblioteket, anropa SetPDFAMode innan du lägger till något innehåll. Genereringssidobevakningen inne i SetPDFAMode blockerar de operationer den valda delen förbjuder, så ett dokument byggt 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