Loading
B2C Commerce 入门
进程级复制事件

进程级复制事件

当 B2C Commerce 复制流程达到最终状态时,将触发流程级复制事件。使用它们来跟踪批量复制作业何时完成或失败。

可用于:B2C Commerce 版本 26.6 及更高版本。

事件 ID

事件 ID 描述 被解雇时
sf.cc.replication.completed 复制已成功完成 当复制过程达到 COMPLETED 状态时
sf.cc.replication.失败 复制失败 当复制过程达到 FAILED 状态时

HTTP 标头

流程级复制事件使用 《B2C Commerce 事件的通用 HTTP 标头 》中记录的标准标头,并将 x-sf-cc-event-id 设置为上面列出的事件 ID。

常见有效负载字段

sf.cc.replication.completed 和 sf.cc.replication.failed 事件都在 有效负载 对象中包含这些字段。

字段 类型 必填 描述
进程 ID string 是 复制过程的唯一标识符
UUID string 是 复制过程的 UUID
类型 string 是 复制流程类型(请参阅流程类型)
目标系统 string 是 目标系统名称,通常为“开发”或“生产”
州 string 是 流程的当前状态(请参阅流程状态)
isDataReplication 布尔 是 true 表示数据复制, false 表示代码复制
成功 布尔 是 true 表示已完成事件, false 表示失败事件
描述 string 否 用户提供的复制过程说明
codeVersion string 否 代码复制的代码版本标识符
复制组 阵列 是 包含的复制组列表。请参阅 复制组 ID。
开始日期 string 是 ISO-8601 进程启动时的时间戳
结束日期 string 是 ISO-8601 进程结束时的时间戳

失败事件 (sf.cc.replication.failed) 还包括 errorState ,这是机器可读的错误代码。请参阅 复制错误状态。

流程类型

类型 字段指示复制操作。

数据复制价值 描述
复制发布 数据传输和即时发布
复制 仅数据传输(两阶段复制)
出版物 发布以前传输的数据
撤消 撤消以前的复制
代码复制值 描述
CodeReplicationPublication 代码传输和即时发布
代码复制 仅代码传输
代码发布 发布以前传输的代码
代码撤消 撤消以前的代码复制

流程状态

状态 字段指示进程状态。

值 描述
等待中 流程已创建并准备开始
正在初始化 进程正在准备运行
跑步 流程正在进行中
定稿 流程正在完成
已完成 流程成功完成
失败 进程失败
备注
备注 CANCELED 已弃用,不应出现在新事件中。

示例:成功的数据复制


{
“eventType”: “sf.cc.replication.completed”,
“时间戳”:“2026-03-11T13:31:13.755934395Z”,
“tenantId”: “zzzz_stg”,“
有效负载”: {
“processId”:“12345”,“
UUID”:“550e8400-e29b-41d4-a716-446655440000”,
“类型”:“ReplicationPublication”,
“targetSystem”:“生产”,“
状态”:“COMPLETED”,“
isDataReplication”: true,
“success”: true,“
description”:“每周目录更新”,
“replicationGroups”: [
{
“id”:“ORGANIZATION_CATALOG”,“
类型”:“组织”
},
{
“id”:“目录”,“
类型”:“存储库”,
“域”: “storefront-catalog-m-en”
}
],“
startDate”:“2026-03-11T13:31:03Z”,“
结束日期”:“2026-03-11T13:31:13.727Z”
}
}

示例:复制失败


{
“eventType”: “sf.cc.replication.failed”,
“时间戳”:“2026-03-11T14:22:18.442Z”,
“tenantId”: “zzzz_prd”,“
有效负载”: {
“processId”:“12346”,“
UUID”:“660e8400-e29b-41d4-a716-446655440001”,“
类型”:“复制”,“
目标系统”:“生产”,“
状态”:“失败”,“
isDataReplication”:true,“
成功”:false,“
描述”:“紧急内容更新”,“
errorState”:“ErrorConnectLiveSystem”,
“replicationGroups”: [
{
“id”:“SITE_CONTENT”,“
类型”:“站点”
},
{
“id”:“SITE”,“
类型”:“存储库”,“
域”:“RefArch”
}
],
“startDate”:“2026-03-11T14:22:15Z”,“
结束日期”:"2026-03-11T14:22:18.442Z"
}
}

示例:成功的代码复制


{
“eventType”: “sf.cc.replication.completed”,
“时间戳”:“2026-03-11T15:05:32.118Z”,
“tenantId”: “zzzz_prd”,
“payload”: {
“processId”:“12347”,“
UUID”:“770e8400-e29b-41d4-a716-446655440002”,“
类型”:“CodeReplicationPublication”,
“targetSystem”:“开发”、“
状态”:“COMPLETED”,“
isDataReplication”: false,
“success”: true,
“codeVersion”: “version1”,“
replicationGroups”: [],“
startDate”:“2026-03-11T15:00:00Z”,“
结束日期”:"2026-03-11T15:05:32.118Z"
}
}

备注

  • 描述 字段是可选的用户提供的文本。
  • 空 的 replicationGroups 数组表示纯代码复制。
  • 错误状态是机器可读的代码,而不是本地化的文本。请参阅 复制错误状态。
  • 复制组 ID
    复制事件在其有效负载中携带一个或多个 B2C Commerce 复制组。每个复制组标识参与复制的一个数据单元。使用此页面可以查找给定组 ID 所涵盖的内容。
  • 复制错误状态
    失败的 B2C Commerce 流程级复制事件 (sf.cc.replication.failed) 包括一个 errorState 字段,其中包含用于标识失败的机器可读代码。使用此页面可以查找错误状态的含义。
 
正在加载
Salesforce Help | Article