ValidatePdfUa - 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/UA-1-kompatibilitetsmarkörer och returnerar ett strukturerat resultat med den identifierade kompatibilitetsnivån samt uppsättningen specifika problem som hittades

Syntax

function ValidatePdfUa: TPdfUaValidationResult;

Beskrivning

ValidatePdfUa går igenom det öppna dokumentet och letar efter PDF/UA-1-filformatsmarkörerna som definieras av ISO 14289-1:2014:

i katalogen eller någonstans i filen (§7.1) — krävs för att dokumentet över huvud taget ska kunna bära taggning
Catalog /MarkInfo << /Marked true /Suspects false >> (§7.1).
Catalog /ViewerPreferences << /DisplayDocTitle true >> (§7.1).
Catalog /Lang with a BCP 47 language tag (§7.2).
Trailer /ID array and the absence of encryption.
xmp:CreateDate / xmp:ModifyDate (recommended for Info/XMP parity).

Resultatet är ett TPdfUaValidationResult-record:

Conformance — den identifierade nivån: puc1 (PDF/UA-1 identifierad), pucNone (ingen PDF/UA-markör) eller pucUnknown (parsing misslyckades)
Issues — en TPdfUaValidationIssues-mängd med noll eller flera värden: pvuaiMissingXmpMetadata, pvuaiMissingPdfUaIdentifier, pvuaiMissingExtensionSchema, pvuaiMissingDcTitle, pvuaiMissingStructTreeRoot, pvuaiMissingMarkInfo, pvuaiSuspectsTrue, pvuaiMissingDisplayDocTitle, pvuaiMissingLang, pvuaiEncryptionPresent, pvuaiMissingTrailerId, pvuaiMissingXmpDates, pvuaiFontNotEmbedded, pvuaiFontMissingToUnicode, pvuaiMissingTabsOrder, pvuaiFigureMissingAlt, pvuaiFormulaMissingAlt, pvuaiNoteMissingId

ValidatePdfUa är en skrivskyddad inspektion — den ändrar inte dokumentet och är säker att anropa upprepade gånger. Använd den innan du lämnar en PDF till ett archivesystem eller en tillgänglighetskontroll för att synliggöra bristande överensstämmelse för operatören. För den vanliga kontrollen "är detta PDF/UA-1?" som inte behöver problemlistan, använd den lättare PdfUaConformance-egenskapen

Anmärkningar

ValidatePdfUa täcker filformatsmarkörerna, några byte-kontrollerbara innehållsheuristiker (font embedding, ToUnicode CMaps, sidans /Tabs /S tab order) och tre strukturträdskontroller med hög träffsäkerhet (Figure missing Alt/ActualText, Formula missing Alt, Note missing ett unikt ID). Den verifierar inte de återstående PDF/UA-reglerna på innehållsnivå — heading nesting, taggning av Form-widgetar, tabellattributen /TH /Scope, korrekthet i RoleMap, logisk läsordning och så vidare. För full validering, para ihop metoden med ett externt verktyg som PAC 2024 eller axesPDF
Om du anropar ValidatePdfUa på ett inaktivt dokument returneras en post med Conformance = pucUnknown och en tom Issues-mängd
Valideraren flaggar bara pvuaiSuspectsTrue när ett explicit /Suspects true visas i /MarkInfo. Dokument som helt saknar nyckeln /Suspects anses uppfylla kravet på den punkten (specifikationen förbjuder bara true)
SaveAsPdfUa tvingar fram de obligatoriska posterna /ViewerPreferences /DisplayDocTitle true och /MarkInfo /Marked true /Suspects false enligt ISO 14289-1 7.1 även när källan tillhandahåller dessa dictionaryer ofullständigt eller som en indirekt referens (N 0 R); befintliga nycklar bevaras och dictionaryn normaliseras till en direkt dictionary i den omskrivna katalogen

Exempel

uses System.TypInfo;

var
  Outcome: TPdfUaValidationResult;
  Issue: TPdfUaValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\report.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfUa;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfUaConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfUaValidationIssue), Ord(Issue)));
end;

Se även

PdfUaConformance, SaveAsPdfUa, SaveAsPdfUaToStream, IsTagged, ValidatePdfA