ValidatePdfUa - TPdf

此 API 頁面保留識別符號、簽名、程式碼區塊與 PDF 術語原樣

元件: TPdf · 單元: PDFium

檢查目前開啟的 PDF 是否有 PDF/UA-1 相容標記，並回傳一個結構化結果，包含偵測到的相容等級與找到的具體問題

語法

function ValidatePdfUa: TPdfUaValidationResult;

說明

ValidatePdfUa 會在開啟中的文件裡尋找 ISO 14289-1:2014 定義的 PDF/UA-1 檔案格式標記

帶有 pdfuaid:part = 1 的 XMP 中繼資料串流，以及對應的 pdfaExtension:schemas 說明（§5）
XMP packet 內必須有的 dc:title 項目（§7.1）
catalog 或檔案其他位置中的 StructTreeRoot（§7.1），這是文件能帶 tagging 的前提
catalog /MarkInfo << /Marked true /Suspects false >>（§7.1）
catalog /ViewerPreferences << /DisplayDocTitle true >>（§7.1）
帶有 BCP 47 language tag 的 catalog /Lang（§7.2）
trailer /ID 陣列，以及沒有加密
xmp:CreateDate / xmp:ModifyDate（建議用來維持 Info/XMP 一致）

回傳的結果會是 TPdfUaValidationResult record

Conformance，偵測到的等級：puc1（找到 PDF/UA-1 identifier）、pucNone（沒有 PDF/UA marker），或 pucUnknown（parse 失敗）
Issues，TPdfUaValidationIssues set，可能包含下列值中的一個或多個：pvuaiMissingXmpMetadata、pvuaiMissingPdfUaIdentifier、pvuaiMissingExtensionSchema、pvuaiMissingDcTitle、pvuaiMissingStructTreeRoot、pvuaiMissingMarkInfo、pvuaiSuspectsTrue、pvuaiMissingDisplayDocTitle、pvuaiMissingLang、pvuaiEncryptionPresent、pvuaiMissingTrailerId、pvuaiMissingXmpDates、pvuaiFontNotEmbedded、pvuaiFontMissingToUnicode、pvuaiMissingTabsOrder、pvuaiFigureMissingAlt、pvuaiFormulaMissingAlt、pvuaiNoteMissingId

ValidatePdfUa 是唯讀檢查，不會修改文件，也可以重複呼叫，建議在把 PDF 交給封存系統或無障礙檢查器之前先跑一次，好把不相容的地方直接顯示給操作人員，若只是要確認「這是不是 PDF/UA-1」而不需要 issue list，請改用較輕量的 PdfUaConformance 屬性

注意事項

ValidatePdfUa 會檢查 file-format 標記、少數可用位元組檢查的內容 heuristic（字型內嵌、ToUnicode CMaps、頁面 /Tabs /S tab order），以及三項高信心的 structure-tree 檢查（Figure 缺少 Alt/ActualText、Formula 缺少 Alt、Note 缺少唯一 ID），但不會驗證其餘內容層 PDF/UA 規則，例如標題層級、Form widget tagging、table /TH /Scope 屬性、RoleMap 正確性、logical reading order 等，若要完整驗證，請搭配 PAC 2024 或 axesPDF 之類的外部工具
在沒有啟用的文件上呼叫 ValidatePdfUa，會回傳 Conformance = pucUnknown 且 Issues 是空集合的 record
只有在 /MarkInfo 裡明確出現 /Suspects true 時，驗證器才會標記 pvuaiSuspectsTrue，如果文件根本沒有 /Suspects key，則視為該點相容，因為規格只禁止 true
即使來源提供的 dictionaries 不完整，或是 indirect reference（N 0 R），SaveAsPdfUa 仍會強制寫入 ISO 14289-1 7.1 要求的 /ViewerPreferences /DisplayDocTitle true 與 /MarkInfo /Marked true /Suspects false 項目，既有 keys 會保留，而重寫後的 catalog 會被正規化成 direct dictionary

實例

uses System.TypInfo;

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

另請參閱

PdfUaConformance, SaveAsPdfUa, SaveAsPdfUaToStream, IsTagged, ValidatePdfA

ValidatePdfUa 方法

元件: TPdf · 單元: PDFium

語法

說明

注意事項

實例

另請參閱