JavaScript action

JavaScript actionは、PDF内に埋め込まれたJavaScriptコードを実行するPDFのアクションタイプです。ユーザーインタラクションやドキュメントイベントによってトリガーされると、JavaScript actionは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 ) で定義されているように、JavaScript actionはPDF仕様で利用可能な複数のアクションタイプの1つであり、PDFドキュメント内でスクリプト機能を実現します。

JavaScript actionは、JavaScriptサポートを持つ準拠PDFプロセッサによって実行されるJavaScriptコードを含む、特定のタイプのPDFアクションオブジェクトです。ナビゲーションやフォーム送信など事前定義された操作を実行する他のアクションタイプとは異なり、JavaScript actionは埋め込まれたスクリプトを通じて柔軟でプログラム可能な動作を提供します。このアクションは、アクションタイプ「JavaScript」として定義され、実行するJavaScriptコードを含むテキスト文字列またはストリームを含んでいます。

JavaScript actionは、ボタンクリック、ページ開封イベント、フォームフィールド変更などの特定のトリガーに関連付けることができるアクションオブジェクトとして明示的に定義されている点で、他のPDFスクリプト機構とは異なります。JavaScriptコードは、PDFプロセッサのJavaScriptエンジン内で実行されます。このエンジンは、コアECMAScriptをベースとし、ドキュメント操作のためのPDF固有の拡張機能を持つJavaScriptのサブセットを実装しています。

JavaScript actionは、インタラクティブなPDFフォーム、動的ドキュメント、カスタム検証ロジックを作成する開発者にとって重要です。以下を可能にします：

• フォーム検証: サーバーサイド処理なしで、PDFフォームにおけるリアルタイムのフィールド検証と計算を実装
• 動的な動作: ユーザー入力やドキュメント状態に基づいてコンテンツを更新するレスポンシブなユーザーインターフェースの作成
• カスタムワークフロー: フィールドの自動入力、データフォーマット、条件付きロジックなどのドキュメント操作の自動化
• 拡張されたインタラクティブ性: ユーザーフィードバックの提供、ナビゲーションの制御、ドキュメントイベントの管理

JavaScript actionの理解は、PDF生成ライブラリの開発やインタラクティブなPDF機能を扱う際に不可欠です。これらは、静的なドキュメント構造と動的なユーザーエクスペリエンスの間の橋渡しをするからです。

JavaScript actionは、PDFファイル構造内のアクション辞書オブジェクトとして定義されます。アクション辞書には以下が含まれます：

1. アクションタイプ: アクションサブタイプとして「JavaScript」を指定する必須エントリ
2. JavaScriptコード: 実際のJavaScriptソースコードを含むテキスト文字列またはストリームオブジェクト
3. 関連付け: トリガーオブジェクト（注釈、フォームフィールド、ページイベント、またはドキュメントレベルのイベント）へのリンク

JavaScript actionがトリガーされると、PDFプロセッサのJavaScriptエンジンが現在のドキュメントのコンテキスト内でコードを実行します。JavaScript環境には以下が含まれます：

• app、doc、eventなどのオブジェクトを通じたPDFドキュメントオブジェクトモデル（DOM）へのアクセス
• Fieldオブジェクトとフィールド固有のメソッドを通じたフォームフィールドの操作
• ページナビゲーションや印刷を含むドキュメントレベルの操作
• コアJavaScriptからの数学処理と文字列処理機能

JavaScriptコードは、PDFビューアのセキュリティサンドボックス内で同期的に実行されます。このサンドボックスは、悪意のある操作を防ぐためにファイルシステムやネットワークリソースへのアクセスを制限します。PDFプロセッサによってJavaScriptサポートのレベルが異なる可能性があるため、開発者はターゲットとなる表示アプリケーション全体でJavaScript actionをテストする必要があります。

• Action – ユーザーインタラクションやドキュメントイベントなどのトリガーに応答してPDFプロセッサが実行する操作
• Form field – ユーザー入力を収集し、JavaScript actionをトリガーできる、PDFドキュメント内のインタラクティブ要素
• Trigger – ページ開封やボタンクリックなど、アクションの実行を引き起こすイベントまたはユーザーインタラクション
• Document object model – JavaScript actionがPDFドキュメント要素にアクセスし操作するために使用するプログラミングインターフェース
• Annotation – JavaScript actionを含むアクションを関連付けることができる、PDF内のマークアップまたはインタラクティブ要素