ドキュメント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を設定します。
-
を開き、[コンテンツとデータ]を展開し、[ドキュメントとメディア]に進みます。
-
目的のファイルのアップロードまたは編集を開始します。
-
フレンドリーURL フィールドを編集する。
各URLの値は、サイトごとに一意である必要があります。 値がすでに使用されている場合、Liferayは自動的にURLの末尾に数値を追加することで競合を解決します(例:
my-file
、my-file-1
、my-file-2
)。 -
[公開] をクリックします。
一旦保存されると、指定されたURL(例えば、http://[server-address]/documents/d/[site-friendly-url]/[file-friendly-URL]
)でファイルにアクセスすることができます。
フレンドリURLの履歴
ファイルのフレンドリURLを変更した場合、Liferayは以前のURLの履歴を自動的に保持します。 この保存されたURLを引き続き使用することで、ファイルの最新バージョンにアクセスできます。 必要であれば、古いフレンドリURLのエントリーを削除できます。
フレンドリURLの履歴に保存されている間は、古いファイルのURLは同じサイト内の他のファイルには使用できません。 別のファイルでURLを再利用するには、まずそのファイルのフレンドリURLの履歴から対象のURLを削除する必要があります。
以下の手順で、ファイルの保持URLを表示・管理します。
-
を開き、[コンテンツとデータ]を展開し、[ドキュメントとメディア]に進みます。
-
目的のファイルの Actions ボタン( )をクリックし、 Edit を選択します。
-
Friendly URLフィールドの History ボタン( )をクリックします。
-
復元 ボタン( )をクリックして、現在のフレンドリーURLを選択したURLに置き換えます。
-
選択したURLをファイルの履歴から削除するには、 Forget 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をコピーします。