用途:指导在 B2C Commerce 中使用 Service Framework 实现外部服务集成,通过 LocalServiceRegistry 调用外部 REST、SOAP、FTP/SFTP 等接口。
主要能力:服务配置在 Business Manager 中管理;支持自动限流保护外部系统、熔断防止级联失败、通信日志与敏感数据过滤、以及无需外部调用的 Mock 测试。服务类型包括 HTTP(REST、webhook)、HTTPForm、FTP(已弃用)、SFTP、SOAP 和 GENERIC 自定义协议。
使用方式:在 Administration > Operations > Services 配置 Service Configuration、Service Profile(超时、限流、熔断)和 Service Credential(URL、认证)。脚本侧用 require('dw/svc/LocalServiceRegistry') 创建服务实例,实现 createRequest、parseResponse,建议实现 filterLogMessage 过滤敏感数据;调用 myService.call(params) 返回 dw.svc.Result,通过 ok、status、object、error、errorMessage、unavailableReason 判断结果。可用 mockCall 或 mockFull 配合 setMock() 进行测试。
适用场景:需要从 B2C Commerce 调用外部 REST/SOAP API、传输文件或做集成测试时。
限制:FTP 类型已弃用;生产环境必须做日志过滤;createRequest 与 parseResponse 在未实现 execute 时必填;具体配置项与错误码需以官方文档为准。