コンテンツを新たな環境に展開する
Liferay DXP 2026.Q1+
Liferay Archive (LAR) ファイル を使用すると、Liferay 環境間でコンテンツ、データ構造、さらにはサイト全体を転送できます。 以前は、エクスポートは常に ステージングフレームワークを介してエンティティを処理していました。このフレームワークは内部的に XML 構造でデータを処理します。
Liferay DXP 2026.Q1 以降、Liferay の多くのエンティティは、 バッチフレームワーク を介して内部的に JSON として処理されます。 これらのエントリは、環境間の一意の識別子として外部参照コードを使用しており、より柔軟で堅牢です。
バッチ対応エンティティは、コンテンツへの遅延参照、インスタンスレベルのLARエクスポート/インポート、インポートエラーレポートの改善など、LARエクスポート/インポートにいくつかの新機能をもたらします。
この柔軟性の向上により、LARエクスポートとインポートは、環境間でコンテンツを促進および複製するための信頼できる方法としてさらに強化されます。 ただし、一部の組織はまだバッチフレームワークを使用していないため、これらの機能はサポートされていません。 詳細については、 サポートされているエンティティタイプ を参照してください。
バッチをサポートするエンティティは常に ミラーを使用します。インスタンスのインポートも同様です。 上書き機能付きミラー は、サイト、アセットライブラリ、ウィジェットのインポートに使用できます。 新規としてコピー は非推奨です。
遅延参照
バッチ処理に対応したエントリは、参照コンテンツをインポートせずに別の環境にインポートできます。 含まれている「遅延参照」は、参照先のコンテンツもインポートされるまで表示されません。
遅延参照を使用すると、参照先のコンテンツの参照漏れエラーを心配することなく、より柔軟にコンテンツを宣伝できます。 つまり、バッチフレームワークを使用している限り、そのコンテンツの任意のサブセットを任意の順序でインポートできるということです。
バッチ処理をサポートするエンティティは、参照するコンテンツの内容に関わらず、参照先のコンテンツを本番環境に自動的に転送することはありません。 これには、他のエンティティへの参照、親ページ、ウィジェットに表示されるコンテンツ、およびフラグメントに表示されるコンテンツが含まれます。 公開プロセスにおいて、そのコンテンツを選択する必要があります。 バッチフレームワークが処理しないエンティティであっても、参照先のバッチ対応エンティティを伴って存在し続ける。
バッチ処理に対応したエンティティは遅延参照を使用するため、参照されているコンテンツをLARエクスポートに自動的に含めません。 エクスポートするデータには、永続的に保存したい参照コンテンツも必ず含まれていることを確認してください。
Liferay Staging を介して本番環境に公開する場合も、同じインポートパスを使用します。 これは、バッチ処理をサポートするエンティティは、参照するコンテンツを自動的にLiveに転送しないことを意味します。 詳細については、 バッチサポートによるパブリッシングの理解 を参照してください。
インスタンスレベルのコンテンツ
オブジェクト定義や、サイトレベルのコンテンツと同様の機能を持つロールなど、インスタンスレベルのコンテンツをエクスポートすることができます。 インスタンスレベルのエクスポートが可能なすべてのエンティティは、バッチフレームワークを使用します。
LARエクスポートの範囲（サイトまたはインスタンス）によって、インポート範囲も決まります。 詳細については、 データのエクスポート を参照してください。
インポートエラー報告
遅延参照のため、LAR インポートは特定のコンテンツに関連するエラーがあっても完了できます。 インポートページの レポートエントリの表示 をクリックすると、インポートプロセスの特定のエラーの詳細を表示できます。
詳細については、 LAR ファイルを使用したデータのインポート を参照してください。
バッチ処理でサポートされるエンティティタイプ
これらのエンティティは、バッジにそれ以降のバージョンが記載されている場合を除き、Liferay DXP 2026.Q1 以降、LAR エクスポートおよびインポートにバッチ フレームワークを使用します。
| エンティティ | インスタンスレベルまたはサイトレベル |
|---|---|
| アカウント | 実例 |
| アカウントグループ | 実例 |
| カテゴリー | サイト |
| Liferay DXP 2026.Q3+ 国 | 実例 |
| オブジェクト定義 | 実例 |
| オブジェクトエントリ | インスタンスとサイト |
| 組織 | 実例 |
| ページとページテンプレート | サイト |
| 選択リスト | 実例 |
| 役割 | 実例 |
| タグ | サイト |
| Liferay DXP 2026.Q3+ ユーザーグループ | 実例 |
| 語彙 | サイト |
国のエクスポートにはその国の地域情報も含まれ、ユーザーグループのエクスポートにはそのユーザーグループの役割割り当て情報も含まれる。 ここでは地域は選択可能なエンティティタイプではないため、国をエクスポートすることで地域を移動できます。
今後のアップデートでは、より多くのエンティティタイプに対応したバッチフレームワークのサポートが追加される可能性があります。
出版物 は、LAR エクスポートまたはインポートではサポートされていません。 今後のアップデートでのサポート予定はありません。
ページ管理APIを使用したページのプロモーション
Liferay DXP 2026.Q3+ リリース機能
ページ管理APIを通じてページを宣伝することもできます。 内部IDではなく外部参照コードによってエンティティを識別するため、すべてのターゲット環境で同じリクエストボディが解決されます。 ページ、その構成要素、およびそれらが参照するエンティティには、いくつかの例外を除き、これらのコードが付与されます。標準のフラグメントはフラグメントキーで参照され、ウィジェットページレイアウトテンプレートはテンプレートIDで参照され、ウィジェットインスタンスはウィジェット名とインスタンスIDで参照されます。
APIを有効にする
直接 API リクエストを受け取る各インスタンスで、 ページ管理 API (LPD-35443) を有効にします。 これらのエンドポイントへのすべてのリクエストは、このフラグをチェックします。
他の2つのフラグは、特定の操作にのみ適用されます。
| 機能フラグ | 必要 |
|---|---|
| プライベートページ（LPD-38869） | プライベートページの一覧表示、作成、または変更。 これらのリクエストはデフォルトで公開ページを対象とするため、 privateLayout=true をこれらのリクエストとともに送信してください。 外部参照コードによるページの読み取りまたは削除では、 privateLayout パラメータは不要です。 |
| ウィジェットページ（LPD-76864） | ウィジェットページまたはウィジェットページテンプレートを作成する。 既存のウィジェットページの読み込みと更新は、これなしでも動作します。 |
これらは、 非推奨 タブの インスタンス設定 → 機能フラグ にあります。 これらはアップグレードされたインストールでは有効になり、新規インストールおよびインスタンスでは無効になります。
読書と執筆に関するサイトページ
ヘッドレス管理サイトアプリケーション (/o/headless-admin-site/v1.0) では、サイトページは /sites/{siteExternalReferenceCode}/site-pages エンドポイントにあります。 /sites/{siteExternalReferenceCode}/site-pages/{sitePageExternalReferenceCode} への PUT は、外部参照コードを持つページが存在しない場合はページを作成し、存在する場合はページを更新します。 ベース URL と認証については、 サイト API の基本 を参照してください。
このAPIは以下のエンティティを対象としています。
- コンテンツページ
- 表示ページテンプレートフォルダ
- 表示ページテンプレート
- マスターページ
- ページテンプレートセット
- ページテンプレート
- ユーティリティページ
すべてのリクエストで、 型 を設定し、値をページと一致させます。
タイプ | ページタイプ |
|---|---|
コンテンツページ | コンテンツページ |
埋め込みページ | 埋め込み |
ページへのリンク | このサイトのページへのリンク |
リンク先のURLページ | リンク先URL |
ページセットページ | ページセット |
タイプ のないリクエストボディはウィジェットページを作成し、明示的な WidgetPage 値でのみ実行されるウィジェットページフラグチェックをバイパスします。 ページ名とフレンドリー URL は、プレーンな文字列ではなく、ローカライズされたマップ (name_i18n および friendlyUrlPath_i18n) です。
これらのタイプは、APIが対応するその他のページタイプを網羅しています。リンク先の記事では、Liferay DXPが提供するページタイプの全一覧について解説しています。
ページ仕様
ページ仕様 は、コンテンツページのコンテンツをページエクスペリエンスとして記述します。各ページエクスペリエンスは、コンテナ、グリッド、フラグメントインスタンス、ウィジェットインスタンスなどのページ要素のツリーを保持します。 コンテンツページには必ず下書きレイアウトと公開レイアウトがあり、それぞれに独自のページ仕様があります。
ページ仕様は、単独のファイルとしてではなく、サイトページのリクエストの一部として送信してください。 コンテンツページの仕様は両方とも送信してください。ページを作成する際は一方の仕様を送信すれば、Liferay DXPがもう一方の仕様をそこから導き出しますが、既存のページを更新する場合は両方が必要です。
ページの仕様や分かりやすいURL履歴は、デフォルトでは返されません。 宣伝したいページを読んだら、 nestedFields=pageSpecifications,friendlyUrlHistory でリクエストします。 friendly-url-history サブリソースは、ページが以前の URL で蓄積したリダイレクトを一覧表示します。
nestedFields なしで読み取られたページには、ページ仕様がありません。 そのレスポンスを、まだ該当ページが存在しない環境に送信すると、空のページが作成され、成功レスポンスが返されます。
プロモーションページの公開
プロモーション対象コンテンツページが未公開の状態で届きます。 公開されている仕様は ドラフト ステータスであり、承認されるまではフレンドリーURLで404エラーが返されます。 ページを公開するには、サイトページリクエストにおいて、そのページの仕様でステータスを「承認済み」として送信してください。
page-specifications/{pageSpecificationExternalReferenceCode}/publish エンドポイントは、実装なしで API コントラクトに現れます。 空のボディで204を返し、何も公開しません。 代わりに仕様 のステータス を設定してください。
未解決の参照
参照されているエンティティを、それらを使用するページの前またはページと同時に宣伝する。
ページ仕様では、フラグメント、マスターページ、表示ページテンプレート、コレクション、または エクスペリエンスなど、ターゲット環境にまだ存在しないエンティティを参照できます。 リクエストは依然として成功します。 Liferay DXPは、参照を解決済みIDではなく外部参照コードとして保存するため、そのコードを持つエンティティが環境内に存在するとすぐにページがそのエンティティを検出します。 それまでは、そのエンティティが属する場所にエラーなく空の領域が表示されます。
機能の利用可能性
| 特徴 | ベータ版として利用可能 | リリースとして入手可能 | 一般的に入手可能 |
|---|---|---|---|
| ページ管理API | Liferay DXP 2026.Q1 (LPD-35443) | Liferay DXP 2026.Q3 (LPD-35443) | - |