ドキュメントとメディアのプレビューの設定
Liferay 7.4 U84+/GA84+
デフォルトでは、Liferay は PDFBox を使用して、ドキュメント ライブラリに追加されたファイルのプレビューを生成します。 これは、PDFBoxがDXPに同梱できる唯一の100%Javaベースのツールであるためです。
しかし、PDFBoxがサポートするファイル形式は限られているため、Liferayは追加のファイル形式をサポートするためにサードパーティサービスとの連携機能も提供しています。 これらのサービスを利用することで、より多くのファイルについて、より迅速に高品質なファイルプレビューを生成できます。
サードパーティ製のサービスを使用してプレビューを生成するには、まずLiferayインスタンスを実行しているサーバーにそれらのサービスをインストールする必要があります。
Liferayは現在、以下のサービスとの連携をサポートしています。
-
LibreOffice または OpenOffice: これらのプログラムは、サーバーモードで使用して、サポートされているファイル形式 (
.docx、.odt、.ppt、.odp ) のサムネイルとプレビューを生成できます。など)。 これらのツールを使えば、文書を変換してブラウザで表示することもできます。 Apache OpenOfficeはLiferay DXP 2026.Q3以降非推奨となり、LibreOfficeが代替としてサポートされています。 詳細については、 LibreOffice / OpenOffice 統合の有効化 を参照してください。 -
ImageMagick ( Ghostscriptも必要) : これらのプログラムは、画像ファイルの高速で高品質なプレビューと変換を提供します。 詳細については、 ImageMagick と Ghostscript の有効化 を参照してください。
-
FFmpeg: このプログラムは、音声ファイルと動画ファイルをサポートします。 ファイルプレビューを生成するだけでなく、ブラウザに搭載されているHTML5プレーヤーでマルチメディアを再生することもできます。 詳細については、 オーディオおよびビデオのプレビューで FFmpeg を有効にする を参照してください。
注記Liferay 7.3.x およびそれ以前のバージョンでは、オーディオおよびビデオのプレビューを生成するために Xuggler を使用します。 詳細については、 Xuggler の有効化 を参照してください。
これらのサービスをインストールして設定することで、ドキュメントとメディアは、ほとんどのファイルタイプのアプリ内プレビューを提供できるようになります。
ImageMagickでサポートされるメディアタイプの構成
ImageMagickをインストールしている場合、Adaptive Mediaはそれを使用して、ドキュメントライブラリに保存されている画像の代替解像度を生成できます。 ImageMagick はデフォルトでは avif、 gif、 heic、 tiff、および webp ファイルをサポートしていますが、必要に応じて追加のメディア タイプを追加できます。 詳細については、 アダプティブメディア構成リファレンス を参照してください。
プレビューとサムネイルを手動で生成する
サードパーティサービスを有効にすると、Liferayは自動的にそれらのサービスを使用して、サポートされているメディアタイプのプレビューとサムネイルを生成します。 ただし、これらのサービスを有効にする前にアセットをアップロードしている場合は、サムネイルとプレビューを手動で生成する必要があります。
画像ファイル用にそれらを生成するには、Adaptive Mediaを使用できます。 詳細については、 画像解像度の管理 を参照してください。
音声ファイル、動画ファイル、PDFファイル、OpenOfficeファイルについては、サーバー管理アプリケーションを使用してプレビューとサムネイルを再生成できます。
-
グローバルメニュー (
) を開き、 コントロールパネル → サーバー管理 に移動します。 -
リソース タブに移動します。
-
再生オプションで、目的のメディアタイプに対して 実行 をクリックします。

これにより、文書に必要な画像が生成され始めます。 この処理を実行しても、既存のプレビューやサムネイルには影響しません。 すべてのプレビューとサムネイルを再生成する場合は、まずこのクリーンアップアクションを実行してください: ドキュメントとメディアのプレビューとサムネイル ファイルをリセットします。

この処理は、画像ファイルのAdaptive Mediaプレビューおよびサムネイルには影響しません。 これらを管理するには、 アダプティブメディアを使用します。