FDFAnnotation

FDFAnnotationは、Apache PDFBoxのJavaクラスで、Forms Data Format（FDF）に格納されたアノテーションを表現します。FDFは ( 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ドキュメントにインポートまたはエクスポートできるアノテーションデータをプログラムで作成、読み取り、操作できるようになります。

FDFAnnotationは、Apache PDFBoxのFDFパッケージの一部であり、Forms Data Format構造内の個々のアノテーションを表現します。PDFドキュメントに直接埋め込まれたアノテーションとは異なり、FDFAnnotationオブジェクトは、別々に送信および保存できる軽量でスタンドアロンな形式でアノテーションデータを表現します。 ( 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 ) で規定されているFDF形式は、PDFドキュメント構造全体ではなく、フォームフィールドの値、アノテーション、およびその他の増分更新のみを含みます。これにより、FDFAnnotationは、完全なPDFコンテキスト内でアノテーションを表現するPDFBoxのPDAnnotationクラスとは異なる役割を持ちます。FDFAnnotationは、外部アノテーションデータをPDFにインポートしたり、別の保存、レビューワークフロー、またはシステム間のデータ交換のためにアノテーションをエクスポートしたりするためのブリッジとして機能します。

PDFフォームや共同ドキュメントワークフローを扱う開発者にとって、FDFAnnotationはアノテーションデータをドキュメントコンテンツから分離するための重要な機能を提供します。この分離により、完全なPDFファイルを配布せずに複数のユーザーからフォーム回答を収集する、アノテーションを別々に保存するレビューと承認のワークフローを実装する、ドキュメント全体ではなく変更されたデータのみを送信することで帯域幅要件を削減するなど、効率的なシナリオが可能になります。このクラスは、複数のレビュアーからのアノテーションを集約する必要があるアプリケーション、ドキュメントコメントのバージョン管理を実装する、または外部データベースやコンテンツ管理システムとPDFアノテーション機能を統合する場合に特に価値があります。FDFAnnotationの理解は、フォームデータとアノテーションをソースPDFドキュメントとは独立して処理、保存、または送信する必要があるエンタープライズドキュメント管理ソリューションを構築する開発者にとって不可欠です。

FDFAnnotationは、アノテーションタイプ、ページ参照、位置座標、コンテンツ、外観特性など、PDFアノテーションの本質的なプロパティをFDF構造内にカプセル化することで機能します。PDFからアノテーションをエクスポートする際、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 ) 仕様に準拠した形式で各アノテーションのプロパティをキャプチャするFDFAnnotationオブジェクトを作成します。これらのオブジェクトは、簡略化されたPDF様の構文を使用するが差分情報のみを含むFDFファイルにシリアル化されます。逆に、FDFデータをインポートする際、PDFBoxはFDFファイルを解析してFDFAnnotationオブジェクトを再構築し、対応するPDAnnotationインスタンスを作成することでターゲットPDFドキュメントにマージします。このクラスは、色、不透明度、フラグ、およびテキストアノテーションのテキストコンテンツやハイライトアノテーションのマークアップポイントなどのアノテーション固有の属性などのアノテーションプロパティにアクセスして変更するメソッドを提供します。この双方向変換により、アプリケーションは、PDF仕様との完全な互換性を維持しながら、アノテーションがメインドキュメントとは別に作成、変更、または保存されるワークフローを実装できます。

• PDAnnotation – PDFドキュメントに埋め込まれたアノテーションを表現するApache PDFBoxクラス
• Forms Data Format（FDF） – PDFドキュメントとは別にフォームデータとアノテーションを表現するためのファイル形式
• XFDF – Webベースのフォームデータ交換のためのFDFのXMLベースのバリアント
• PDField – PDFドキュメント内のインタラクティブフォームフィールドを表現するApache PDFBoxクラス
• Acroform – データ交換のためにFDFと連携するPDFインタラクティブフォームアーキテクチャ