Sites
ご覧のページは、お客様の利便性のために一部機械翻訳されています。また、ドキュメントは頻繁に更新が加えられており、翻訳は未完成の部分が含まれることをご了承ください。最新情報は都度公開されておりますため、必ず英語版をご参照ください。翻訳に問題がある場合は、 こちら までご連絡ください。

LARファイルを使用したデータのエクスポート/インポート

Liferay Archive (LAR) ファイルを使って、ページやウィジェット、インスタンス全体のデータ(ロールなど)をLiferay環境間で転送することができます。

エクスポートおよびインポートツールは、サイトレベルまたはインスタンスレベルで利用可能です。 サイトまたはインスタンスのスコープで指定されたデータは、対象環境においても同じスコープを使用してインポートする必要があります。

インスタンスレベルの LAR ファイルのエクスポートとインポートには、Liferay DXP 2025.Q4 以降と、 開発者機能フラグ の有効化が必要です。 アプリケーション メニューで feature.flag.LPD-35914=true を設定すると、 エクスポートインポート オプションが有効になります。

ヒント

サイト初期化ツール を使用すると、ページとコンテンツがあらかじめ入力されたサイトを作成することもできます。 サイト初期化子は クライアント拡張機能であり、クライアント拡張機能を作成する開発者は、それらを実装するために Liferay のデータベースとシステムを理解する必要があります。

LARファイルの使用方法

LARファイルはバージョンに依存しますが、同じバージョンのLiferayインスタンスであればどれでもエクスポートおよびインポートできます。

サイトスコープのLARファイルを使用してサイトを復元することは可能ですが、LARファイルをインポートするには、まずサイトを完全に削除してから、同じ名前の新しいサイトを作成する必要があります。 これにより、LARファイルとサイトの両方に存在するコンテンツ間の潜在的なデータ競合を回避できます。

LARファイルはシステムに永続的に保存されません。 エクスポートまたはインポート処理が完了すると、Liferay は結果 (成功、キャンセル、失敗) に関係なく、30 日後に エクスポート または インポート 画面のエントリを削除します。 エクスポート処理後、LARファイルは30日間ダウンロード可能(ドキュメントとメディアライブラリに一時的に保存)となります。

重要

LARのエクスポートはバックアップソリューションではなく、環境間でデータを移行するためのものです。 Liferay インストールのバックアップ方法については、 Liferay Portal インストールのバックアップ を参照してください。

データのエクスポート

インスタンスと サイトの2つのスコープでデータをエクスポートできます。

サイトコンテンツがインスタンスレベルのデータ(グローバルカテゴリやページテンプレートなど)を参照している場合は、サイトデータをインポートする前に、そのデータを別のインスタンスレベルのLARファイルにインポートする必要があります。 インスタンス LAR でエクスポートされたデータは、同じバージョンの別の Liferay インスタンスに インスタンスレベル でのみインポートできます。

サイトレベルのデータをエクスポートする場合は、まずインスタンスレベルの依存関係を特定することから始めてください。 サイトが サイトテンプレート に基づいている場合、またはコンテンツがインスタンスレベルのデータ (グローバルカテゴリなど) を参照している場合は、インスタンスレベルでエクスポートする必要があります。

インスタンススコープの LAR ファイルをエクスポートするには、[アプリケーション] メニュー (Applications) の [ エクスポート を使用します。

インスタンスレベルのデータを取得するには、「アプリケーション」メニューの「エクスポート」メニューにアクセスしてください。

サイト LAR でエクスポートされたデータは、インスタンスレベルの依存関係が既に存在する同じバージョンの Liferay 上の別の サイト にのみインポートできます。

Liferay 2026.Q1 以降、 ナビゲーション メニュー がサイト レベルのエクスポートとインポートに含まれます。 この機能には、LPD-35914、LPD-35443、およびLPD-66179 機能フラグ が必要であり、バッチ処理を使用しますが、これはステージング環境では利用できません。 機能フラグを有効にする前に作成されたナビゲーションメニューは、エクスポートまたはインポートのオプションに表示されない場合があります。

サイトメニューの 発行エクスポート から、サイトスコープのLARファイルをエクスポートします。

サイトメニューからサイトデータのエクスポートメニューにアクセスしてください。

エクスポートの設定

  1. エクスポートページ(サイトレベル または インスタンスレベル)で、 新規 をクリックして、新しいエクスポートプロセスを作成します。

    エクスポートテンプレートが開きます。

  2. ページ および コンテンツ の下でエクスポートする内容を選択して、エクスポート処理を設定します。

    エクスポートの種類によって、選択できるデータの種類が決まります。

    サイトレベルおよびインスタンスレベルのエクスポート機能を使用すると、さまざまな種類のデータをエクスポートできます。

    警告

    ページテンプレートをエクスポートする場合、テンプレートを使用しているページも含まれるため、エクスポート時間が長くなる可能性があります。 エクスポート時間を短縮するには、「コンテンツ」→「ページ」の下にある「ページテンプレート」のチェックを外してください。

  3. 「コンテンツ」で、選択したアプリケーションのすべてのデータをエクスポートするか、日付または時刻で対象アプリケーションのデータをフィルタリングするかを設定します。

  4. 「アクセス許可」で、エクスポート対象に該当するすべてのアプリケーションのアクセス許可を含めるかどうかを決定します。

  5. [Export]をクリックし、エクスポートプロセスを開始します。

  6. 完了したら、エクスポートプロセスの一覧にある ダウンロード (Download) をクリックして、生成された LAR ファイルをダウンロードします。

エクスポート処理の一覧から、生成されたLARファイルをダウンロードしてください。

エクスポートの範囲によっては、LARファイルを別のサイトまたはインスタンスにインポートできるようになりました。

重要

生成されたLARファイルには、エクスポート設定時に選択されたすべてのデータが含まれます。 個人情報や機密情報が含まれる場合は、LARファイルが安全な場所に保管されていることを確認してください。

テンプレートのエクスポートの作成

頻繁にデータをエクスポートする場合は、エクスポート設定を保存して再利用するためのエクスポートテンプレートを作成することを検討してください。

  1. 目的のスコープ(サイトレベル または インスタンスレベル)の エクスポート ページに移動します。

  2. ページ上部の オプション (Options) をクリックし、 テンプレートのエクスポート をクリックします。

    アプリケーションバーの「アクション」ボタンをクリックし、「テンプレートのエクスポート」を選択します。

  3. [新規]をクリックします。

  4. エクスポートテンプレートに名前を付け、設定します。

  5. [Save(保存)]をクリックします。

新しいエクスポート・プロセスを作成する際に、テンプレートを選択できるようになりました。 このテンプレートは、同じ範囲でエクスポートを開始する場合にのみ使用できます。

LARファイルを使用したデータのインポート

LARファイルにオブジェクトデータが含まれている場合、ターゲットとなるLiferayインスタンスには、対応するオブジェクト定義が既に存在している必要があります。 LAR をインポートする前に、 を個別にインポートしてください。

LARファイルをインポートする際、一部のファイル名の競合は自動的に処理されます。 例えば、対象サイトと同じフレンドリーURLを持つページを含むサイトスコープのLARファイルをインポートした場合、インポートされたページはフレンドリーURLに番号を追加します(競合が解決されるまでカウントアップします)。 この同じ戦略はカテゴリ名にも適用されます。

アプリケーションによっては、自動的に解決できないその他の種類のエラーが発生しても、インポートの完了を妨げない場合があります。

エラーを含むインポートが完了したら、インポート処理の レポートエントリの表示 をクリックして、各エラーの詳細を確認してください。 検索バーを使用して、特定のエラーメッセージを検索してください。

インポートに失敗した際のエラーレポートのエントリを表示、検索、またはエクスポートできます。

または、 レポートエントリのエクスポート をクリックして、エラーの詳細をスプレッドシートとして読み取れる形式 (例: Google スプレッドシート) でエクスポートして、 .csv ファイル ( .zip アーカイブ) をダウンロードします。

エラーの詳細をCSVファイルとしてエクスポートし、スプレッドシートとして読み込むことができます。

リスト内の項目をクリックすると、エラーの完全なスタックトレースを含む詳細が表示されます( スタックトレースを表示 をクリック)。

エントリをクリックすると、LARインポートで報告された各エラーに関するすべての情報が表示されます。

インスタンスデータのインポート

依存関係を含むインスタンスレベルのLARファイルをインポートしてから、それらを参照するサイトLARファイルをインポートしてください。

アプリケーション メニュー (Applications) の インポート からインスタンス スコープの LAR ファイルをインポートします。

インスタンスレベルのデータを取り込むには、「アプリケーション」メニューの「インポート」メニューにアクセスしてください。

サイトデータのインポート

参照されているインスタンスレベルのデータのインポートが完了したら、サイトメニューから 公開インポート の順に選択して、サイトスコープの LAR ファイルをインポートします。

サイトメニューからサイトデータのインポートメニューにアクセスしてください。

LARインポートの設定

  1. インポートページ(サイトレベル または インスタンスレベル)で、 新規 をクリックして、新しいインポートプロセスを作成します。

  2. 目的のLARファイルを選択し、 続行をクリックしてください。

  3. インポートしたくないデータが含まれているアプリケーションは、選択を解除してください。

  4. 「削除」セクションで、インポートに含まれるアプリケーションの個々の削除を複製するか無視するかを設定します。

  5. 「権限」で、対象サイトまたはインスタンス内の対象エンティティに同じ権限を割り当てるかどうかを設定します。

  6. (サイトレベルのみ)「データの更新」で、 ミラー または ミラー(上書きあり) インポート戦略を選択します。

    バッチ処理でサポートされているエンティティをインポートする場合、選択内容に関わらず、常にミラーインポート戦略が使用されます。

  7. 「コンテンツの著作権」で、インポートしたコンテンツの元の著作権を保持するか、ユーザーを著作権者としてコンテンツをインポートするかを選択します。

    新しいインポート処理を開始する前に、インポートの設定を行ってください。

  8. インポートを開始するには、 インポート をクリックしてください。

完了すると、選択したアプリケーションがターゲットサイトまたはインスタンスにインポートされます。

エクスポート/インポートプロセスの設定

Liferayは、エクスポート/インポート処理の設定や、ステージング固有の機能の設定を提供します。 これらの設定は、ステージング環境とサイトテンプレートの伝播に影響します。

設定Description
すべてのアセットリンクを含めるチェックを入れると、指定された期間内のサイトからすべてのアセットリンクが含まれます。 チェックを外すと、コンテンツに関連付けられたアセットリンクのみが含まれます。
個々の削除をデフォルトで反映するこのオプションをオンにすると、コンテンツタイプに対して実行された削除操作は、デフォルトで常にターゲットサイトに複製されます。
デフォルトで権限を公開するチェックを入れると、エクスポートされたページと個々のポートレットウィンドウに割り当てられた権限がデフォルトで常に含まれます。
ファイルエントリの検証このオプションを有効にすると、テキストを含むコンテンツタイプを公開またはインポートする際に、Liferay はコンテンツ内のドキュメントへのリンクをチェックし、それらが有効なドキュメントを指していることを確認します。
Journal Feedの参照を検証するこのオプションを有効にすると、テキストを含むコンテンツタイプを公開またはインポートする際に、Liferay はコンテンツ内の Web コンテンツフィードへの参照をチェックし、それらが有効なフィードを指していることを確認します。
レイアウトの参照を検証します。このオプションを有効にすると、テキストを含むコンテンツタイプを公開またはインポートする際に、Liferay はコンテンツ内のポータルの仮想ホストへのリンクをチェックし、それらが有効な Liferay ページを指していることを確認します。 仮想ホストにLiferay以外のページがある場合は、このチェックを外してください。
欠落している参照を検証します。チェックを入れると、公開およびインポート処理中に、Liferay は不足している参照がないかチェックします。 チェックを外した場合、参照漏れの検証はスキップされます。 その結果、既存のターゲットが存在しない参照情報も、ターゲットサイトに公開またはインポートすることが可能になります。