HotPDF Component：PDF/A、PDF/X 與 PDF/UA 驗證（Delphi）

HotPDF 是面向 Delphi 和 C++Builder 應用程式的原生 VCL PDF 程式庫，支援直接 PDF 建立、編輯、表單、註解、加密、數位簽章、Unicode 字型處理、標準導向輸出與預檢報告，無需部署外部 PDF 執行階段。

本文從 HotPDF Component 的產品實務出發，把「PDF/A、PDF/X 與 PDF/UA 驗證」拆成有責任邊界、設定版本、驗證證據與回歸樣本的工作流程。

實際風險在於處理結果只靠肉眼判斷，缺少設定版本、驗證證據和可重現樣本。可靠實作會把這種不確定性轉成命名設定、可度量檢查與回歸檔案。

把PDF/A、PDF/X 與 PDF/UA 驗證寫入 PDF 處理契約

在第一行寫入程式碼之前，先把這些決定寫進設定或設計說明。

PDF/A、PDF/X 與 PDF/UA 驗證的輸入 PDF、範本版本、處理設定和輸出目標
目標檢視器、驗證器、列印、歸檔或下游系統的相容要求
權限、密碼、憑證、字型、表單、註解和標準驗證相關策略
驗證失敗、警告放行、人工複核和回復路徑
記錄、診斷包、暫存檔案、憑證和客戶資料的保留規則

先識別文件狀態，再執行PDF/A、PDF/X 與 PDF/UA 驗證

可維護的實作通常依照以下順序推進。

先讀取來源檔案結構並確認頁數、權限、表單、簽章、字型或標準相關狀態
依命名設定執行 PDF/A、PDF/X 與 PDF/UA 驗證相關處理，並在每個階段記錄警告
生成輸出後用目標檢視器、驗證器、列印流程或下游系統複查關鍵結果
把輸入雜湊、設定版本、輸出路徑、警告數量和耗時寫入支援記錄
將暴露邊界問題的客戶 PDF 加入回歸樣本

能支援上線與排障的PDF/A、PDF/X 與 PDF/UA 驗證證據

輸出結果應留下能被另一位工程師、維運人員或支援同仁讀懂的證據，而不是只依賴開發機上的人工判斷。

輸入檔案雜湊、頁數、設定名稱、輸出路徑和處理耗時
與權限、字型、表單、簽章、標準驗證或頁面結構相關的警告
目標檢視器、驗證器、列印流程或下游應用的檢查結果
被保留、修改、扁平化、阻止或人工放行的物件清單
支援包位置、警告數量、輸出雜湊和回歸樣本編號

PDF/A、PDF/X 與 PDF/UA 驗證不是單一 PDF 呼叫

HotPDF Component 整合應把來源 PDF、頁面物件、字型、表單、簽章、權限、驗證器和目標檢視器放在同一個工程模型中。這樣 PDF/A、PDF/X 與 PDF/UA 驗證出現爭議時，團隊能解釋文件為什麼被接受、修改、拒絕或歸檔。

客戶可見行為

最終使用者不會關心內部呼叫順序，只會看到檔案是否能開啟、能否驗證、能否繼續編輯或是否被系統拒絕。因此 PDF/A、PDF/X 與 PDF/UA 驗證的結果必須轉成清楚的使用者狀態。

先讀取來源檔案結構並確認頁數、權限、表單、簽章、字型或標準相關狀態
依命名設定執行 PDF/A、PDF/X 與 PDF/UA 驗證相關處理，並在每個階段記錄警告
生成輸出後用目標檢視器、驗證器、列印流程或下游系統複查關鍵結果
客戶 PDF 可能包含舊版本物件、增量更新、表單、註解、簽章或損壞參照
不同檢視器、驗證器、列印驅動和字型環境可能改變可見結果

工程審閱要點：PDF/A、PDF/X 與 PDF/UA 驗證

下面這些要點適合放進設計審查或發佈審查中，用來確認文章討論的能力不是停留在示範層面。

決策：PDF/A、PDF/X 與 PDF/UA 驗證的輸入 PDF、範本版本、處理設定和輸出目標。實作時重點關注依命名設定執行 PDF/A、PDF/X 與 PDF/UA 驗證相關處理，並在每個階段記錄警告；驗收證據應包含目標檢視器、驗證器、列印流程或下游應用的檢查結果；回歸樣本還要覆蓋任何會改變簽章、權限或歸檔語意的步驟都必須明確記錄
決策：目標檢視器、驗證器、列印、歸檔或下游系統的相容要求。實作時重點關注生成輸出後用目標檢視器、驗證器、列印流程或下游系統複查關鍵結果；驗收證據應包含被保留、修改、扁平化、阻止或人工放行的物件清單；回歸樣本還要覆蓋記錄和支援包不能洩露密碼、憑證、客戶內容或暫存檔案路徑中的敏感資訊

PDF/A、PDF/X 與 PDF/UA 驗證容易暴露問題的邊界情況

這些情況最容易讓範例等級實作暴露問題，應各自納入命名回歸樣本。

客戶 PDF 可能包含舊版本物件、增量更新、表單、註解、簽章或損壞參照
不同檢視器、驗證器、列印驅動和字型環境可能改變可見結果
大型檔案、掃描檔案、加密檔案和帶外部資源的檔案需要單獨容量和安全策略
任何會改變簽章、權限或歸檔語意的步驟都必須明確記錄
記錄和支援包不能洩露密碼、憑證、客戶內容或暫存檔案路徑中的敏感資訊

Delphi 整合要點

在 Delphi 或 C++Builder 中，建議把 HotPDF Component 呼叫封裝在小型服務邊界後面。業務層只傳入檔案、串流、設定和憑證，服務層回傳輸出路徑、警告、指標和驗證狀態。本文涉及的重要術語包括 PDF/A, PDF/X, PDF/UA, preflight, output intent, tagged PDF。

Delphi 程式碼範例

下面的 Delphi 範例展示此主題在業務服務層中的落點。把策略檢查、記錄與驗證放在元件呼叫邊界之外，後續測試與排查會更穩定。

procedure ExportStandardsAwarePdf(const OutputFile: string; const ProfileName: string);
var
  Pdf: THotPDF;
  Report: string;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.FileName := OutputFile;
    ConfigureStandardsProfile(Pdf, ProfileName);
    Pdf.BeginDoc;
    WriteTaggedContent(Pdf);
    Pdf.EndDoc;
    Report := Pdf.CreatePreflightReport(OutputFile);
    FailBuildOnPreflightErrors(Report);
  finally
    Pdf.Free;
  end;
end;

上線檢查清單

分別使用空檔案、一般客戶檔案和最壞情況 PDF 執行流程
用目標檢視器、驗證器、列印流程或下游系統開啟輸出結果
記錄產品版本、設定版本、輸入雜湊、輸出路徑、耗時和警告數量
為密碼、憑證、暫存檔案和客戶資料設定明確保留規則
當客戶 PDF 暴露新邊界情況時，把樣本加入回歸集