用途:自定义对象用于存储不适合放入标准系统对象的业务数据,支持站点级与组织级(全局)作用域,可通过脚本 API 与 OCAPI 完成增删改查。常见场景包括业务配置、集成数据缓存、自定义实体(如会员等级、自定义促销、供应商数据)以及临时处理(任务队列、导入暂存)。
定义方式:在 Business Manager 的 Administration > Site Development > Custom Object Types 中定义类型,每个类型包含 ID、键属性(主键)、自定义属性以及作用域。
脚本 API:使用 dw/object/CustomObjectMgr,主要方法有 getCustomObject(type, keyValue)、createCustomObject(type, keyValue)、remove(object)、queryCustomObjects(type, query, sortString, ...args)、getAllCustomObjects(type)、describe(type)。创建、更新、删除需放在 Transaction.wrap 中;查询返回迭代器,处理完需调用 close()。
OCAPI Data API:提供 GET/PUT/PATCH/DELETE /s/-/dw/data/v25_6/custom_objects/{object_type}/{key} 以及 POST /s/-/dw/data/v25_6/custom_objects_search/{object_type} 搜索接口,需 Bearer 令牌;站点级对象使用 /s/{site_id}/ 路径,组织级使用 /s/-/。搜索支持 term_query、text_query、filtered_query、bool_query、match_all_query 等查询类型。
Shopper Custom Objects API(SCAPI):面向店面只读访问,需在 SLAS 客户端配置 sfcc.shopper-custom-objects 或类型级作用域,且类型需在 Business Manager 中启用 shopper 访问;SLAS 客户端最多 20 个自定义对象作用域。
可搜索系统字段:creation_date、last_modified、key_value_string、key_value_integer、site_id。
限制与建议:不要存储未加密的敏感数据,不要创建过多类型,不要用于高并发事务数据;注意处理 getCustomObject 的空返回并及时关闭迭代器。资料未提供收费、价格与平台版本等更多信息。