SuperAPI AI 工具集

sfcc-cartridge-development

编程与开发

查看项目

更新于 10-15 21:42

技能介绍

用途:基于 Storefront Reference Architecture(SFRA)构建 SFCC 自定义 cartridge,通过服务端 JavaScript 控制器、ISML 模板、模型与 B2C Commerce Script API 扩展或覆盖店面功能,包括自定义结账步骤、支付集成、数据导入导出定时任务,以及面向无头店面的 OCAPI 钩子与 SCAPI 集成。

主要能力:cartridge 分层与覆盖机制(路径中靠前的 cartridge 覆盖靠后的,自定义 cartridge 扩展 app_storefront_base);用 server.js 注册路由,用 server.extend 与 module.superModule 扩展已有控制器,用 server.append 追加逻辑;编写 ISML 模板与数据模型包装;通过 XML 表单定义与服务端校验处理表单;用 Job Framework 编写定时任务;注册 OCAPI 钩子。

使用方式:在 Business Manager 设置 cartridge 路径,如 int_acme_custom:app_storefront_base;控制器以 'use strict' 开头,require('server') 注册 get/post 路由,数据库写入需包在 Transaction.wrap() 中,数据操作使用 *Mgr 类(ProductMgr、BasketMgr、OrderMgr 等),日志用 Logger.getLogger(category, prefix)。OCAPI 钩子在 hooks.json 中注册,如 dw.ocapi.shop.order.afterPOST。

适用场景:扩展 SFRA 功能、覆盖控制器/模板/模型、自定义结账与支付、定时数据同步、无头店面集成。

限制与注意:SFCC 无直接 SQL 访问,必须使用 Script API;缺少事务会导致静默失败;控制器遗漏 next() 会造成请求挂起;站点相关值应使用 Site Preferences 而非硬编码;需在沙箱测试后再部署。资料未提供具体收费、价格与平台支持信息。