バッチ処理対応のパブリッシングを理解する
Liferay DXP 2026.Q1+
Live への公開では、 Liferay Archive (LAR) ファイル のインポートと同じインポート パスが使用され、遅延参照が可能になります。 Liferay DXP 2026.Q1 以降では、公開プロセスは バッチフレームワークによって処理されるエンティティ間の参照を記録しますが、それらを解決しません。
以前のリリースでは、参照されたコンテンツがLiveに配信される方法は異なっていました。 Liferay DXP 2026.Q1 およびそれ以前のバージョンにおける参照コンテンツを参照してください。
参照コンテンツの公開
バッチ処理に対応したエンティティの場合、公開プロセスに明示的に含まれたコンテンツのみがLiveに公開されます。
バッチ処理でサポートされるエンティティは、参照するコンテンツを持たずに本番環境に到達し、そのコンテンツが本番環境に到達するまで、これらの参照は解決されないままになります。 親ページ、ウィジェットに表示されるコンテンツ、フラグメントに表示されるコンテンツについても同様です。 公開プロセスにおいて、参照するコンテンツを明示的に選択する必要があります。 ステージングでのデータとコンテンツタイプの管理 を参照して、 詳細設定 タブでコンテンツタイプとその参照コンテンツを選択してください。 公開設定を確認し、本番環境に表示させたい参照エンティティをすべて含めてください。
必要な参照コンテンツのみを含めてください。 既にLiveに掲載されているコンテンツを再掲載することは不要であり、公開速度を低下させる可能性があります。
公開プロセスでは、参照方向ごとに異なる処理が行われます。
| 基準方向 | 出版行動 |
|---|---|
| バッチ処理対応エンティティから任意のエンティティへ | 参照されたコンテンツは、公開プロセスで選択した場合にのみ公開されます。 |
| バッチフレームワークが処理しないエンティティから、バッチでサポートされているエンティティへ | 参照されたコンテンツは、エンティティとともに自動的に公開されます。 |
遅延参照を受け取るエンティティ
バッチ処理をサポートするエンティティは、参照するコンテンツの内容に関わらず、参照先のコンテンツを本番環境に自動的に転送することはありません。 これには、他のエンティティへの参照、親ページ、ウィジェットに表示されるコンテンツ、およびフラグメントに表示されるコンテンツが含まれます。 公開プロセスにおいて、そのコンテンツを選択する必要があります。 バッチフレームワークが処理しないエンティティであっても、参照先のバッチ対応エンティティを伴って存在し続ける。
バッチフレームワークが処理するエンティティの一覧については、 バッチでサポートされるエンティティタイプ を参照してください。
未解決の参照
参照先が存在しない場合、公開プロセスはエラーになる代わりに、その参照先のプレースホルダーを作成します。 プレースホルダーはライブ環境に存在しますが、参照されるコンテンツが公開されるまではコンテンツは保持されません。 各エンティティタイプが生成するプレースホルダーについては、 インポートにおける参照の欠落の処理 を参照してください。
参照が解決されない場合でも、公開プロセスは正常に完了することがあり、その結果、ライブ環境にはコンテンツのないプレースホルダーが残ります。 すべてのコンテンツをインポートした後、Liveを確認して、参照されているコンテンツが存在することを確認する必要があります。
Liferay DXP 2026.Q1以前のバージョンで参照されているコンテンツ
Liferay DXP 2026.Q1 およびそれ以前のバージョン
Liferay DXP 2026.Q1より前は、公開プロセスによって参照コンテンツがステージングフレームワークを通じて自動的に収集されていたため、エンティティが参照するコンテンツはそのエンティティとともに本番環境に反映されていました。 以前のリリースからアップグレードする場合、公開プロセスに含まれるコンテンツが少なくなっているため、ライブ環境に表示させたい参照コンテンツを選択してください。
バッチ処理をサポートするエンティティは代わりに遅延参照を使用し、そのようなエンティティは参照先のコンテンツをLiveに持ち込みません。 ページは一括公開に対応しているため、親ページを選択しない限り公開されず、親ページが見つからない場合はライブサイトでプレースホルダーとして表示されます。
Liferay DXP 2026.Q1 以前のバージョンには、参照コンテンツのデフォルトを設定するステージング設定が 2 つありました。「デフォルトで親ページを公開」と「デフォルトで表示コンテンツを公開」ですが、Liferay DXP 2026.Q2 以降では両方とも削除されています。 各設定の機能については Liferay DXP 2026.Q1 およびそれ以前のバージョンでの公開 を、削除されたエントリについては Liferay DXP 2026.Q2 の互換性のない変更 を参照してください。