Sitecore 商务:为商务 呈现s添加渲染变体支持

	时间阅读: 大约10 - 15分钟
	用于: Sitecore 商务开发者和Sitecore开发者
	主要结论: 大多数商务渲染不支持开箱即用的渲染变体. 这篇文章概述了你需要知道什么来修改它们来处理渲染变量.

与许多SXA渲染不同，商务渲染不支持渲染变体. 然而，有两个例外. 它们是产品包和产品信息页面内容变体. 这并没有为多个站点实例提供很多灵活性, 特别是如果每个站点都想要不同的产品页面的外观和感觉. 我们在最近的一个客户端遇到了这个问题，该客户端需要在产品页面上呈现变体的灵活性. 在这篇文章中，我将介绍我们如何修改商务 目录渲染来处理各种渲染变量. 虽然我将重点放在目录渲染上，但您也可以在其他商务渲染上使用这些细节.

创建新的渲染模型

对于任何要处理呈现变体的呈现，其呈现模型都需要继承 Sitecore.XA.基金会.变体.抽象.模型.变体呈现Model. 该模型包括 变体Fields 属性，该属性包含在Sitecore中配置的变体定义. 您可能只需要在您的渲染模型上实现这个字段并自己填充它就可以了. 然而，有一些引用 变体呈现Model 在一些字段渲染中，如果我们这样做，你可能会失去一些功能.

我们需要做的是更新 Sitecore.商务.XA.功能.目录.模型.目录项呈现Model 继承 变体呈现Model. 不幸的是，它已经继承了自己的基类 Base商务呈现Model. 我们需要重新创建它和其他几个类来让它工作. 以下是我采取的步骤. 你需要一个像dotPeek这样的反编译器来重新实现Sitecore代码的一部分.

1. 重新实现 Sitecore.商务.XA.基金会.常见的.模型.Base商务呈现Model as Base商务变体呈现Model 继承 变体呈现Model 而不是
2. 重新实现 Sitecore.商务.XA.功能.目录.模型.目录项呈现Model as 目录项变体呈现Model 继承新 Base商务变体呈现Model class.
   • 这里的另一个选择是使用传递属性到原始文件 目录项呈现Model 为了使升级更容易. 我没有这么做，因为我们对产品结构进行了重大更新，无论如何都需要重新执行大部分模型
3. 更新ModelProvider以解析新模型. 您需要为此创建一个配置补丁. 例子:

    
    <目录项变体呈现Model type="S和box.功能.目录.模型.目录项变体呈现Model,沙箱.功能.目录" />
    

创建新的Base目录Repository

现在我们有了一个可以处理呈现变体的新呈现模型, 我们需要一个新的存储库来填充它. 就像模型一样，我们将使用现有的存储库作为起点. 我们将重新实现 Sitecore.商务.XA.基金会.常见的.存储库.Base商务ModelRepository as Base目录变体Repository. 大部分代码将保持与原始代码相同，您只需要做以下更改.

1. 替换所有发生的 Base商务呈现Model 与 Base商务变体呈现Model
2. 替换所有发生的 目录项呈现Model 与 目录项变体呈现Model
3. 更新 Current目录项呈现ModelKeyName 常量为新值. 这将防止我们的更新导致未修改的渲染问题
4. 中返回新的呈现模型的新的模拟数据模型 GetProduct 方法
5. 确保呈现项 项 和 Page项 属性设置为当前目录项. 这将允许在呈现变体中使用目录字段

渲染视图

现在我们有了新的基类，我们需要更新目录呈现来使用它们. 为此，我将使用Product Images渲染作为示例. 首先，我们需要重新实现 ProductImagesRepository 归还我们的新模型. 这很简单，因为它只需要调用 GetProduct 在基本存储库中. 我们要做的就是确保它继承 Base目录变体Repository 我们刚刚创建了一个方法，它返回 目录项变体呈现Model 通过 GetProduct 方法.

现在我们需要一个新的控制器动作来进行渲染，以及一个新的cshtml视图来渲染. 它所需要做的就是召唤新的 ProductImagesRepository.

公共ActionResult ProductImages ()
{
    返回视图(Get呈现View (nameof (ProductImages)), productImagesRepository.GetProductImages呈现Model (visitorContext null));
}

我们需要一个简单的视图文件来呈现我们将在Sitecore中创建的变体. shell将与原始视图相同, 但内容将被替换为呈现变量字段的循环

    

        @ if(模型.项 != null)
        {
            在模型中调用BaseVariantField.VariantFields)
            {
                @Html.呈现变体 ().RenderVariant (variantField模型.项,模型.呈现WebEditingParams模型)
            }
        }
    

把它们放在一起

现在我们已经有了后台，我们需要将它全部连接到Sitecore中. 现在我们只更新开箱即用的渲染. 在实践中，我强烈建议通过克隆创建您自己的渲染版本，以防止更新影响我们的工作.

首先我们需要更新 控制器 字段，并将其呈现给我们的新控制器. 然后我们需要包括 / sitecore /模板/基础/经验加速器/变量/ / IComponentVariant呈现参数 模板更改为“产品图像参数”模板. 这是在体验加速器中显示变体下拉框所需要的.

最后，我们需要在Sitecore中创建渲染变量，这样就有东西真正呈现到页面上了. 您可以使用原始视图文件作为起点. 下面是我创建的一个示例，默认是开箱即用的外观和一个排除缩略图的备用外观. 你在这里做什么取决于你.

< / div >

这只是解决问题的一种方法. 缺点是，您需要修改您想要呈现不同功能的每个呈现. 如果您想要包含任何新功能，重新实现基类也会使升级更加困难. 然而，呈现变体为商务组件提供了与SXA组件相同的灵活性. 尽管这并不是对如何将呈现变体集成到商务呈现的详尽介绍, 如果您决定在将来实现它，我希望它能给您一个良好的起点.

< / div >

< / div >