oo

ドキュメントURLの構成

liferay 7.4 U27+/GA27+.

ファイルがアップロードされると、LiferayはそのファイルにアクセスするためのフレンドリURLを自動的に生成します。 このURLは次の構造を使用します: [server-address]/documents/d/[site's friendly url]/[file-friendly-URL]. アップロード時に指定しない限り、LiferayはフレンドリURLにファイル名を使用しますが、この値はいつでも変更することができます。 設定が完了すると、そのフレンドリーURLで最新版のファイルにアクセスできるようになります。

note

7.4 U26/GA26 以前のバージョンでは、Liferayは次の構造でファイルURLを生成します: [server-address]/documents/[site-id]/[folder-id]/[file-name]/[UUID]。 U27+/GA27+にアップデートする場合、既存のファイルはこのパターンに基づいて古いURLを引き続き使用します。 しかし、ユーザーが既存のファイルを更新した場合、Liferayは新しいストラクチャーを使用するようにそのURLを変換します。 アップデートされるまでは、以前のURLでファイルにアクセスすることができます。

ドキュメントのフレンドリURLの設定

ファイルのフレンドリーURLは、 ファイルアップロード中、またはファイルを編集するときに手動で設定できます。

note

複数のファイルをアップロードする場合、各ファイルのフレンドリーURLはファイル名を使って自動的に生成されます。

以下の手順で、ファイルのフレンドリURLを設定します。

  1. サイトメニューを開き、[コンテンツとデータ]を展開し、[ドキュメントとメディア]に進みます。

  2. 目的のファイルのアップロードまたは編集を開始します。

  3. フレンドリーURL フィールドを編集する。

    各URLの値は、サイトごとに一意である必要があります。 値がすでに使用されている場合、Liferayは自動的にURLの末尾に数値を追加することで競合を解決します(例:my-filemy-file-1my-file-2)。

    When uploading or editing a file, you can change its friendly URL.

  4. 公開] をクリックします。

一旦保存されると、指定されたURL(例えば、http://[server-address]/documents/d/[site-friendly-url]/[file-friendly-URL])でファイルにアクセスすることができます。

フレンドリURLの履歴

ファイルのフレンドリURLを変更した場合、Liferayは以前のURLの履歴を自動的に保持します。 この保存されたURLを引き続き使用することで、ファイルの最新バージョンにアクセスできます。 必要であれば、古いフレンドリURLのエントリーを削除できます。

note

フレンドリURLの履歴に保存されている間は、古いファイルのURLは同じサイト内の他のファイルには使用できません。 別のファイルでURLを再利用するには、まずそのファイルのフレンドリURLの履歴から対象のURLを削除する必要があります。

以下の手順で、ファイルの保持URLを表示・管理します。

  1. サイトメニューを開き、[コンテンツとデータ]を展開し、[ドキュメントとメディア]に進みます。

  2. 目的のファイルの Actions ボタン( Actions Button )をクリックし、 Edit を選択します。

  3. Friendly URLフィールドの History ボタン( History Button )をクリックします。

    Click the History button for the Friendly URL field.

  4. 復元 ボタン( 復元ボタン)をクリックして、現在のフレンドリーURLを選択したURLに置き換えます。

  5. 選択したURLをファイルの履歴から削除するには、 Forget URL ボタン ( Forget URL Button ) をクリックします。 削除すると、そのURLではファイルにアクセスできなくなります。

    Click the Restore or Forget URL buttons.

フレンドリURLの履歴の変更内容は、自動的に保存されます。

note

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をコピーします。

Copy the download URL for the desired version.

関連トピック