PDNonTerminalField

PDNonTerminalField は、Apache PDFBox の高レベル PDModel API におけるクラスで、PDF インタラクティブフォーム（AcroForms）内の非終端フィールドを表します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) によれば、非終端フィールドは階層的なフォーム構造における親フィールドであり、子フィールドを含みますが、それ自体はデータ値を保持しません。これらのフィールドは、関連するフォームフィールドをグループ化する組織的なコンテナとして機能し、複雑なフォームの論理的な構造化を可能にします。

PDNonTerminalField は、Apache PDFBox の基底クラスである PDField クラスを拡張した Java クラスで、PDF フォーム階層内の非終端フィールドノードを専門的に処理します。ユーザー入力値を直接保持する終端フィールド（テキストフィールド、チェックボックス、ラジオボタンなど）とは異なり、非終端フィールドは他のフィールドを整理するためのコンテナとしてのみ機能します。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されている PDF 仕様では、これらのフィールドは子フィールドを持つ（フィールド辞書内の /Kids エントリで示される）一方で、ウィジェットアノテーションや直接的な値の格納を持たないことで識別されます。この区別はフォームアーキテクチャにとって重要です。終端フィールドはユーザーが操作できる実際のインタラクティブ要素を表し、非終端フィールドはこれらのインタラクティブ要素を論理的なセクションやカテゴリにグループ化する構造的なフレームワークを提供します。

PDNonTerminalField の理解は、階層的な組織化が必要な複雑な PDF フォームを扱う開発者にとって不可欠です。Apache PDFBox を使用してプログラム的にフォームを構築または変更する際、開発者はコンテナフィールドと実際のデータ保持フィールドのどちらを扱っているかを認識し、正しい操作を実行する必要があります。これは特にフォームフィールドツリーを走査する際に重要です。非終端フィールドはデータを格納しないため、非終端フィールドに対して値の読み取りや設定を試みると失敗します。アクセシビリティの観点から、適切に構造化された非終端フィールドは、支援技術がフォームをより効果的にナビゲートするのに役立ち、これはアクセシブルな PDF 文書のための ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) の要件と一致します。さらに、多くのエンタープライズフォームでは、繰り返しセクションやグループ化されたフィールドセットを作成するために非終端フィールドを使用しており、このクラスはエンタープライズドキュメントワークフローアプリケーションにとって重要です。

Apache PDFBox で PDNonTerminalField を使用する場合、開発者は主にデータ値ではなく子フィールドを管理するメソッドを通じて対話します。このクラスは、getChildren() などのメソッドを使用して子フィールドを取得する機能を提供します。このメソッドは、それ自体が終端フィールドまたは非終端フィールドである PDField オブジェクトのリストを返し、任意の深さのフォーム階層の再帰的な走査を可能にします。非終端フィールドは、基礎となる PDF 構造において、終端フィールドタイプを示す /FT（フィールドタイプ）エントリを持たずに /Kids 配列エントリが存在することで識別されます。PDF フォームを解析する際、PDFBox は適切なサブクラスを自動的にインスタンス化します。コンテナフィールドには PDNonTerminalField を、データフィールドには特定の終端フィールドクラス（PDTextField や PDCheckBox など）を使用します。開発者は通常、PDAcroForm.getFieldTree() などのメソッドを使用してフォームフィールドを反復処理する際にこれらのフィールドに遭遇し、値の操作を試みる前にフィールドタイプを確認する必要があります。非終端フィールドが可能にする階層構造は、部分的なフィールド命名をサポートする必要があるフォームにとって特に重要です。ここでは、 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で指定されているように、フィールドの完全修飾名は、親フィールド名と子フィールド名をピリオド区切り文字で連結することによって構築されます。

• PDField – Apache PDFBox において、PDF インタラクティブフォーム内の終端・非終端を問わず、あらゆるフィールドを表す基底クラス
• PDTerminalField – フォーム階層における末端ノードフィールドを表すクラスで、実際のユーザー入力データを保持する
• PDAcroForm – PDF ドキュメント内の完全なインタラクティブフォーム構造を表す Apache PDFBox のクラス
• PDAnnotationWidget – PDF ページ上の終端フォームフィールドの視覚的表現とインタラクション領域
• Field hierarchy（フィールド階層） – 複雑な PDF フォームにおける非終端フィールドと終端フィールド間の親子関係のツリー構造