PDActionImportData

PDActionImportDataは、Apache PDFBoxのPDModel APIに含まれるクラスで、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文書が外部ファイルからフォームデータをインポートすることを可能にします。これは、PDF文書におけるインタラクティブな動作、特にフォームやデータ交換のシナリオを実現する複数のアクションタイプの一つです。

PDActionImportDataは、 ( 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 ) で規定されているインポートデータアクションタイプに対応する、Apache PDFBoxの高レベルPDModel API内の具象実装クラスです。このアクションは、PDFビューアに対して、外部ファイルからForms Data Format（FDF）データを現在のPDF内のインタラクティブフォームフィールドにインポートするよう指示します。他のアクションタイプ（例えば、目的地へ移動するGoToアクションや、外部アプリケーションを実行するLaunchアクション）とは異なり、PDActionImportDataは外部データソースからのフォームフィールド値のプログラム的な入力を専門的に処理します。このクラスはPDActionベースクラスを継承し、インポートするデータのソースを特定するファイル仕様を取得・設定するメソッドを提供します。

PDFフォームやデータ統合に取り組む開発者にとって、PDActionImportDataは自動フォーム入力ワークフローのプログラム的な制御を提供します。この機能は、データベース、Webサービス、またはその他の外部ソースからのデータを使用して、手動でのデータ入力なしにPDFフォームを事前入力する必要があるシステムを構築する際に不可欠です。このアクションタイプを理解することで、開発者はフォームデータをPDFテンプレートから分離できる、より洗練された文書ワークフローを作成できます。これにより、データ管理、バージョン管理、テンプレートの再利用性が向上します。これは、一括文書生成、文書組立システム、またはフォーム構造とデータコンテンツの分離が規制上または運用上の要件となっているコンプライアンス重視のフォーム処理を含むエンタープライズシナリオにおいて、特に価値があります。

PDActionImportDataアクションがトリガーされると（通常、フォーム送信、ボタンクリック、または文書オープンイベントを通じて）、PDFビューアはフォームデータを含む指定された外部ファイルを検索し、そのデータを現在の文書のインタラクティブフォームフィールドにインポートします。Apache PDFBoxを使用する開発者は、PDActionImportDataのインスタンスをプログラム的に作成し、それらをフォームウィジェット、ボタン、または文書イベントに関連付け、PDFileSpecificationオブジェクトを使用してファイルの場所を指定できます。外部ファイルは通常、FDF（Forms Data Format）またはXFDF（XML Forms Data Format）形式であり、フィールド名とそれに対応する値のペアが含まれています。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フォームアーキテクチャをサポートし、フォーム構造とフォームデータの分離を可能にし、アプリケーション間でのデータ交換を促進します。

• PDAction – Apache PDFBoxのPDModel APIにおけるすべてのアクションタイプのベースクラス
• PDFileSpecification – PDF文書内のファイル参照を表すクラスで、インポートアクションのデータソースを指定するために使用される
• AcroForm – インポートデータアクションによって値が入力されるフォームフィールドを含むPDFインタラクティブフォーム技術
• FDF（Forms Data Format） – PDF文書とは別にフォームデータを保存するために一般的に使用されるファイル形式
• PDAnnotationWidget – インポートデータアクションを含む、アクションを関連付けることができるフォームフィールドの注釈タイプ