バージョン管理されたレイアウトAPIの変更

Sitecore 8より前のバージョンでは、コンストラクターは常に共有 __Renderingsフィールドからレイアウト データをロードしていました。

Sitecore 8以降では、コンストラクターは、アイテムがバージョン管理された __Final Renderingsフィールドに値を持っているかどうかを確認します。その場合、レイアウト データはこのフィールドから読み込まれます。そうでない場合は、レイアウト データは共有 __Renderingsフィールドから読み込まれます。

Sitecore 8以降では、コンストラクターを使用してアイテムのレイアウトを取得または設定する必要があります。

var layout = new LayoutField(contextItem).Value;

new LayoutField(contextItem).Value = layoutXmlValue;

Sitecore 8より前のバージョンでは、public static string GetFieldValue(NotNull Field field) メソッドは、共有 __Renderingsフィールドからのみレイアウト データを返していました。Sitecore 8以降では、このメソッドは共有 __Renderingsフィールドまたはバージョン管理された __Final Renderingsフィールドからレイアウト データを返すことができます。

このメソッドは、フィールドの未処理の値を返しません。レイアウトパッチ適用ワークフローを使用して結果のレイアウトを計算し、このレイアウトを返します。

バージョン対応登録された __Final Renderingsフィールドを引数として渡すと、このフィールドのXMLパッチが結果のレイアウトに適用されます。

共有 __Renderingsフィールドを引数として渡すと、__Final Renderingsフィールドの値は無視されます。

Sitecore 8以降では、バージョン管理された __Final Renderingsフィールドの値を無視する場合は、次の方法を使用してレイアウト データを取得する必要があります。

var sharedLayout = LayoutField.GetFieldValue(item.FieldsFieldIDs.LayoutField);

Sitecore 8より前は、この方法を使用してレイアウト データを共有 __Renderingsフィールドに保存することしかできませんでした。

Sitecore 8以降では、この方法を使用して、レイアウト データを共有 __Renderingsフィールドまたはバージョン管理された __Final Renderingsフィールドに保存できます。

この方法では、常に完全なレイアウト値がフィールドに保存されるわけではありません。可能な場合は、選択したフィールドにXMLパッチのみを保存します。

Sitecore 8以降では、次の方法を使用してレイアウト データを共有 __Renderingsフィールドに保存する必要があります。

LayoutField.SetFieldValue(item.FieldsFieldIDs.LayoutField, sharedLayout);