Connect 経由で適合モードを選択する

境界。 適合モードを設定すると、カタログとメタデータは、対応する標準が期待する形で配線されます。これにより、エンジンはその標準への 適合を意図した 出力を生成します。ただし、これはドキュメントを「適合」にするわけでは ありません — 適合の判定はバリデーター（たとえば veraPDF）が行います。このページにあるすべての「適合」に関する記述は、「適合を意図する。結果はバリデーターが判定する」と読んでください。

概要

ドキュメントは適合判別子をちょうど 1 つ持ちます。プレーン、タグ付き/PDF-UA モード、または PDF/A モードのいずれかです。その判別子によって、ライターが出力するカタログ、構造、メタデータの配線が決まります。このレシピでは、Connect トランスポート経由で判別子を設定します。タグ付きモードのセッターはコア機能です。PDF/A-4 モードのセッターは恒久的に Premium ティア（ADR-011） であり、サーバーと併せて nextpdf/premium がインストールされている場合にのみ登録されます。

両方のセッターを呼び出すと、両方の機能スタックが重ね合わされます。単一値の判別子は依然として後勝ちに収束し、ツールが上書きを検出できるように上書き警告が出力されます。

インストール

composer require nextpdf/server

tools/list 呼び出しで、PDF/A モードのセッターが存在することを確認します。詳しくは /connect/tool-catalog/. を参照してください。

概念的な概要

適合マーカーは 意図された 適合を宣言します。実際の適合はバリデーターが判定します（PDF/A-4 §6.7.3）。適合は標準の要件に照らして判定されるものであり、生成ソフトウェアが主張するものではありません（PDF/A-4 §6.7.3）。タグ付きモードでは、構造ツリーと mark-info カタログエントリを配線します（ISO 32000-2 §14.7）。

したがって、モードの切り替えは配線操作です。これは、標準に照らして検査できるようにドキュメントを準備するためのものです。それ自体が適合結果になるわけではありません。

API サーフェス

ツール名は tools/list 経由で稼働中のレジストリに照らして検証されます。正式なカタログは /connect/tool-catalog/. です。このレシピではツール数を再掲しません。最初のコンテンツ呼び出しの前に判別子を選択してください。ライターは最初のページ出力時にモードを凍結します。

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

ドキュメントを作成し、タグ付き/PDF-UA モードに切り替えます。

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

レスポンスは、ライターがすべての出力箇所で参照する、アクティブなモード述語（タグ付き/アクセシビリティ/アーカイブ）を報告します。また、追加されたカタログの配線も報告します。述語はライターが出力する内容を示すものであり、結果が適合することを主張するものではありません。

コードサンプル — 本番

PDF/A-4（Premium ティア）に切り替えてから検査します。成功以外のステータスは、検査すべき通常の結果として扱ってください。

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "enable_pdf_a",
    "arguments": { "document_id": "<id>", "version": "PdfA4" }
  }
}

両方のセッターが呼び出された場合、判別子は後勝ちに収束し、上書き警告が出力されます。単一の判別子は加算的ではありませんが、配線は加算的であるため、機能スタックが配線されたまま残っている各フレーバーについて標準チェックを実行してください。

エッジケースと落とし穴

最初のページ以降のモード設定 は、凍結モードエラーで拒否されます。ドキュメントを作成した直後にモードを設定してください。
Premium なしの PDF/A セッター は失敗します — これは恒久的に Premium ティア（ADR-011）です。プレーンな PDF 2.0 ドキュメントには PDF/A モードは不要です。
不明な列挙ケース は拒否されます。サポートされるアーカイブケースは PDF/A-4 です（レガシーの PDF/A プロファイルは廃止されました）。
アーカイブモードで禁止される操作（たとえば埋め込み JavaScript）は、アーカイブ述語がアクティブな間は拒否されます。
チェック時のフレーバー/モードの不一致 は、非適合マーカーの所見を返します。アクティブなモードと一致するフレーバーを渡してください。両方のスタックが配線されている場合は、両方を渡します。

パフォーマンス

フロントマターの予算は、ドキュメント上の上限です。モードの配線は、計測可能な独立したフェーズを追加しません。

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

一般的な Connect トランスポートのガイダンスを超えて該当する事項はありません。

適合

主張	条項	reference_id
適合マーカーによる意図された適合の宣言。適合判定の主体はバリデーター	PDF/A-4 §6.7.3
要件に照らした適合判定。生成者による主張ではないこと	PDF/A-4 §6.7.3
タグ付きモードによる構造ツリーと mark-info エントリの配線	ISO 32000-2 §14.7

適合モードを選択すると、エンジンは 適合を意図した 出力を生成します。これは適合の認証ではありません。結果はバリデーターが判定します。

商用コンテキスト

PDF/A-4 モードのセッターは恒久的に Premium ティア（ADR-011）であり、サーバーと併せて 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 エンベロープ

関連項目