CheckFileComplianceA

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

説明

末尾の A は ANSI（char）DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は CheckFileCompliance と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される

外部 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 DLCheckFileComplianceA(InstanceID: Integer; InputFileName, Password: PAnsiChar; ComplianceTest, Options: Integer): Integer;

DLL

int DLCheckFileComplianceA(int InstanceID, const char * InputFileName, const char * Password, int ComplianceTest, int Options);

パラメータ

戻り値

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

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

備考

PDF/A テストは配信前の高速な自己チェックを目的としています。ファイルを即座に不適格とする文書レベルの問題（誤った PDF バージョン、OutputIntent の欠落、A レベルでの構造ツリーの欠落、暗号化、PDF/A-1 でのレイヤー）を検出します。すべてのコンテンツストリーム演算子を走査したり、描画オブジェクトごとのフォント埋め込みや色空間参照を検証したりはしません。これらの検証には veraPDF などの専用 PDF/A 検証ツールが必要です。この関数は一次チェックおよびビルドパイプラインの回帰ゲートとして使用します。問題一覧を再利用可能なテキストレポートに整形する場合は CreatePreflightReport または SavePreflightReport を使用します。テキスト、JSON、HTML、または CSV のレポート出力には CreatePreflightReportEx または SavePreflightReportEx を使用するか、完全なレポートワークフローについて Preflight Reports を参照します

コンパニオン API GetPDFUADiagnostics は、外部ファイルではなく現在構築中のメモリ内文書に対して PDF/UA-1（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