PDAction

PDActionは、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構造です。

PDActionは、Apache PDFBoxにおける抽象基底クラスで、PDF仕様で定義されているPDFアクション辞書のJava表現を提供します。このクラスは、PDActionGoTo(目的地へのナビゲーション)、PDActionURI(Webリンクを開く)、PDActionJavaScript(スクリプトの実行)、PDActionSubmitForm(フォーム送信)など、特定のアクションタイプの親クラスとして機能します。注釈や目的地のような静的な文書要素とは異なり、PDActionオブジェクトはトリガーに応答する実行可能な動作をカプセル化します。このクラスは、既存のPDF文書からアクションのプロパティを読み取るメソッドや、プログラムで新しいアクションを構築するメソッドを提供しており、JavaアプリケーションでインタラクティブなPDF機能を扱う開発者にとって不可欠です。

PDF文書を扱う開発者にとって、PDActionはインタラクティブ機能の実装と管理において極めて重要です。 ( 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を作成する際、適切なアクション実装により、ナビゲーション支援とインタラクティブ要素が支援技術に対して正しく動作することが保証されます。PDActionを使用することで、開発者は既存の文書動作の抽出と分析、インタラクティブ要素の変更、新しいナビゲーション構造の作成、フォーム送信ワークフローの自動化が可能になります。PDActionの理解は、インタラクティブ性を保持または強化したり、カスタムナビゲーションパターンを実装したり、URIアクションとフォーム送信を通じてPDF文書をWebベースのワークフローと統合したりする必要があるPDF処理アプリケーションを構築する際に特に重要です。

PDActionは、PDFBoxのオブジェクトモデル階層の一部として動作し、低レベルのCOS(Carousel Object System)辞書構造と高レベルのJavaオブジェクト間の変換を行います。PDFを読み込む際、PDFBoxはアクション辞書を解析し、アクションのtypeエントリ( ( 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 ) では/Sキーとして指定)に基づいて適切なPDActionサブクラスをインスタンス化します。開発者は、関連付けられたトリガーを通じてPDActionオブジェクトにアクセスします。注釈はPDAnnotation.getAction()を介してアクションを持ち、フォームフィールドはPDField.getActions()を通じてアクションをトリガーし、文書レベルのイベントは文書カタログにアクションを格納します。各PDActionサブクラスは、タイプ固有のプロパティを実装しています。PDActionGoToは目的地情報を含み、PDActionURIはURLを格納し、PDActionJavaScriptはスクリプトコンテンツを保持します。プログラムでアクションを作成する際、開発者は特定のPDActionサブクラスをインスタンス化し、そのプロパティを設定して、適切なトリガーオブジェクトに添付します。PDFBoxフレームワークは、文書を保存する際にこれらのオブジェクトを適切にフォーマットされたPDF辞書構造にシリアライズします。

• PDAnnotation – PDActionオブジェクトをトリガーできるPDF文書内のインタラクティブなマークアップまたはウィジェット
• PDDestination – PDActionGoToがナビゲート先とするPDF文書内の特定の場所
• PDFormField – ユーザーインタラクションイベントに関連付けられたアクションを持つことができるインタラクティブなフォームフィールド
• COSDictionary – PDActionオブジェクトの基礎となるPDF辞書構造を表す低レベルのPDFBoxオブジェクト
• PDDocumentCatalog – 文書レベルのアクションを含むことができるPDF文書のルート構造