ComparePreflightReports
合規性、文件檢查
描述
比較兩份純文字預檢報告,穩定內容有差異時傳回精簡的逐行 diff。迴歸測試、CI 作業或交付檢查若把基準報告放在 PDF 測試檔旁邊,可用這個 API 偵測報告漂移
語法
Delphi
Function TPDFlib.ComparePreflightReports(Const ReportA, ReportB: WideString): WideString;
參數
| ReportA | 基準純文字報告,通常由 CreatePreflightReport 產生,或從 SavePreflightReport 建立的檔案讀回。 |
|---|---|
| ReportB | 要與基準比較的目前純文字報告。 |
傳回值
正規化易變的 Generated: 時間戳記行之後,兩份報告相符則傳回空字串。穩定內容有差異時,結果以 PDF Library for Delphi Preflight Report Diff 開頭;共有行加兩個空格字首,只在 ReportA 的行以 - 標記,只在 ReportB 的行以 + 標記。
備註
此比較是為 CreatePreflightReport 產生的確定性文字輸出設計的。它不解析 JSON、HTML 或 CSV 報告;流程需要穩定的迴歸閘門時就比純文字形式,之後再產生給人或下游工具看的任何格式化報告。完整的命令列與批次流程見 Preflight Reports。
範例
Baseline := TFile.ReadAllText('expected-preflight.txt', TEncoding.UTF8);
Current := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
Diff := PDF.ComparePreflightReports(Baseline, Current);
if Diff <> '' then
TFile.WriteAllText('preflight.diff.txt', Diff, TEncoding.UTF8);
另見
Preflight Reports, CreatePreflightReport, CreatePreflightReportEx, SavePreflightReport, SavePreflightReportEx, CheckFileCompliance