PDFlibPas：PDF/A 與 PDF/UA 預檢（Delphi）

losLab PDF Library 為 Delphi 和 C++Builder 團隊提供附原始碼的 PDF 引擎，適用於桌面、伺服器、DLL、ActiveX 與 Dylib 流程，內建 PDF/A 與 PDF/UA 檢查、PAdES 簽署支援和多種轉譯器選擇，無需將文件交給外部 PDF 服務。

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

最常見的失敗模式是樣本檔案看似正常，但真實客戶檔案、目標檢視器或下游系統暴露差異。要解決它，設計階段的決定必須能在記錄、驗證報告與支援包中被看見。

把PDF/A 與 PDF/UA 預檢寫入 PDF 處理契約

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

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

先識別文件狀態，再執行PDF/A 與 PDF/UA 預檢

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

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

能支援上線與排障的PDF/A 與 PDF/UA 預檢證據

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

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

PDF/A 與 PDF/UA 預檢不是單一 PDF 呼叫

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

支援包應包含哪些資訊

PDFlibPas 整合一旦進入客戶環境，支援同仁需要從診斷包直接判斷輸入、設定、輸出與失敗階段。

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

工程審閱要點：PDF/A 與 PDF/UA 預檢

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

決策：PDF/A 與 PDF/UA 預檢的輸入 PDF、範本版本、處理設定和輸出目標。實作時重點關注依命名設定執行 PDF/A 與 PDF/UA 預檢相關處理，並在每個階段記錄警告；驗收證據應包含目標檢視器、驗證器、列印流程或下游應用的檢查結果；回歸樣本還要覆蓋任何會改變簽章、權限或歸檔語意的步驟都必須明確記錄
決策：目標檢視器、驗證器、列印、歸檔或下游系統的相容要求。實作時重點關注生成輸出後用目標檢視器、驗證器、列印流程或下游系統複查關鍵結果；驗收證據應包含被保留、修改、扁平化、阻止或人工放行的物件清單；回歸樣本還要覆蓋記錄和支援包不能洩露密碼、憑證、客戶內容或暫存檔案路徑中的敏感資訊
決策：權限、密碼、憑證、字型、表單、註解和標準驗證相關策略。實作時重點關注把輸入雜湊、設定版本、輸出路徑、警告數量和耗時寫入支援記錄；驗收證據應包含支援包位置、警告數量、輸出雜湊和回歸樣本編號；回歸樣本還要覆蓋客戶 PDF 可能包含舊版本物件、增量更新、表單、註解、簽章或損壞參照
決策：驗證失敗、警告放行、人工複核和回復路徑。實作時重點關注將暴露邊界問題的客戶 PDF 加入回歸樣本；驗收證據應包含輸入檔案雜湊、頁數、設定名稱、輸出路徑和處理耗時；回歸樣本還要覆蓋不同檢視器、驗證器、列印驅動和字型環境可能改變可見結果

PDF/A 與 PDF/UA 預檢容易暴露問題的邊界情況

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

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

Delphi 整合要點

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

Delphi 程式碼範例

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

procedure RunStandardsPreflight(const InputFile, ReportFile: string; const Profile: string);
var
  Pdf: TPDFlib;
begin
  Pdf := TPDFlib.Create;
  try
    Pdf.LoadFromFile(InputFile, '');
    TFile.WriteAllText(ReportFile, BuildStandardsReport(Pdf, Profile), TEncoding.UTF8);
    FailOnBlockingStandardsIssues(ReportFile);
  finally
    Pdf.Free;
  end;
end;

上線檢查清單

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