mcpField
B
b2c-job

b2c-job

github.com/salesforcecommercecloud云与 DevOps5794 次安装今天更新
代码仓库

关于 b2c-job

使用 `b2c` CLI 运行、等待并检查现有 Salesforce B2C Commerce 作业的技能。也涵盖站点归档导入和导出；MCP 用户可通过代码模式参考执行作业操作。

主要功能

  1. 01运行作业并按需等待
  2. 02搜索执行记录并查看日志
  3. 03传递参数或系统作业请求体
  4. 04导入和导出站点归档

适用场景

  1. 01运行计划作业或系统作业
  2. 02检查失败的作业执行
  3. 03导入或导出站点数据

MCP 相关

没有专用的 MCP 作业工具。该技能建议 MCP 会话通过代码模式启动、等待并检查作业；归档传输和终端操作则使用 CLI。

安装

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

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

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

包含的文件

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

evals/
trigger-evals.json
references/
EXPORT.md
IMPORT.md
RUN-AND-MONITOR.md

详细介绍

运行和监控作业

使用 b2c job 操作现有作业。要创建作业步骤或编写 jobs.xml，请使用 b2c:b2c-custom-job-steps。如果无法使用 b2c，请使用 npx @salesforce/b2c-cli。

配置和工具选择

CLI 和 MCP 共用配置：SFCC_* 变量（包括项目 .env）、 项目/共享 dw.json 和插件；package.json 提供非机密默认值。 在目标项目之外运行时，请使用 --project-directory。使用 b2c setup inspect --json 或 MCP config_inspect 检查配置；两者默认都会屏蔽机密信息。 仅在需要时覆盖已配置的值。若遇到解析问题，请使用 b2c-cli:b2c-config。

没有专用的 MCP 作业工具。在 MCP 会话中，以代码模式启动、等待并检查 作业（skill://mcp/b2c-mcp-scapi/references/jobs.md）；使用 CLI 传输归档（导入/导出），以及在终端中运行作业。

运行和检查

b2c job run my-job --wait --timeout 600
b2c job run my-job --wait -P key=value
b2c job search --job-id my-job --count 5
b2c job wait my-job execution-id --timeout 600
b2c job log my-job --failed

重建搜索索引（系统作业使用 --body，而非 -P）：

b2c job run sfcc-search-index-product-full-update --wait --body '{"site_scope":["MySite"]}'

除非提供 --wait，否则 job run 会立即返回。关于原始系统作业 请求体、搜索索引、标准步骤选项、执行记录删除和后端 配置，请参阅：运行和监控。 删除操作会移除已完成的执行记录，不会取消作业。

站点归档

b2c job import ./archive --show-log
b2c job import ./storefront-export.zip --wait-for-storefront
b2c job export --site MySite --site-data campaigns_and_promotions --output ./export
b2c job export --storefront my-storefront --output ./export
b2c job export --all --output ./full-export

导入/导出默认会等待，并通过 WebDAV 传输文件。作业优先使用 SCAPI （写入需要 sfcc.jobs.rw，读取需要 sfcc.jobs）；对于受支持的 SCAPI 拒绝请求，--api-backend auto 会回退。 如果访问失败，请参阅运行/监控参考文档中的后端部分。重试写入前，请检查作业结果。

只阅读相关参考文档：

  • 导入远程归档或目录子集：导入选项。
  • 选择导出数据单元或输出路径：导出。
  • 编写/验证 XML 并核实导入的设置：b2c-cli:b2c-site-import-export。
  • 应用有序且受跟踪的迁移：b2c-cli:b2c-import-set-migrations。

输出

状态信息使用 CLI 常规输出即可。编写脚本时，将较大的 --json 结果保存到文件， 并只打印选定字段；保留退出代码并检查失败情况。 请参阅导出中的 compact-results 部分。避免输出完整的 执行记录，也不要针对同一结果同时读取 JSON 和人类可读输出。

评论

支持 Markdown