CheckFileCompliance

コンプライアンス、ドキュメント検査

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ファイルを読み込み、選択したISOコンプライアンス規格に対して検証します。戻り値はゼロ（ファイルが選択したテストを問題なくパス）か、検出されたすべての問題を列挙する非ゼロのStringListIDハンドルのいずれかです。リストの各エントリは、短いコード、コロン、人間が読めるメッセージで構成され、GetPDFUADiagnosticsが使用するのとまったく同じコード形式です。結果の列挙にはGetStringListCountとGetStringListItemを使用しますPDF/Aテストは6つのすべての適合モード（PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-3a、PDF/A-3b）をカバーし、どのルールセットを適用するかを判断するために

pdfaid:part/pdfaid:conformanceのXMPエントリを読み取りますPDF/UA-1テスト（v3.56.0で追加）は外部PDFをISO 14289-1に対してチェックし、

10xxx範囲の診断コードを出力します。これにより、PDF/Aの00xxxコードと視覚的に区別が保たれます

構文

Delphi

Function TPDFlib.CheckFileCompliance(Const InputFileName, Password: WideString; ComplianceTest, Options: Integer): Integer;

ActiveX

Function PDFlib::CheckFileCompliance(InputFileName As String, Password As String, ComplianceTest As Long, Options As Long) As Long

DLL

int DLCheckFileCompliance(int InstanceID, const wchar_t * InputFileName, const wchar_t * Password, int ComplianceTest, int Options);

パラメータ

戻り値

PDF/Aの問題コード（ComplianceTest = 1）

PDF/UA-1の問題コード（ComplianceTest = 2）

備考

PDF/Aテストは、納品前の高速なセルフチェックを意図しています。ファイルをそのまま失格させるドキュメントレベルの問題（誤ったPDFバージョン、欠落したOutputIntent、Aレベルでの構造ツリーの欠落、暗号化、PDF/A-1でのレイヤー）を検出します。この関数はすべてのコンテンツストリームオペレーターをたどるわけでも、描画された各オブジェクトのフォント埋め込みやカラースペース参照を検証するわけでもありません。それらの検証には専用のPDF/Aバリデーター（veraPDFなど）が必要です。この関数を第一線のチェックとして、またビルドパイプラインのリグレッションゲートとして使用してください。ライブラリに問題リストを再利用可能なテキストレポートへ整形させたい場合はCreatePreflightReportまたはSavePreflightReportを使用し、テキスト、JSON、HTML、CSVのレポート出力にはCreatePreflightReportExまたはSavePreflightReportExを使用してください。完全なレポートワークフローについてはPreflight Reportsを参照してください姉妹APIの

GetPDFUADiagnosticsは、外部ファイルではなく、現在構築中のメモリ内ドキュメントに対してPDF/UA（ISO 14289-1）の同種のチェックを実行しますこのライブラリでPDF/A出力を生成する場合は、コンテンツを追加する前に

SetPDFAModeを呼び出してください。SetPDFAMode内の生成側ガードが、選択したパートで禁止された操作をブロックするため、そのように構築されたドキュメントは通常、自動的にCheckFileComplianceに合格します

例

// Validate a delivered PDF/A file and print all issues
var
  Issues, Count, I: Integer;
begin
  Issues := PDF.CheckFileCompliance('archive.pdf', '', 1, 0);
  if Issues = 0 then
    WriteLn('archive.pdf: PDF/A conformant')
  else
  begin
    Count := PDF.GetStringListCount(Issues);
    WriteLn('archive.pdf: ', Count, ' PDF/A issue(s) detected:');
    for I := 1 to Count do
      WriteLn('  ', PDF.GetStringListItem(Issues, I));
  end;
end;

// Fast pass/fail gate in a CI pipeline — stop on the first issue
var
  Failed: Boolean;
begin
  Failed := PDF.CheckFileCompliance('build/output.pdf', '', 1, 1) <> 0;
  if Failed then
    Halt(1);
end;

関連項目

Preflight Reports、CreatePreflightReport、CreatePreflightReportEx、SavePreflightReport、SavePreflightReportEx、ComparePreflightReports、SetPDFAMode、GetPDFUADiagnostics、GetStringListCount、GetStringListItem、SetPDFUAMode

コンプライアンステスト3はPDF/X（ISO 15930）を監査します。エディション識別、出力インテント、ページジオメトリ、埋め込みフォント、禁止機能セット。PDF/X-6ではさらに、注釈フラグと固定外観、AcroFormと署名外観、XFAとビューアー生成外観の除外、アクション配置、アクションチェーン、許可された名前付きアクションセット、すべてのUseBlackPtComp値を検証します

コンプライアンステスト4はPDF/VT-3識別メタデータ、そのPDF/X-6ファミリーベース、DPartRootとDPartグラフ、DPM名と値、レコードレベル、ページ順、正確なリーフカバレッジを監査します。合成チェックは1回のパーサーパスを共有します

コンプライアンステスト5はPDF/R-1マーカー配置、バージョンと暗号化、ジェネレーションゼロの間接オブジェクト、制限付き辞書とフィルター、シングルストリームページプログラム、順序付きラスタストリップ、画像エンコーディング、ページカバレッジ、実効解像度を監査します。共有検証パイプラインのパースを再利用できます

コンプライアンステスト6はPDF/X基盤とPDF/VCR-1 XMP識別、単一の直接テンプレートルート、宣言されたフィールド、オプションのページ選択フィールド、すべてのリーフPassThrough置換プレースホルダー、ページバインディング、MCIDと外接ボックスを監査します。共有検証パイプラインのパースを再利用できます

コンプライアンステスト7はPDF/E-1識別とライフサイクルメタデータ、トレーラー識別子、許可された暗号化、出力インテントとデバイスカラースペース、コンテンツオペレーター、フォント、注釈、フォーム、オプショナルコンテンツ、アクション、外部ファイル参照、グラフィックス状態、3Dストリーム制限を監査します。共有検証パイプラインのパースを再利用できます