SuperAPI AI 工具集

b2c-business-manager-extensions

通用与其它

查看项目

更新于 10-16 01:10

技能介绍

用途:指导创建 Business Manager(BM)扩展 cartridge,以定制后台管理界面。扩展通过单个 bm_extensions.xml 描述符加渲染 ISML 页面的控制器实现。

主要能力:菜单项(在 Admin 或站点菜单中新增导航容器)、菜单操作(挂在菜单项下、绑定控制器节点的功能页)、对话框操作(在既有 BM 页面指定扩展点添加按钮)、表单扩展(为订单/客户搜索等既有搜索表单添加字段)。

必要用法:描述符使用 bmmodules/2007-12-11 命名空间(bmext.xsd)。name、short_description、description 是带必需 xml:lang 属性的子元素,按语言重复实现本地化;icon 为纯字符串路径;position 升序,数值越小越靠上。菜单操作通过 exec 的 pipeline 与 node 绑定控制器导出函数,并在 sub-pipelines 注册所有用到的节点,节点须导出且 .public = true,否则返回 403。对话框操作用 xp_ref 指定扩展点,并通过子元素 menuactions 下的 menuaction-ref action-id 关联菜单操作。表单扩展的 valueinput 需 type 与 name。文件编码用 ISO-8859-1。启用时把 cartridge 加入 Business Manager 站点 cartridge 路径,并在角色中授予模块权限。

适用场景:为 BM 后台添加自定义管理工具、导出页、订单同步按钮、搜索过滤字段等。

限制:exec 仅接受 pipeline 与 node,无 https 属性;apis、scapis、required-features 对自定义菜单操作不支持;对话框操作不接受 icon;NoPermissionCheck 仅用于对任意已认证 BM 用户安全的端点(keepalive、service worker、轮询);BM cartridge 应与店面 cartridge 分开;页面节点需校验 session.userAuthenticated。具体 schema 细节可用 b2c docs schema bmext 核对。