ComparePreflightReports

準拠性、ドキュメント検査

説明

2 つのプレーンテキスト事前検査レポートを比較し、安定した内容が異なる場合はコンパクトな行単位の差分を返します。この API を使用すると、回帰テスト、CI ジョブ、または PDF フィクスチャの横に基準レポートを保持する配信チェックでレポートの変化を検出できます

構文

Delphi

Function TPDFlib.ComparePreflightReports(Const ReportA, ReportB: WideString): WideString;

パラメータ

ReportAベースラインとなるプレーンテキストレポートです。通常は CreatePreflightReport で生成するか、SavePreflightReport が作成したファイルから読み戻します
ReportBベースラインと比較する現在のプレーンテキストレポート

戻り値

変動する Generated: タイムスタンプ行を正規化した後にレポートが一致する場合は、空文字列を返します。安定した内容が異なる場合、結果は PDF Library for Delphi Preflight Report Diff で始まります。共通行には 2 個の空白プレフィックス、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