インポートにおける参照の欠落の処理
Liferay DXP 2025.Q3
コンテンツ、ページ、またはユーザー関連データ(カテゴリ、タグ、語彙、フラグメント、マスターページ、レイアウトページテンプレートコレクション、ウィジェット、親ページ、ロール、組織、アカウント、アカウントグループなど)をインポートする場合、Liferay はターゲット環境に存在しないエンティティへの参照をいくつかの方法で管理します。
- 不完全なプレースホルダーエンティティを作成します
- 参照は保持しますが、UI警告または404エラーを表示します。
- 欠落しているフィールドを無視します
- デフォルトでは、既知のフォールバック(例えば、インポートするユーザーを著者として使用するなど)が使用されます。
これらの方法は以下に説明する。
コンテンツ参照の欠落の処理
| 参照対象エンティティ | インポート動作 |
|---|---|
| カテゴリ | 不完全な ステータスにプレースホルダーカテゴリを作成します。 語彙が存在するなら、それは関連付けられている。 |
| タグ | 特別なステータスなしに自動的に作成されました。 |
| ボキャブラリ | 不完全な ステータスでプレースホルダー語彙を作成します。 |
ページ参照の欠落の処理
参照されているページ関連エンティティが見つからない場合、Liferay は参照を保持するか、 EMPTY ステータスのプレースホルダーを作成します。 ページプレースホルダーは、分類体系/ユーザープレースホルダーとは異なります。これらはユーザーによる確認を必要とする「不完全な」エンティティではなく、ページ階層とレイアウトの関係性を維持するための構造的な代替物です。
| 参照対象エンティティ | インポート動作 |
|---|---|
| フラグメント | 参照を保持し、UI上でフラグメントが存在しないことを示します。 |
| マスターページ | EMPTY ステータスのダミーマスターページを作成します。 |
| ウィジェット | 参照情報を保持し、UI上でウィジェットが欠落しているものとしてマークします。 |
| ページ(親ページ) | 階層構造を維持するために、 EMPTY ステータスのダミー親ページを作成します。 |
| レイアウトページテンプレートコレクション | EMPTY ステータスのダミーコレクションを作成します。 |
| Liferay DXP 2026.Q1+ ナビゲーションメニュー項目 | 参照情報を保持し、必要に応じてダミーのバッキングエンティティを作成します。 参照先のエンティティが利用可能になるまで、該当項目はUIに警告を表示し、レンダリングされたナビゲーションからは非表示のままになります。 |
| その他の遅延ページエンティティ | インポート中に欠落した遅延ロードされたページエンティティは、 EMPTY ステータスになります。 |
ユーザー参照の欠落の処理
| 参照対象エンティティ | インポート動作 |
|---|---|
| ロール | 不完全な ステータスでプレースホルダーロールを作成します。 |
| アカウント | 不完全な ステータスでプレースホルダーアカウントを作成します。 |
| アカウントグループ | 不完全な ステータスでプレースホルダーアカウントグループを作成します。 |
| 組織 | 不完全な 状態のプレースホルダー組織を作成します。 |
不完全ステータスの理解
プレースホルダーとして作成されたエンティティは、 不完全 ステータスでマークされます。 これらの団体
- 機能的なプレースホルダーとして機能する
- 検証依存機能から除外される
- UIに警告やツールチップを表示する場合があります
- 手動で確認および更新する必要があります
関連するアプリ(例:カテゴリ、ユーザー)で、 不完全な ステータスでフィルタリングすることにより、これらのエンティティを表示および管理できます。
ページエンティティのEMPTYステータスを理解する
ページ関連のプレースホルダーエンティティ(親ページ、マスターページ、レイアウトコレクション、その他の遅延ページ要素など)は、 EMPTY ステータスを使用します。 これらの団体
- インポート時に階層構造とレイアウトの関係を維持する
- 部分的に作成されたエンティティを表現しないでください
- 参照が欠落している代わりに、構造的なプレースホルダーを提供する
- ページ管理では、
EMPTYインジケーターで表示されます。
必要に応じて、インポート後に交換または設定変更が可能です。
EMPTY ステータスのエンティティは、管理アプリケーション (ページ、ユーザー、ロールなど) にのみ表示されます。 これらは、ナビゲーション、アイテムセレクター、その他のユーザー向けツールなど、エンドユーザーや管理者以外のユーザーエクスペリエンスには表示されません。
ベストプラクティス
データの整合性を維持し、スムーズなインポートプロセスを確保するために、以下のガイドラインに従ってください。
-
インポート後、インポートされたデータの
不完全なエンティティをレビューします。 -
参照漏れが発生するシナリオを減らすため、ソースとターゲット間で一貫した環境を使用してください。
-
分類体系、ユーザー割り当て、レイアウト参照が正しく機能していることを確認するため、コンテンツを定期的に監査してください。