PDActionJavaScript

PDActionJavaScriptは、Apache PDFBox PDModel APIのクラスで、PDF文書内のJavaScriptアクションを表現します。 ( 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 ) で定義されているように、ユーザーインタラクションや文書イベントによってトリガーされるJavaScriptアクションをプログラム的に読み取り、作成、変更するためのメソッドを提供します。このクラスは、埋め込まれたJavaScriptコードを通じて動的な動作を必要とするインタラクティブなPDF機能を扱う開発者にとって不可欠です。

PDActionJavaScriptは、Apache PDFBoxのPDModelレイヤー内の高レベルJavaクラスで、PDFのJavaScriptアクションをカプセル化します。PDF文書において、JavaScriptアクションはフォームフィールドの検証、計算、文書レベルのスクリプトなどの動的な動作を可能にします。このクラスは特にJavaScriptアクションタイプ（アクションサブタイプ/JavaScript）を処理し、PDFビューアのJavaScriptエンジン内で実行されるECMAScriptコードを含みます。URIアクションや名前付きアクションなどの他のアクションタイプとは異なり、PDActionJavaScriptはJavaScriptコードスニペットの保存と実行に専念しています。このクラスは、JavaScriptの文字列コンテンツを取得および設定するメソッドを提供し、開発者がプログラム的にPDF文書にインタラクティブなスクリプト機能を追加することを容易にします。

PDFワークフローを構築する開発者にとって、PDActionJavaScriptは高度な動作を持つインタラクティブなPDF文書の作成と操作を可能にします。これは、サーバーサイド処理なしでクライアントサイドの検証、自動計算、またはカスタムユーザーインタラクションを必要とするPDFフォームを扱う際に特に重要です。このクラスにより、開発者はPDF文書へのJavaScriptの追加を自動化でき、一貫したインタラクティブ機能を必要とするPDFのバッチ処理が可能になります。PDActionJavaScriptの理解と活用は、既存のインタラクティブ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 ) のような標準に準拠したアクセシブルなフォーム体験の作成において重要です。適切なスクリプティングは支援技術のユーザビリティを向上させることができます。

PDActionJavaScriptは、PDF仕様におけるJavaScriptアクションを表す基礎となるPDF辞書構造をラップすることで機能します。このクラスのインスタンスを作成する際、setAction(String script)メソッドを使用してJavaScriptコードを設定でき、これによりECMAScriptコードがPDFのアクション辞書に保存されます。このクラスは、PDF要件に従ってJavaScript文字列のエンコードと保存を処理します。このアクションをPDF要素に関連付けるには、PDActionJavaScriptオブジェクトをフォームフィールドイベント、ページイベント、またはアノテーションアクションなどのトリガーに関連付けます。PDFが互換性のあるビューアで開かれると、JavaScriptエンジンが適切なトリガーポイントでコードを実行します。このクラスは、getAction()のようなメソッドも提供し、PDF文書から既存のJavaScriptを取得できるため、開発者は既存のPDF内のスクリプトを読み取り、変更することができます。この双方向の機能により、インタラクティブコンテンツを含むあらゆるPDF処理ワークフローにとって基本的なツールとなります。

• PDAction – PDFBoxにおけるすべてのアクションタイプの基底クラスで、ナビゲーション、URI、JavaScriptアクションなどを含む
• PDAnnotation – ユーザーインタラクションによってトリガーされる関連アクションを持つことができるPDFアノテーション
• PDAcroForm – フィールドの検証や計算にJavaScriptを頻繁に利用するPDF文書内のインタラクティブフォームオブジェクト
• PDDocument – アクションとインタラクティブ要素を含むPDF文書全体を表すPDFBoxの最上位レベルクラス
• PDPageAdditionalActions – ページが開かれたり閉じられたりする際にJavaScriptアクションをトリガーできるページレベルイベントを表すクラス