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