Skip to main content
Interwork Corporation
IDR Solutions Product Support Portal
PDF開発用語集 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動 モードの切替 ダーク/ライト/自動

AJAX request

概要

AJAX(Asynchronous JavaScript and XML)requestは、ブラウザベースの通信方式で、Webアプリケーションがページ全体をリロードすることなくサーバーとデータ交換を行うことを可能にします。IDRのドキュメントビューア(BuildVu、JPedal、JDeli、FormVu)において、AJAX requestは、search.jsonファイルやWeb表示用に変換されたPDFドキュメントのレンダリングと操作に必要なその他のリソースを非同期で取得するために使用されます。このアプローチにより、ドキュメントコンテンツの段階的な読み込みが可能になり、Web対応フォーマットに変換された大規模または複雑なPDFファイルを閲覧する際のユーザーエクスペリエンスが向上します。

定義

AJAX requestは、JavaScriptベースのHTTP requestで、非同期に動作し、ユーザーがページを操作し続けている間にWebアプリケーションがバックグラウンドでサーバーと通信できるようにします。完了するまでユーザーインタラクションをブロックする従来の同期requestとは異なり、AJAX requestはコールバック関数またはPromiseを使用して、サーバーレスポンスが到着したときにそれを処理します。

IDRビューアの実装では、AJAX requestは具体的に以下を取得します:

  • 元のPDFから抽出された検索可能なテキストコンテンツを含むsearch.jsonファイル
  • 個別のページアセット(SVG、画像、またはその他のフォーマット変換)
  • フォントデータおよびその他のサポートリソース
  • 注釈データおよびフォームフィールド情報

AJAXメカニズムは、iframeやページ全体のナビゲーションなどの他の読み込み戦略とは異なり、どのリソースをいつ読み込むかを細かく制御できるため、遅延読み込みやオンデマンドコンテンツ取得などの最適化戦略が可能になります。

重要性

AJAX requestは、Webブラウザで高パフォーマンスなPDF表示体験を提供するために不可欠です。PDFドキュメントには数百ページ、複雑なベクターグラフィックス、埋め込みフォントが含まれている可能性があり、すべてを前もって読み込むと許容できない遅延が発生します。AJAXは以下を可能にします:

段階的レンダリング:ユーザーがスクロールまたはナビゲートするにつれてページを読み込んで表示できるため、ドキュメント全体のダウンロードを待つ必要がありません。

効率的な帯域幅使用:現在のビューに実際に必要なリソースのみがrequestされるため、データ転送とサーバー負荷が削減されます。

強化された検索機能:search.jsonファイルをビジュアルアセットとは別に読み込むことができるため、すべてのページがレンダリングされる前でもユーザーはドキュメントコンテンツを検索できます。

応答性の向上:非同期読み込みにより、リソース取得中のブラウザのロックアップが防止され、ネットワークアクティビティが多い場合でもスムーズなユーザーインターフェイスが維持されます。

IDRビューアを実装する開発者にとって、AJAX requestパターンを理解することは、読み込みの問題のトラブルシューティング、パフォーマンスの最適化、カスタムキャッシング戦略の実装に不可欠です。

仕組み

IDRビューアがブラウザで初期化されると、典型的なAJAX requestワークフローに従います:

全投稿を閲覧 gdoc_arrow_right_alt

annotations.json(注釈JSON)

概要

annotations.jsonファイルは、BuildVuがPDFからHTML5への変換時に生成するJSON形式のデータファイルで、PDF注釈に関する構造化された情報が含まれています。BuildVuが ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された注釈を含むPDF文書を処理すると、注釈データを抽出し、このJSONファイルにシリアライズして、Webベースのビューワで利用できるようにします。このファイルにより、元のPDFを必要とせずに、HTML5環境でインタラクティブな注釈機能をレンダリングおよび操作できるようになります。

定義

annotations.jsonファイルは、BuildVu変換後のPDF文書内に存在するすべての注釈を記述した、機械可読なJSON文書です。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で規定されているPDF注釈には、テキストノート、ハイライト、マークアップ、リンク、スタンプ、フォームフィールドウィジェットなどのインタラクティブ要素が含まれます。BuildVuは、これらのネイティブなPDF注釈オブジェクトを、タイプ、位置、外観、内容、動作フラグなどの注釈プロパティを保持するJSON構造に変換します。PDF固有のデータ構造を使用する元のPDF注釈ディクショナリとは異なり、annotations.jsonはWeb開発者がアクセスしやすい標準的なJSONデータ型と規則を使用します。このファイルは通常、HTML5コンテンツファイルと一緒に生成され、JavaScriptベースのPDFビューワによって読み込まれ、ブラウザ内で注釈レイヤーを再構築します。

全投稿を閲覧 gdoc_arrow_right_alt

AvifMetadata

概要

AvifMetadataは、JDeli画像ライブラリにおける特殊なメタデータクラスで、AVIF(AV1 Image File Format)画像ファイルから抽出された解析済みメタデータ情報を表します。このクラスは、AVIFファイル内に保存された画像プロパティ、技術パラメータ、および埋め込み情報への構造化されたアクセスを開発者に提供します。 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) でサポートされているように、埋め込みAVIF画像を含むPDF文書を扱う際、このクラスを使用することで、検証、最適化、およびアクセシビリティ目的で画像メタデータを抽出・処理できるようになります。

定義

AvifMetadataは、JDeli画像処理ライブラリ内のJavaクラスで、AVIF形式の画像専用にJDeliのメタデータフレームワークを拡張または実装しています。このクラスは、画像サイズ、カラープロファイル、ビット深度、圧縮パラメータ、およびAVIFファイル内に埋め込まれたEXIFまたはXMPデータなどのメタデータ情報をカプセル化します。汎用的なメタデータコンテナとは異なり、AvifMetadataはAVIF形式特有のメタデータ構造とプロパティを処理するように特化されています。AVIF形式はAV1ビデオコーデックに基づいており、ハイダイナミックレンジ(HDR)や広色域イメージングなどの高度な機能をサポートしています。このクラスは、他の形式の類似メタデータクラス(JPEGやPNGのメタデータハンドラなど)と異なり、アルファチャンネル、複数レイヤー、AV1固有のエンコーディングパラメータなど、AVIF固有の構造を理解します。

重要性

PDF生成および操作を行う開発者にとって、AvifMetadataはPDF文書内で最新の画像形式を適切に処理するための重要な機能を提供します。AVIFメタデータの理解とアクセスは、PDF作成時の画像品質維持、適切なカラーマネジメントの確保、およびファイルサイズの最適化に不可欠です。 ( Citation: N.A., (N.A.). (). 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を構築する際、メタデータ抽出は適切な代替テキストの生成や画像の適切なタグ付けを確保するために重要になります。さらに、このクラスにより、開発者は再エンコードの必要性、適用すべき色空間変換、およびAVIF画像をPDF文書に埋め込む際に重要なメタデータを保持する方法など、画像処理に関する適切な判断を下すことができます。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu

概要

BuildVuは、IDR Solutionsが開発した商用のJavaライブラリで、PDF文書をWeb表示に最適化されたHTML5およびSVG形式に変換します。このライブラリにより、開発者はプラグインやクライアント側のPDFビューアを必要とせずに、WebブラウザでPDFコンテンツをレンダリングできます。BuildVuは、フォーム、注釈、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されたタグ付きコンテンツ構造などの複雑な機能のサポートを含め、元のPDFの視覚的な忠実性を保持します。

定義

BuildVuは、PDFファイルをWeb標準形式(SVGグラフィックスを含むHTML5)に変換するサーバーサイドのPDF変換ツールです。ブラウザにPDFコンテンツを埋め込む単純なPDFビューアとは異なり、BuildVuはPDF構造をHTML、CSS、SVG、JavaScriptを含む標準的なWeb技術に完全に変換します。このライブラリは、テキスト抽出、フォント処理、ベクターグラフィックス変換、レイアウト保持を含むPDFの内部構造を処理し、レスポンシブで検索可能なWebコンテンツを生成します。BuildVuは、 ( Citation: N.A., (N.A.). (). 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 ) 標準に準拠したTagged PDFなどのアクセシビリティ機能を持つPDFを含む、さまざまなタイプのPDFを処理でき、文書構造と読み上げ順序を維持する意味的に意味のあるHTMLに変換します。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu API reference

概要

BuildVu API referenceは、PDFドキュメントをHTML5やSVGなどのWeb対応形式に変換するBuildVuライブラリを使用する開発者向けの包括的なドキュメントを提供します。このAPIは、BuildVuの変換機能へのプログラマティックなアクセスを可能にし、開発者がJavaアプリケーションやWebサービスにPDFからWebへの変換機能を統合できるようにします。このAPIは、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義された高度な機能を含む複雑なPDFドキュメントの変換をサポートし、Webブラウザでのコンテンツの正確なレンダリングを保証します。

定義

BuildVu API referenceは、BuildVuライブラリで利用可能なクラス、メソッド、インターフェース、パラメータを説明する公式技術ドキュメントです。これは、開発者が変換エンジンを初期化し、変換設定を構成し、さまざまなPDFコンテンツタイプを処理し、変換出力を処理する方法を詳述する、プログラマティックインターフェースの完全なガイドとして機能します。概念的な理解に焦点を当てたユーザーガイドやチュートリアルとは異なり、API referenceは、メソッドシグネチャ、戻り値の型、例外処理、パラメータ要件など、ライブラリの各コンポーネントに対する正確な技術仕様を提供します。リファレンスドキュメントは、コア変換機能と、ドキュメントの処理や変換中のドキュメント構造の維持などの専門的な機能の両方をカバーしています。

重要性

アプリケーションにPDF変換機能を統合する開発者にとって、BuildVu API referenceは、変換ワークフローを適切に実装および最適化する方法を理解するために不可欠です。これにより、開発者は、 ( Citation: N.A., (N.A.). (). 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 ) 標準で要求されるようなアクセシビリティ機能のサポートを含む、BuildVuの全機能セットを活用でき、変換されたWebコンテンツが元のPDFのセマンティック構造とアクセシビリティプロパティを維持することを保証します。API referenceは、開発者が問題をトラブルシューティングし、バッチ処理のパフォーマンスを最適化し、特定のプロジェクト要件を満たすように変換出力をカスタマイズするのに役立ちます。詳細なAPIドキュメントへのアクセスにより、開発時間が短縮され、本番環境での変換機能の適切な実装が保証されます。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu best practices

概要

BuildVuのベストプラクティスは、BuildVuライブラリを使用したPDFからHTML5/SVGへの変換ワークフローを最適化するための推奨技術と設定を包含したものです。これらのプラクティスは、効率的な処理を保証し、文書の忠実性を維持し、Web標準に準拠したアクセシブルな出力を生成します。これらのガイドラインに従うことで、開発者はPDF文書の構造的整合性を保持しながら最適なパフォーマンスを達成できます。特に、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているTagged PDF構造を含む複雑な文書を扱う際に有効です。

定義

BuildVuのベストプラクティスは、出力品質、パフォーマンス、アクセシビリティを最大化するPDF変換ワークフローを実装するための実践的な推奨事項です。これらのプラクティスは、入力検証、リソース管理、出力設定、アクセシビリティ最適化など、変換プロセスの複数の側面をカバーしています。一般的なPDF処理ガイドラインとは異なり、BuildVuのベストプラクティスは、HTML5/SVG変換ワークフローに特化して調整されており、フォント処理、ベクターグラフィックスの保持、レスポンシブレイアウト生成などの独自の課題に対応しています。これらのプラクティスは、バッチ処理とオンデマンド変換などの異なるユースケースを区別し、フォーム、注釈、透明度、 ( Citation: N.A., (N.A.). (). 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機能の処理に関するガイダンスを提供します。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu CLI usage

概要

BuildVu CLI(Command Line Interface)usageとは、IDR SolutionsのBuildVuコンバーターをターミナルまたはコマンドプロンプトのコマンドを通じて操作し、PDF文書をWeb対応フォーマット、特にHTML5およびSVGに変換する方法を指します。このアプローチにより、グラフィカルユーザーインターフェースを必要とせずに、バッチ処理、自動化、および大規模なワークフローへの統合が可能になります。CLIは、複雑な ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 準拠のPDF文書を、その構造とアクセシビリティ機能を保持しながら変換する際に特に有用です。

定義

BuildVu CLI usageは、BuildVu PDF to HTML5変換ライブラリのコマンドライン実装です。GUIバージョンやプログラマティックなAPI統合とは異なり、CLIを使用することで、開発者やシステム管理者は、様々なパラメータやフラグを持つテキストベースのコマンドを使用して、ターミナルから直接変換操作を実行できます。CLIは、ソースPDFファイルパス、出力ディレクトリ、変換設定、構成オプションなどの入力パラメータを受け取ります。これは、Javaコードの記述とアプリケーションへのライブラリ統合を必要とするBuildVu Java APIや、HTTPリクエストを通じて動作するWebベースのMicroserviceバージョンとは異なります。CLIは、サーバー環境、継続的インテグレーションパイプライン、自動化された文書処理ワークフローに最適な、軽量でスクリプト可能なインターフェースを提供します。

重要性

大規模なPDF文書変換に取り組む開発者にとって、BuildVu CLIは自動化と展開シナリオにおいて重要な利点を提供します。カスタムJavaアプリケーションを開発するオーバーヘッドなしに、DevOpsパイプライン、cronジョブ、バッチ処理スクリプトへのシームレスな統合を可能にします。システム管理者は、定期的な変換タスクをスケジュールし、大規模な文書リポジトリを処理し、文書管理システムの一部として変換ワークフローを実装できます。CLIアプローチは、 ( Citation: N.A., (N.A.). (). 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を、 ( Citation: , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 標準で定義された文書構造を維持しながらアクセシブルなHTML形式に変換する必要がある組織にとって特に重要です。このコマンドラインアクセスにより、開発時間が短縮され、展開が簡素化され、コードを記述することなく変換構成の迅速なプロトタイピングとテストが可能になります。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu cloud

概要

BuildVu cloudは、PDFドキュメントをHTML5またはSVG形式に変換するクラウドベースのサービスです。プラグインやクライアント側のPDFレンダリング機能を必要とせず、Webベースでの閲覧を可能にします。このサービスは、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) などの仕様に準拠したPDFファイルを処理し、最新のブラウザに最適化されたWeb標準形式に変換します。BuildVu cloudはホスティングソリューションとして動作するため、組織がPDF変換のための独自のサーバーインフラストラクチャを維持する必要がありません。

定義

BuildVu cloudは、RESTful APIを通じてPDFからHTML5/SVGへの変換を提供するSaaS(Software-as-a-Service)製品です。デスクトップ版のPDF変換ツールや自己ホスト型のサーバーソリューションとは異なり、BuildVu cloudはIDR Solutionsが管理するリモートインフラストラクチャ上ですべての処理を実行します。このサービスはAPIリクエストを介してPDFファイルを受け取り、Webアプリケーションに直接埋め込むことができる変換済みコンテンツを返します。従来のPDFビューアとの違いは、ビューアプラグインやJavaScriptライブラリを使用してPDFコンテンツをレンダリングするのではなく、ドキュメント構造全体をWeb標準に準拠したマークアップに変換する点にあります。このクラウドサービスは、自己ホスト型のBuildVuソリューションと同じ変換精度を維持しながら、スケーラビリティ、自動アップデート、運用オーバーヘッドの削減を提供します。

重要性

PDFコンテンツを表示する必要があるWebアプリケーションを構築する開発者にとって、BuildVu cloudは複雑なインフラストラクチャ要件を排除する本番環境対応のソリューションを提供します。このサービスは、 ( Citation: N.A., (N.A.). (). 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を扱う際に特に有用です。HTML5への変換時にドキュメント構造とセマンティック情報を保持できるためです。組織は、サーバーやライセンスへの設備投資の代わりに、予測可能な従量課金制の料金体系の恩恵を受けることができます。クラウドサービスは変換量の変動に応じて自動的にスケールするため、予測不可能なワークロードを持つアプリケーションに適しています。PDF処理をクラウドにオフロードすることで、開発チームは変換インフラストラクチャの維持やPDFレンダリングのエッジケースの管理ではなく、コアとなるアプリケーション機能に集中できます。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu compatibility

概要

BuildVu compatibilityとは、IDRのPDFからHTML5/SVGへの変換ライブラリであるBuildVuが、さまざまなPDF仕様や規格に準拠したPDF文書を正確に処理・変換する能力を指します。この互換性には、 ( Citation: N.A., (N.A.). (). Document management — Portable document format — Part 2: PDF 2.0 International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で定義されているものを含む、異なるPDFバージョンのサポート、および ( Citation: N.A., (N.A.). (). 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のような特殊なPDF形式のサポートが含まれます。互換性のレベルは、複雑なPDF文書を変換する際の、結果として得られるHTML5出力の品質と精度に直接影響します。

全投稿を閲覧 gdoc_arrow_right_alt

BuildVu edge cases

概要

BuildVu edge casesとは、BuildVuライブラリを使用してPDF文書をHTML5やSVGに変換する際に課題となる可能性のある、一般的でない、または複雑なPDF構造や設定を指します。これらのedge casesには、PDF仕様 ( Citation: N.A., (N.A.). (). 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レンダリング動作の限界に挑戦するコンテンツが含まれることがよくあります。多様なPDF文書において一貫性のある高品質な変換結果を達成するには、これらのedge casesを理解し、適切に処理することが不可欠です。

定義

BuildVu edge casesは、PDF文書が典型的な構造から逸脱している、または変換時に特別な処理を必要とする機能を含んでいる、幅広いシナリオを包含します。これには、破損または不正な形式の構造を持つPDF、稀なフォントエンコーディングを使用している文書、複雑な透明グループ、特殊なカラースペース、ネストされたForm XObject、または ( Citation: , (). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) で定義されている非標準のタグ階層などが含まれます。Edge casesは、技術的には有効(またはほぼ有効)なPDF構造でありながら、実際には単に一般的でないという点で、標準的な変換エラーとは異なります。また、ブレンドモードとオーバープリントシミュレーションのような複数の高度なPDF機能を予期しない方法で組み合わせた文書や、アクセシビリティ機能 ( Citation: N.A., (N.A.). (). 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 ) が非標準的な方法で実装されている文書も含まれます。仕様への明白な違反とは異なり、edge casesは通常、エラー処理ではなく特化したロジックを必要とします。

全投稿を閲覧 gdoc_arrow_right_alt