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