mcpField
B
b2c-site-import-export

b2c-site-import-export

github.com/salesforcecommercecloud数据与数据库5788 次安装今天更新
代码仓库

关于 b2c-site-import-export

面向 Salesforce B2C Commerce 项目维护者的站点归档迁移技能，说明如何用 b2c CLI 导入和导出 XML 归档，并验证变更结果。适合需要处理 SCAPI 未覆盖设置的工作。

主要功能

  1. 01导入和导出站点归档
  2. 02按站点数据单元限定导出范围
  3. 03依据 XSD 编写并校验 XML
  4. 04通过读取字段或导出内容验证
  5. 05说明任务后端与 WebDAV 传输

适用场景

  1. 01迁移站点配置归档
  2. 02仅导出活动或促销数据
  3. 03导入后核对实际字段
  4. 04处理 SCAPI 契约未覆盖的设置

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/salesforcecommercecloud/b2c-developer-tooling --skill b2c-site-import-export

安装后在 Claude Code 中输入/b2c-site-import-export确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

evals/
trigger-evals.json
references/
IMPORT-OPTIONS.md
METADATA-XML.md
WORKFLOWS.md

详细介绍

站点归档

使用 b2c job import / b2c job export 传输站点归档。如果无法使用 b2c，请使用 npx @salesforce/b2c-cli。

配置和工具选择

CLI 和 MCP 共用解析后的配置：SFCC_* 变量（包括项目 .env）、项目级/共享的 dw.json 和插件。package.json 提供非机密默认值。在目标项目之外使用 --project-directory。使用 b2c setup inspect --json 或 MCP config_inspect 检查配置；请对机密信息进行遮蔽。通常，已配置的值足以满足需要，无需使用凭据标志或手动读取 dw.json。若遇到配置解析问题，请使用 b2c-cli:b2c-config。

目前没有专用的 MCP 归档传输工具。对于 XML 导入和导出，请使用 CLI，包括 SCAPI 合约中未包含的设置。MCP scapi_execute 可以管理受支持的 Admin 字段；仅有元数据记录并不能证明促销折扣或目标规则已配置。

导入并验证

  1. 确定目标站点/目录和预期变更。归档中仅包含相关数据；保留无关设置和所要求的启用状态。
  2. 按平台归档布局编写 XML。使用 b2c docs schema <name> 检查相关 XSD（使用 --list 列出名称），然后在本地验证。
  3. 导入目录或 zip。默认情况下，命令会等待完成；若失败，--show-log 会显示作业日志。重试前请确认作业已完成。
  4. 读取受影响字段以确认结果。如果 API 未返回这些字段，请导出匹配的数据单元并检查相关 XML 记录。仅作业成功还不足以确认结果。
b2c job import ./archive --show-log
b2c job export --site MySite --site-data campaigns_and_promotions --output ./verification

仅使用 --site 会导出所有站点数据；要进行有针对性的操作，请指定 --site-data。要导出整个实例，请使用 --all；--site all、--catalog all 等会选择某一类型的所有对象。优先使用这些标志，而非手写 --data-units JSON。目录输出会保留平台生成的 *_export 根目录。请勿覆盖现有或已应用的迁移。导出内容可能包含机密或无关默认值；提交前请检查并精简，同时保留 XSD 要求的字段。

专项参考

  • 归档布局和 XML 工作流：归档工作流。
  • 属性/类型 XML 模式：元数据 XML。
  • 远程导入、大小拆分和导入集选项：导入选项。
  • 导出标志、数据单元和精简 JSON 结果：b2c-job 技能中的导出参考。
  • 有序迁移、命名、历史记录和恢复：b2c-cli:b2c-import-set-migrations。
  • 服务配置 XML：b2c:b2c-webservices。

作业优先使用 SCAPI；对于受支持的拒绝情况，--api-backend auto 可以回退到 OCAPI。无论使用哪种后端，归档传输都使用 WebDAV。有关作业范围、后端选择和监控，请参阅 b2c-cli:b2c-job 中的相关部分。

评论

支持 Markdown