CreatePreflightReportEx

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

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 ファイルのプリフライトレポートを作成し、要求された出力形式に変換します。常にプレーンテキストレポートを返す CreatePreflightReport に対応する形式対応版です

構文

Delphi

Function TPDFlib.CreatePreflightReportEx(Const InputFileName, Password: WideString; ComplianceTests, Options, ReportFormat: Integer): WideString;

パラメータ

InputFileName検証する PDF ファイルの完全パスです。ファイルは読み取り専用で開かれ、変更されません
Passwordファイルを開くためのパスワードです。暗号化されていない文書には空文字列を渡します
ComplianceTests含めるチェックを選択するビットマスク: PDF/A は 1、PDF/UA は 2、両方は 3 または 0
Options選択した各準拠確認に渡すビットフラグ。各確認を最初の問題で停止するには 1 を渡します
ReportFormat出力形式セレクター

0 — プレーンテキスト
1 — ヘッダーフィールド、チェックごとのセクション、問題配列、および要約フィールドを含む JSON オブジェクト
2 — エスケープ済みテキストレポートを含む単独の HTML 文書
3 — メタデータ、選択したチェック、問題コードとメッセージ、および最終要約行を含む CSV 行

戻り値

選択した形式で生成されたレポートを返します。不明な ReportFormat 値はプレーンテキスト形式にフォールバックします

備考

JSON、HTML、CSV 形式は CreatePreflightReport で使用するものと同じテキストレポートから生成されるため、合格/不合格状態と問題数はすべてのレポート形式で一貫します

JSON オブジェクトはヘッダーフィールド、sections 配列、問題文字列配列、および summary オブジェクトを公開します。HTML 形式は、整形済みブロック内でテキストレポートをエスケープするスタンドアロンドキュメントです。CSV 形式は固定の kind,section,status,code,message 列を使用し、スプレッドシートまたは CI で解析できるよう、メタデータ、確認ステータス、問題行、概要行を分離します

完全なレポート形式の契約とコマンドラインデモの例については、Preflight Reports を参照してください

例

JsonReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 1);
HtmlReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 2);
CsvReport := PDF.CreatePreflightReportEx('output.pdf', '', 1 or 2, 0, 3);

関連項目

Preflight Reports、CreatePreflightReport、SavePreflightReportEx、ComparePreflightReports、CheckFileCompliance