ValidatePdfR - TPdf

Denna API-post behåller identifierare, signaturer, kodblock och PDF-termer i ursprunglig form.

Komponent: TPdf · Enhet: PDFium

Inspekterar den öppnade PDF:en efter PDF/R-1-kompatibilitetsmarkörer och returnerar ett strukturerat resultat med den identifierade kompatibilitetsnivån samt uppsättningen problem som hittades

Syntax

function ValidatePdfR: TPdfRValidationResult;

Beskrivning

ValidatePdfR går igenom det öppna dokumentet och letar efter de filformatsmarkörer som definieras av ISO 23504-1:2020:

Kommentaren %PDF-raster-x.y med versionsidentifiering nära slutet av filen (§5)
En header-rad av typen %PDF-1.4, %PDF-1.5, %PDF-1.6 eller %PDF-1.7 (§6.2.2) för okrypterade filer, eller %PDF-2.0 (§6.2.3) för krypterade filer
Avsaknaden av object streams (/Type /ObjStm — §6.2.4)
Överensstämmelse med katalogens white list i §6.3 (Version / ViewerPreferences / PageLayout / PageMode / AcroForm / Metadata; allt annat utlöser pvriProhibitedCatalogEntry)
Överensstämmelse med Document Information Dictionarys white list i §6.4.3 (Creator / Producer / CreationDate / ModDate; Title / Author / Subject / Keywords / Trapped utlöser pvriProhibitedInfoEntry)
En XMP metadata stream i katalogen (§6.4)
En trailer /ID-array

Resultatet är ett TPdfRValidationResult-record:

Conformance — prc1 (PDF/R-1-markör hittad), prcNone (ingen markör) eller prcUnknown (parsing misslyckades eller dokumentet är inaktivt)
Issues — en TPdfRValidationIssues-mängd med noll eller flera värden: pvriMissingVersionMarker, pvriBadHeader, pvriObjStmPresent, pvriProhibitedCatalogEntry, pvriProhibitedInfoEntry, pvriInfoXmpMismatch, pvriMissingXmpMetadata, pvriMissingTrailerId

ValidatePdfR är en skrivskyddad inspektion av filformatet. PDF/R-1-överensstämmelse har strikta strukturella krav som den här metoden inte kontrollerar — per-page Contents-struktur, MediaBox-form, tillåtna filter, indirekta referenser med generation noll, strip layout. Para ihop med en PDF/R-validator från TWAIN Working Group för dessa kontroller på innehållsnivå

Anmärkningar

Versionsmarkörkontrollen letar efter %PDF-raster- som en delsträng var som helst i filen. ISO 23504-1 §5 anger att markören placeras mellan trailer-dictionaryn och startxref, men valideraren accepterar andra placeringar för att vara förlåtande mot något icke-standardiserade generatorer
Om du anropar ValidatePdfR på ett inaktivt dokument returneras en post med Conformance = prcUnknown och en tom Issues-mängd
Kryptering är tillåten enligt §6.2.3 (med en %PDF-2.0-header), så valideraren flaggar inte trailer-nyckeln /Encrypt som en icke-överensstämmelse. Käll-PDF:er krypterade under PDF 1.x skulle ändå fallera på grund av headerkontrollen

Exempel

uses System.TypInfo;

var
  Outcome: TPdfRValidationResult;
  Issue: TPdfRValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\scan.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfR;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfRConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfRValidationIssue), Ord(Issue)));
end;

Se även

PdfRConformance, SaveAsPdfR, SaveAsPdfRToStream, ValidatePdfA, ValidatePdfX