フラグメントの変更のプロパゲート
デフォルトでは、カスタムフラグメントのコードに加えられた変更は、フラグメントのデプロイされたインスタンスにプロパゲートされません。 フラグメント伝播を使用すると、フラグメントインスタンスへの変更を次の2つの方法のいずれかで伝播できます。
データの上書きを防ぐため、編集可能なフィールドに加えられた変更は、フラグメントに直接反映されません。 ただし、フラグメントのフィールドIDを変更することで、伝播を強制的に実行できます。 プロパゲートされると、フィールドのコンテンツは表示されなくなりますが、古いフィールドIDを使用してデータベースからコンテンツを取得できます。 詳細については、開発者向けドキュメントの フラグメント固有のタグと属性のリファレンス を参照してください。
変更を手動でプロパゲートする
-
サイトメニュー (
) を開き、 デザイン → フラグメント に移動します。 -
目的のフラグメントのフラグメントセットに移動します。
-
目的のフラグメントに対して アクション (
) をクリックし、 使用状況の表示 を選択します。
ヒント使用状況の表示 オプションが利用できない場合、フラグメントは使用されていません。
-
「使用状況と伝播」ページで、最新バージョンに更新したいフラグメントインスタンスを確認してください。
表では、ページまたはテンプレートが 以前のバージョン を使用しているか、 最新バージョンを使用しているかを確認できます。
-
をクリックして (
) を伝播し、フラグメントの選択したインスタンスを更新します。
編集不可フィールドに加えられた変更は、選択されたフラグメントインスタンスに自動的に反映されます。
フラグメントの変更を伝播する場合、更新は、 マスターページテンプレート のドラフトバージョンと公開バージョンの両方に伝播されない限り、適用されません。 公開版のみが更新された場合、下書きは変更されないため、派生ページに矛盾が生じる。 一貫性を確保するため、必ず最初にドラフトに反映させ、変更内容を確認してからテンプレートを公開してください。
変更を自動でプロパゲートする
自動プロパゲーションは、本番環境において、誤字や不正確なコンテンツが公開されるなど、意図しない結果を招く可能性があります。 自動伝播は、テストまたは開発目的でのみ使用してください。
-
グローバルメニュー (
を開き、 コントロールパネル タブをクリックし、 設定 → システム設定 に移動します。 -
「コンテンツとデータ」セクションで、「 ページフラグメント」をクリックします。
-
［フラグメントの変更を自動的にプロパゲート］ボックスをオンにします。
-
［保存］をクリックします。
有効にすると、フラグメントの編集不可フィールドに加えられた変更は、フラグメントのすべてのインスタンスに自動的に反映されます。
デプロイ プロセス中にデフォルト フラグメントの変更を自動的に伝播する が選択されている場合、Liferay は起動時とデプロイ時にもデフォルト フラグメントの変更を伝播します。
既製のフラグメントを使用するコンテンツページが多数存在する環境では、このプロセスによって起動時間が大幅に増加する可能性があります。 伝播処理中は、Liferayはリクエストを受け付けず、応答がないように見える場合があります。
Liferay PaaS環境では、遅延によって自己修復プローブがトリガーされ、繰り返し再起動が発生する可能性があります。
この設定は、アップグレード直後など、必要な場合にのみ使用してください。 伝播が完了したら、起動遅延を減らすために、 システム設定 と インスタンス設定 の両方の設定をクリアしてください。