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

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

Liferay 2026.Q1+

Liferay Archive（LAR）ファイルを使用すると、ページ、ウィジェット、またはインスタンス全体のデータ（ロールや、Liferay DXP 2026.Q3以降ではユーザーグループなど）を含め、Liferay環境間でデータを移行することができます。

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

ヒント

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

LARファイルの使用方法

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

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

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

重要

LARのエクスポートはバックアップ手段ではなく、環境間のデータ移行を目的としています。 Liferay インストールのバックアップ方法については、 Liferay Portal インストールのバックアップを参照してください。

データのエクスポート

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

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

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

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

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

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

注記

Liferay DXP 2026.Q1 以降、ナビゲーションメニューがサイトレベルのエクスポートとインポートに含まれます。

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

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

エクスポートの設定

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

これによりエクスポートテンプレートが開きます。 LPD-57655 機能フラグが有効になっている場合、新規をクリックすると、代わりに単一のフォームが開きます。 LPD-57655 を有効にしたエクスポートの設定を参照してください。
ページ および コンテンツ の下でエクスポートする内容を選択して、エクスポート処理を設定します。

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

警告

ページテンプレートをエクスポートする場合、テンプレートを使用しているページも含まれるため、エクスポート時間が長くなる可能性があります。エクスポート時間を短縮するには、「コンテンツ」→「ページ」の下にある「ページテンプレート」のチェックを外してください。
「コンテンツ」で、選択したアプリケーションのすべてのデータをエクスポートするか、日付または時刻で対象アプリケーションのデータをフィルタリングするかを設定します。
「アクセス許可」で、エクスポート対象に該当するすべてのアプリケーションのアクセス許可を含めるかどうかを決定します。
エクスポートを開始するには、 エクスポート をクリックしてください。
完了したら、エクスポートプロセスの一覧にある ダウンロード () をクリックして、生成された LAR ファイルをダウンロードします。

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

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

重要

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

LPD-57655を有効にしたエクスポートの設定

リリース機能

このフローには、デフォルトでは無効になっている LPD-57655 機能フラグが必要です。有効化すると、エクスポートページで新規をクリックすると、エクスポートの詳細とデータの選択という 2 つのセクションがある単一のフォームが開きます。

データ選択では、各エンティティタイプはカードであり、カードにはアイテム数と選択されたデータが表示されます。

エクスポートページ (サイトレベルまたはインスタンスレベル) で、新規をクリックして、新しいエクスポートプロセスを作成します。
「エクスポートの詳細」に、エクスポートするファイルの名前を入力します。
「データ選択」で、アクセス許可と削除オプションを設定します。

エクスポート権限: エクスポートされたエントリに割り当てられた権限を含めるには、このボックスをオンにします。

個別の削除をエクスポート: エクスポートするコンテンツで行われた削除をエクスポートするには、このボックスをオンにします。このボックスは、エクスポートする削除項目がある場合にのみ表示されます。
でコンテンツをフィルタリングするには、すべてのデータを含めるか、日付でフィルタリングするかを選択します。

「すべて表示」を選択するとすべてのデータを含めることができ、「日付範囲」を選択すると「開始日」と「終了日」の間の期間に限定してエクスポートでき、「最終更新日」を選択すると、直近の期間内に更新されたコンテンツに限定してエクスポートできます。
エクスポートするエンティティタイプを選択してください。

フォームを開くとすべてのエンティティタイプが選択されているため、除外したいデータを選択解除する必要があります。このフォームとエクスポートテンプレートの両方で、静的ページとユーティリティページが別々の最上位エントリとしてリストされています。

すべてのページではなく特定のページをエクスポートするには、 ページの選択 をクリックして、 エクスポートするページ モーダルを開き、ページツリーからページを選択します。
エクスポートを開始するには、 エクスポート をクリックしてください。
完了したら、エクスポートプロセスの一覧にある ダウンロード () をクリックして、生成された LAR ファイルをダウンロードします。

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

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

目的のスコープ (サイトレベルまたはインスタンスレベル) の エクスポート ページに移動します。
ページ上部の オプション () をクリックし、 テンプレートのエクスポート をクリックします。
新規をクリックしてください。
エクスポートテンプレートに名前を付け、設定します。
をクリックして保存します。

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

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

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

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

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

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

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

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

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

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

LARファイルのインポート時に報告された各エラーに関する詳細情報を表示するには、エントリをクリックしてください。

注記

レポートエントリの表示 および レポートエントリのエクスポート は、ステータスが成功していない完了したインポートプロセス (キャンセルされたプロセス、失敗またはエラーで完了したプロセスを含む) に表示されます。 LPD-57655機能フラグが有効になっている場合、インポートプロセスリストには レポートエントリの表示 のみが表示され、これは失敗したプロセスまたはエラーで完了したプロセスにのみ適用されます。

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

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

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

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

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

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

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

LARインポートの設定

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

LPD-57655機能フラグが有効になっている場合、新規をクリックすると、代わりに3ステップのウィザードが開きます。詳細については、 LPD-57655 を有効にしたインポートの設定を参照してください。
目的のLARファイルを選択し、 続行をクリックします。
（サイトレベルのみ）[ページ] で、 公開ページ または 非公開ページ を選択して、インポートするページの種類を設定します。

対象サイトでプライベートページが有効になっている場合に、これらのオプションが表示されます。
インポートしたくないデータが含まれているアプリケーションは、選択を解除してください。
「削除」セクションで、インポートに含まれるアプリケーションの個々の削除を複製するか無視するかを設定します。
「権限」で、対象サイトまたはインスタンス内の対象エンティティに同じ権限を割り当てるかどうかを設定します。
(サイトレベルのみ) [データの更新] で、インポート戦略を選択します: ミラー、 上書きによるミラー、または 新規としてコピー。

新規としてコピー は非推奨です。これは、 feature.flag.LPD-44307 feature flag が有効になっているときに表示されます。これはデフォルトです。

注記

バッチフレームワークを使用してエンティティをインポートできるのは「Mirror」インポート戦略の場合のみであるため、このオプションが影響するのは他の種類のエンティティのみです。インポートに両方が含まれている場合、 ミラーを上書き で選択したときとインポートを完了したときに警告メッセージが表示されます。
「コンテンツの著作権」で、インポートしたコンテンツの元の著作権を保持するか、ユーザーを著作権者としてコンテンツをインポートするかを選択します。
インポートを開始するには、 インポート をクリックしてください。

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

LPD-57655を有効にしたインポートの設定

リリース機能

このフローには、デフォルトでは無効になっている LPD-57655 機能フラグが必要です。有効化すると、インポートページで新規をクリックすると、セットアップ、データ選択、設定の 3 つのステップのウィザードが開きます。

重要

このフローでは、インポートされたページはエクスポート時の形式を保持します。 LAR ファイルの manifest.xml にある private-layout プロパティは、各ページが公開か非公開かを決定しますが、ウィザードではその選択肢は提供されません。デフォルトのフローでは、 ページ の下にそれが表示されます。

進行状況バーが3つのステップを追跡し、データ選択画面が開くと、アップロードされたLARファイルのエクスポート日時、作成者、サイズを示すファイル概要が表示されます。

インポートページ (サイトレベルまたはインスタンスレベル) で、新規をクリックして、新しいインポートプロセスを作成します。
セットアップ手順で、インポートプロセスの名前を入力し、LARファイルをアップロードします。

名前フィールドが空の状態でファイルをアップロードすると、フィールドにはファイル名から .lar 拡張子を除いたものが使用されます。

デフォルトのアップロードファイルサイズは 104857600 バイト (100 MB) ですが、 コントロールパネル → システム設定 → インフラストラクチャ → アップロードサーブレットリクエスト で全体の最大アップロードリクエストサイズの設定を構成できます。
データ選択ステップで、インポートするデータを選択します。

インポート権限: エクスポートされたエントリに割り当てられた権限をインポートするには、このボックスをオンにします。

選択した削除を複製する: ターゲットサイトのコンテンツタイプに対して実行された削除操作を複製するには、このボックスをオンにします。このボックスは、LARファイルに削除が含まれている場合にのみ表示されます。

設定画面で、著者情報と更新オプションを設定します。

コンテンツの著作権:

オプション	効果
オリジナル作者を使用する (デフォルト)	元の作者を保持し、元の作者が見つからない場合は現在のユーザーを使用します。
現在のユーザーを著者として使用する	現在のユーザーをインポートされたすべてのコンテンツの作成者にする

データ更新:

オプション	効果
ミラー (デフォルト)	最初のインポート時にコンテンツを新規作成し、ソースへの参照を保持するため、同じソースからのその後のインポートではエントリが新規作成されるのではなく更新されます。
上書きによるミラーリング	ミラーと同じですが、同じ名前のドキュメントまたは画像が上書きされます。

重要

インスタンスのインポートでは、 ミラー のみを提供します。バッチフレームワークを使用するエンティティは、常に ミラー と共にインポートされます。このフローでは 新規としてコピーは提供されませんが、これはデフォルトのフローで引き続き利用可能です。

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

処理が完了すると、選択したデータが対象のサイトまたはインスタンスにインポートされます。

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

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

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