Field dictionary

フィールド辞書（Field dictionary）は、PDF文書内のインタラクティブフォームフィールドのプロパティと動作を定義する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フォーム（AcroForms）の基本的な構成要素であり、PDF文書内でのユーザーインタラクションとデータ収集を可能にします。

フィールド辞書は、PDFファイル内の構造化データオブジェクトであり、単一のフォームフィールドの属性と機能を完全に記述します。画面上でユーザーが目にする視覚的なアノテーションとは異なり、フィールド辞書には基礎となるデータモデルが格納されており、フィールドの階層的な名前、タイプ分類（ボタン、テキスト、選択、署名）、デフォルト値と現在値、書式設定規則、検証スクリプト、読み取り専用ステータスや必須設定などの動作を制御する各種フラグが含まれます。

フィールド辞書とウィジェットアノテーション（Widget annotation）は異なります。フィールド辞書は論理的なフィールドプロパティを定義するのに対し、ウィジェットアノテーションは視覚的な表示とユーザーインタラクション領域を処理します。単一のフィールド辞書は複数のウィジェットアノテーションと関連付けることができ、同じフィールドをPDF文書の異なるページに表示することが可能です。また、フィールド辞書は、文書内のすべてのインタラクティブフォームフィールドのコンテナとして機能するより広範なフォーム辞書（AcroForm辞書）とも異なります。

フィールド辞書の理解は、PDFフォームをプログラムで作成、変更、またはデータ抽出する必要がある開発者にとって不可欠です。PDFフォームを生成するアプリケーションを構築する際、開発者は適切なタイプ指定とフラグを持つ正しくフォーマットされたフィールド辞書を構築し、異なる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 ) で参照されているように、支援技術がフォームフィールドを適切に識別し、操作するために必要なマッピング情報と代替説明が含まれているためです。不正確または不完全なフィールド辞書エントリは、スクリーンリーダーやその他のアクセシビリティツールで使用できないフォームを生成する可能性があり、適切なフィールド辞書の構築は多くの組織にとってコンプライアンス要件となっています。

フィールド辞書は、PDFファイル構造内に格納されたキーと値のペアのコレクションとして機能します。/FT（フィールドタイプ）エントリは基本的なもので、フィールドがボタン（/Btn）、テキストフィールド（/Tx）、選択フィールド（/Ch）、または署名フィールド（/Sig）のいずれであるかを指定します。/Tエントリは部分的なフィールド名を提供し、親フィールド名と組み合わせてデータ識別に使用される完全修飾フィールド名を作成します。

/Vエントリはフィールドの現在の値を格納し、/DVにはフォームがリセットされたときに使用されるデフォルト値が含まれます。/Ff（フィールドフラグ）エントリはビットフィールド整数を使用して、読み取り専用モード、必須入力、複数行テキスト、パスワードマスキング、ラジオボタングループ化などの様々な動作を有効にします。/TUなどの追加エントリはユーザーガイダンスのためのツールチップテキストを提供し、/TMはデータエクスポート用のフィールドのマッピング名を格納できます。

フィールド辞書は/Kidsと/Parentエントリを通じて階層関係を形成でき、コンテナフィールドが関連する入力フィールドをグループ化するツリー構造でフィールドを整理することができます。この階層により、開発者は複雑なフォームを論理的に整理し、ドット表記のパスを使用してフィールドを参照できます。ウィジェットアノテーションは/Parentエントリを通じて親フィールド辞書を参照し、視覚的な表示とデータストレージの間の接続を確立します。

フォーム処理を実装する開発者にとって、フィールド辞書は通常、PDFライブラリのAPIを通じてアクセスされます。このAPIは、フィールドを列挙し、値を読み取って変更し、フィールドプロパティを更新するメソッドを提供します。 ( 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プロセッサとビューア間で互換性を維持します。

• AcroForm – フィールド辞書を含み管理するPDFインタラクティブフォームアーキテクチャ
• Widget annotation – フィールド辞書に関連付けられた視覚的表現とインタラクション領域
• Field flags – フィールドの動作と検証を制御するフィールド辞書内のビットフィールド値
• Form field hierarchy – 複雑なフォームにおけるフィールド辞書間の親子関係構造
• Signature field – デジタル署名と承認ワークフローに使用される特殊なフィールド辞書タイプ