CreatePreflightReport
準拠性、ドキュメント検査
PDF/UA リーダープロファイルの選択
PDF/UA チェックは、XMP が pdfuaid:part=2 を示していれば part 2 を選択し、そうでなければ part 1 のチェックを維持します。ここで説明する従来の PDF/UA-1 チェックは、part 2 にもそのまま当てはまるとは限りません
PDF/UA-2 プロファイルは、識別情報・名前空間・ロール・構造のコアチェックを実装します。構造化レポートでは PDF/UA-2 と ISO 14289-2 を使用し、fullCertification=false と未検証の範囲を明示します
ターゲット part を強制するには CheckFilePDFUACompliance または RunPDFUAValidationPipelineTask を、対応範囲の上限を確認するには GetPDFUAReadValidationCoverageJSON を使用してください
説明
既存の PDF/A および PDF/UA-1 ファイル準拠チェックを実行し、その結果を再利用可能な 1 つのレポート本文に整形して、外部 PDF ファイル用のプレーンテキストプリフライトレポートを作成する。CheckFileCompliance、GetStringListCount、GetStringListItem、ReleaseStringList を手動で呼び出す代わりに、人間が読めるレポートを必要とするアプリケーションで使用する便利な API である
構文
Delphi
Function TPDFlib.CreatePreflightReport(Const InputFileName, Password: WideString; ComplianceTests, Options: Integer): WideString;
パラメータ
| InputFileName | 検証する PDF ファイルの完全パスです。ファイルは読み取り専用で開かれ、変更されません |
|---|---|
| Password | ファイルを開くためのパスワードです。暗号化されていない文書には空文字列を渡します |
| ComplianceTests | 含める確認を選択するビットマスクです。 1 — PDF/A。 2 — PDF/UA-1。 3 — PDF/A と PDF/UA-1 の両方。 0 を渡しても両方の確認を実行します |
| Options | 基礎となる各適合性検査へ渡すビットフラグです。 0 — 選択した各検査で見つかったすべての問題を報告します。 1 — 選択した各検査を最初の問題で停止します |
戻り値
レポートヘッダー、選択した各準拠チェックごとの 1 セクション、および Total issues と Result 行を含む最終要約を含む UTF-16 テキストレポートを返す
備考
複数の標準を選択した場合、ファイルは一度だけ解析され、両方の監査で同じリーダー、セキュリティ状態、ドキュメントオブジェクトグラフ、および遅延オブジェクトキャッシュを共有します
レポート API は専用の外部 PDF/A バリデーターを置き換えるものではありません。ライブラリ内蔵の初期段階の PDF/A および PDF/UA-1 診断を、安定したアプリケーション向けレポートにまとめます。アプリケーションでテキスト、JSON、HTML、または CSV 出力が必要な場合は CreatePreflightReportEx を使用し、整形済みテキストではなく個別の問題一覧ハンドルが必要な場合は CheckFileCompliance を直接使用します
プレーンテキストレポートは、すべての整形済みレポートの正規ソースです。変動する Generated: メタデータ、Input: パス、選択したチェック、問題収集モード、選択した適合性テストごとのセクション、および Total issues と Result を含む最終概要が格納されます
コマンドラインおよびバッチレポートのワークフローについては、Preflight Reports を参照してください
例
var
Report: WideString;
begin
Report := PDF.CreatePreflightReport('output.pdf', '', 1 or 2, 0);
WriteLn(Report);
end;関連項目
Preflight Reports、CreatePreflightReportEx、SavePreflightReport、ComparePreflightReports、CheckFileCompliance、GetPDFUADiagnostics、SetPDFAMode、SetPDFUAMode