Connect 経由でのバッチ標準チェック

概要

このレシピでは、1 回の呼び出しで多数の PDF を 1 つ以上の名前付きポリシーに照らしてチェックします。Connect トランスポート経由でバッチコンプライアンスツールを使用します。このツールは Enterprise ティア です。class_exists() プローブで検出され、サーバーと同じ環境に nextpdf/premium がインストールされている場合にのみ登録されます。各ドキュメントはリクエスト内のすべてのポリシーに対してチェックされ、レスポンスはドキュメントごと・ポリシーごとに集約されたレポートになります。

単一ドキュメントのチェックと同様に、ポリシーごとの「合格」は、ツールが実装しているルールに対するツール自身のチェック結果であり、独立した適合性認証では ありません。適合性の判定はバリデーターが行います。

インストール

composer require nextpdf/server

Enterprise バッチツールが存在することを tools/list 呼び出しで確認します。/connect/tool-catalog/. を参照してください。

概念的な概要

標準は各ドキュメントに対する要件を定め、チェッカーはそれらの要件に照らして各ドキュメントを評価します（PDF/A-4 §6.2.3）。適合性は要件に対して判定されるものであり、プロデューサーが主張するものではありません（PDF/A-4 §6.7.3）。署名関連のポリシーでは PAdES ベースラインレベルが区別され、B-LT/B-LTA レベル（検証マテリアル、アーカイブタイムスタンプ）は Enterprise 専用の機能です（ETSI EN 319 142-2 §5.5）。バッチ結果は、ドキュメントセット全体について、同じく限定的な「実装済みのルールでは失敗がなかった」というセマンティクスを集約します。

API サーフェス

tools/list を使って、稼働中のレジストリに対してツール名を検証します。公式のカタログは /connect/tool-catalog/. です。このレシピでは、ツール数を改めて記載しません。

コードサンプル — クイックスタート

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "batch_compliance_check",
    "arguments": {
      "sources": ["/data/q1.pdf", "/data/q2.pdf"],
      "policies": ["pdfa-4"]
    }
  }
}

コードサンプル — 本番環境

curl -sS -X POST https://connect.example.com/v1/tools/batch_compliance_check \
  -H 'Authorization: Bearer '"$NEXTPDF_CONNECT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"sources":["/data/q1.pdf","/data/q2.pdf"],"policies":["pdfa-4"]}' \
  -o /tmp/batch.json -w '%{http_code}' > /tmp/batch-status || {
    echo "transport failure invoking batch_compliance_check" >&2; exit 1; }

レスポンスには、バッチ ID、集約された pass/fail のカウント、およびポリシーごとの結果と失敗理由を含むドキュメントごとの checks 配列が含まれます。失敗を抽出して修正し、影響を受けたドキュメントのみを再送信します。

エッジケースと注意点

空の sources または policies は、無効なパラメーターエラーになります。
ファイルが存在しない場合、バッチ全体が失敗するのではなく、結果ごとのエラーとして返されます。各結果に error フィールドがないか確認してください。
バッチサイズの上限超過は明示的なエラーです。より小さなバッチに分割してください。
不明なポリシー ID は、認識可能な識別子を列挙する不明な標準エラーになります。B-LT/B-LTA を参照する署名ポリシーは、それに必要なマテリアルを生成できる Enterprise デプロイメントでのみ意味を持ちます。
ツールが存在しない場合、nextpdf/premium がないと Enterprise バッチツールは登録されず、呼び出しは不明なツールエラーで失敗します。

パフォーマンス

フロントマターに記載したバジェットは、ドキュメント上の上限です。このツールはドキュメントをサーバー側で処理し、ドキュメントごとに相応の作業メモリが必要になります。グローバルタイムアウトを引き上げるのではなく、ホストのメモリに合わせてバッチサイズを調整してください。

セキュリティに関する注意

外部に送出されるログレベルでは、ソースパスやレポート全体をログに記録しないでください。バッチ ID と集約された pass/fail のカウントのみをログに記録してください。ポリシーごとの「合格」は、実装されたルールセットを示すものであり、セキュリティ上または法的な保証ではありません。

適合性

主張	条項	reference_id
標準が要件を定め、チェッカーが各ドキュメントを評価	PDF/A-4 §6.2.3
適合性は要件に対して判定され、プロデューサーが主張するものではない	PDF/A-4 §6.7.3
B-LT/B-LTA は検証マテリアルを追加する Enterprise 専用の個別レベル	ETSI EN 319 142-2 §5.5

バッチ標準チェックのサポートは、適合性認証ではありません。適合性の判定は、ドキュメントごとに独立したバリデーターが行います。

商用コンテキスト

バッチコンプライアンスツールは Enterprise ティアであり、サーバーと同じ環境に nextpdf/premium がインストールされている場合にのみ登録されます。

Connect 固有の事項

トランスポートの可用性（MCP / REST / gRPC）

このツールは、共有ツールエグゼキューターを通じて、MCP tools/call、REST ツールエンドポイント、gRPC サービスのいずれからも同じ方法で呼び出されます。

HITL リスクティア

バッチチェックは読み取り専用であり、デフォルトでは approval_required ではありません。オペレーターによるオーバーライドは、そのリスクレベルを引き上げる方向にしか作用しません。詳細は /connect/hitl-risk-tiers/ を参照してください。

確認ゲートの JSON エンベロープ

オペレーターによるオーバーライドが approval_required に引き上げる場合を除き、このツールはゲートをトリガーしません。エンベロープとワンタイムトークンのコントラクトは /connect/hitl-risk-tiers/. にあります。

Connect 経由でのバッチ標準チェック

Connect 経由でのバッチ標準チェック

概要

インストール

概念的な概要

API サーフェス

コードサンプル — クイックスタート

コードサンプル — 本番環境

エッジケースと注意点

パフォーマンス

セキュリティに関する注意

適合性

商用コンテキスト

Connect 固有の事項

トランスポートの可用性（MCP / REST / gRPC）

HITL リスクティア

確認ゲートの JSON エンベロープ

関連項目