ドキュメントURLの設定
Liferay 7.4 U27以降/GA27以降で利用可能
ファイルがアップロードされると、LiferayはそのファイルにアクセスするためのフレンドリーなURLを自動的に生成します。 このURLは次のような構造になっています。 [server-address]/documents/d/[site's friendly url]/[file-friendly-URL]
. アップロード時に指定しない限り、LiferayはフレンドリーURLにファイル名を使用しますが、この値はいつでも変更することができます。 一度設定すると、そのフレンドリーなURLで最新版のファイルにアクセスできるようになります。
7.4 U26/GA26 以前のバージョンでは、Liferay は次の構造でファイル URL を生成します: [server-address]/documents/[site-id]/[folder-id]/[file-name]/[UUID]
. U27+/GA27+にアップデートする場合、既存のファイルはこのパターンに基づいて古いURLを使い続けます。 しかし、ユーザーが既存のファイルを更新した場合、LiferayはそのURLを新しい構造を使用するように変換します。 アップデートされるまでは、以前のURLでファイルにアクセスすることができます。
ドキュメントのフレンドリーなURLの設定
ファイルのフレンドリーURLは、 ファイルアップロード時 またはファイル編集時に手動で設定することができます。
複数のファイルをアップロードする場合、各ファイルのフレンドリーURLはファイル名を用いて自動的に生成されます。
以下の手順で、ファイルのフレンドリーURLを設定します。
サイトメニュー(
) を開き、 コンテンツ & データ を展開し、 ドキュメントとメディア へと進みます。
ファイルのアップロードまたは編集を開始します。
Friendly URL フィールドを編集します。
各URLの値は、サイトごとにユニークである必要があります。 値がすでに使用されている場合、LiferayはURLの末尾に数値を追加することで自動的に競合を解決します(例:
my-file
,my-file-1
,my-file-2
)。[Publish] をクリックします。
一度保存すると、指定されたURLでファイルにアクセスできます(例: http://[server-address]/documents/d/[site-friendly-url]/[file-friendly-URL]
)。
フレンドリーなURLの履歴
ファイルのフレンドリーURLを変更した場合、Liferayは自動的に以前のURLの履歴を保持します。 これらの保存されたURLを使用して、引き続き最新バージョンのファイルにアクセスすることができます。 必要であれば、古いフレンドリーURLのエントリーを削除することができます。
フレンドリーURL履歴に保存されている間は、古いファイルのURLは同じサイト内の他のファイルには使用できません。 別のファイルで再利用する場合は、まずそのファイルのフレンドリーURLの履歴から削除する必要があります。
以下の手順で、ファイルの保持URLを表示・管理します。
サイトメニュー(
) を開き、 コンテンツ & データ を展開し、 ドキュメントとメディア へと進みます。
目的のファイルの アクション ボタン (
) をクリックし、 編集 を選択します。
フレンドリーURL欄の「履歴」 ボタン(
)をクリックします。
復元 ボタン (
) をクリックすると、現在のフレンドリー URL が選択した URL に置き換えられます。
URLを忘れる ボタン(
)をクリックすると、選択した URL をファイルの履歴から削除します。 一度削除されると、そのURLを使ってファイルにアクセスすることはできなくなります。
フレンドリーURL履歴の変更内容は、自動的に保存されます。
Liferay 7.4 U34/GA34から、表示ページのテンプレートフレームワークは、各ファイルのフレンドリーURL履歴を考慮するようになりました。 つまり、ファイルのフレンドリーURLの履歴に残っていれば、ユーザーは古いフレンドリーURLを使って、ファイルの表示ページにアクセスし続けることができます。 ファイルのフレンドリーURL履歴にあるすべてのURLは、ファイルの現在のURLに自動的にリダイレクトされます。
ファイルが表示ページのテンプレートと同じサイトにある場合、表示ページのURLにファイルのフレンドリーURLが付加されます(すなわち、display-page-url/file-friendly-url
です)。 ただし、ファイルがテンプレートとは異なるサイトやアセットライブラリにある場合、URLパターンにはファイルのサイトやアセットライブラリのフレンドリーURL(すなわち、display-page-url/site-friendly-url/document-friendly-url
)も含まれます。 これは、URLの重複を避けるためです。
ドキュメントバージョンURL
すべてのファイルフレンドリーなURLは、ファイルの最新バージョンにつながります。 以前のバージョンのURLにアクセスしたい場合は、ファイルのバージョン履歴に移動し、目的のバージョンの ダウンロード の URL をコピーします。