PDActionGoToR

PDActionGoToRは、Apache PDFBox Java APIのクラスで、PDFドキュメント内の「リモートへ移動」アクションを表現します。このアクションタイプにより、PDFファイルは外部の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の処理ワークフロー内でリモートドキュメントのナビゲーションアクションをプログラム的に作成および操作するためのメソッドを提供します。

PDActionGoToRは、Apache PDFBoxにおける具象実装クラスで、PDFアクションタイプ「GoToR」(Go-To Remote)をカプセル化します。同一のPDFドキュメント内の目的地へナビゲートするPDActionGoToとは異なり、PDActionGoToRは別のPDFファイル内の場所へのナビゲーションを特に処理します。このクラスはPDActionベースクラスを拡張し、ターゲットファイル仕様、目的地ページ、および新しいウィンドウでリモートドキュメントを開くかどうかを設定・取得するメソッドを提供します。ユーザーの操作(リンクやボタンのクリックなど)によってトリガーされると、このアクションは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ワークフローや相互接続されたナビゲーション構造を維持するドキュメントコレクションを作成するために不可欠です。

PDF生成・操作を行う開発者にとって、PDActionGoToRは洗練されたドキュメントリンクシステムの構築を可能にします。これは、ドキュメントセット、法的書類システム、または複数のPDFドキュメントが相互に参照する必要があるアプリケーションを構築する際に特に価値があります。このクラスを理解することで、開発者はファイル全体を埋め込むことなくドキュメント間のナビゲーションをプログラム的に作成でき、ファイルサイズを削減し、モジュラーなドキュメントアーキテクチャを実現できます。リモートの目的地を指定できる機能は、バージョン管理やセキュリティ目的でドキュメントを分離しておく必要がある一方で、シームレスなユーザーナビゲーション体験を提供する必要があるエンタープライズドキュメント管理システムにとって重要です。

PDActionGoToRは、PDFのアクション辞書に3つの主要な情報を格納することで機能します：ファイル仕様(ターゲットPDFを識別)、目的地(そのPDF内のどこへナビゲートするかを指定)、およびビューアの動作を制御するオプションパラメータです。開発者はクラスをインスタンス化し、setFile()のようなメソッドを使用してPDFileSpecificationオブジェクトでターゲットPDFを指定し、setDestination()でターゲット位置(ページ番号、名前付き目的地、または明示的な目的地)を定義し、setOpenInNewWindow()でリンクされたドキュメントを新しいウィンドウで開くか現在のビューを置き換えるかを制御します。PDFBoxライブラリは、この情報を ( 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ビューアはこれらのプロパティを読み取り、ドキュメント間のナビゲーションを実行します。このクラスはPDAnnotationLinkや他のインタラクティブなPDF要素と統合され、ドキュメント境界を越えた完全なナビゲーションワークフローを作成します。

• PDAction – Apache PDFBoxにおけるすべてのPDFアクションタイプのベースクラス
• PDActionGoTo – 同一PDFドキュメント内のナビゲーション用アクションクラス
• PDFileSpecification – PDFドキュメント内のファイル参照を表現するクラス
• PDAnnotationLink – アクションをトリガーするクリック可能なリンクを作成するための注釈クラス
• PDDestination – PDFドキュメント内のターゲット位置を表現するインターフェース