用途:这是一个面向 Salesforce B2C Commerce 的 Page Designer 开发技能,用于创建自定义页面类型(Page Types)与组件类型(Component Types),让商家可在可视化编辑器中搭建和管理内容页面。
主要能力:覆盖 dw.experience 包相关内容,提供与版本无关的模式、JSON 结构与代码示例。页面类型定义页面结构与区域(regions);组件类型是带可配置属性的可复用内容块,支持区域定义、属性分组、属性类型(string、text、markup、boolean、integer、enum、image、file、url、category、product、page、custom 等),以及组件分组与渲染脚本。
文件结构:Page Designer 文件位于 cartridges 的 experience 目录下,页面与组件的 .json 元定义与 .js 脚本须同名配对;模板位于 templates/default/experience/ 下。文件名仅可用字母数字或下划线。组件可置于子目录,组件类型 ID 以点连接路径(如 assets.hero_image_block),模板路径须镜像该路径。
使用方式:页面脚本用 dw.util.Template 渲染,并可借助 PageRenderHelper.getRegionModelRegistry(page) 构建区域模型;组件脚本通过 context.content 读取商家配置的属性。渲染页面可用 PageMgr.getPage 与 PageMgr.renderPage。
适用场景:需要在 B2C Commerce 中自定义 Page Designer 页面类型、组件类型、区域与属性的开发者。
限制:资料中 JSON schema 与 Script API 签名为示意,可能随平台版本变化,需以官方文档为准;enum 属性应使用字符串数组 values,避免使用 value/display_value 对象,否则组件可能被拒绝;custom 颜色选择器需要 BM cartridge 路径支持,否则建议改用 string;default_value 仅用于店面渲染,不会在编辑器中预选;已创建内容后不应更改类型 ID 或属性类型。若组件未出现,可检查 enum、自定义编辑器、命名、region_definitions、模板路径、错误日志与代码版本。资料未提供收费、价格、平台版本或效果信息。