粒度复制事件

可用于：B2C Commerce 版本 26.7 及更高版本。

事件 ID

HTTP 标头

粒度复制事件使用《 B2C Commerce 事件的常见 HTTP 标头 》中记录的标准 Commerce Cloud 平台标头，并将 x-sf-cc-event-id 设置为粒度复制事件 ID（例如， sf.cc.replication.granular.completed）。

JSON 有效负载结构 — 公共字段

特定于事件的字段

精细的流程状态

状态 字段指示粒度复制作业的最终状态。

对象存储桶

Objects 、 successfulObjects 和 failedObjects 有效负载字段共享相同的三存储桶结构，每个可跟踪类型一个存储桶。

成功的条目（in objects 和 successfulObjects ）包含一个 id 字符串。失败的条目（在 failedObjects 中）包含 id 字符串和机器可读 的状态 代码。

故障状态值

每个 failedObjects 条目上的 状态 字段都包含机器可读代码。

备注 NOT_INVALIDATED 对象不会出现在 failedObjects 中。如果对象导入成功，但缓存失效步骤未完成，则该对象仍会在成功列表（objects 或 successfulObjects）中报告。非零作业级非无效计数是导致作业发出 sf.cc.replication.granular.incomplete 事件而不是 completed 事件的原因。

示例：成功的粒度复制事件

{
“processId”： 456，
“类型”：“GRANULAR”，“
targetSystem”：“生产”，“
状态”：“COMPLETED”，
“success”： true，
“objects”： {
“products”： [
{ “id”： “prod-001” }
]，
“priceTables”： [
{ “id”： “prod-001@usd-prices” }
]，
“contentAssets”： []
}，“
startDate”：“2026-03-11T22：13：20Z”，“
结束日期”："2026-03-11T22:13:25Z"
}

示例：粒度复制失败事件

{
“processId”： 456，
“类型”：“GRANULAR”，“
targetSystem”：“生产”，“
状态”：“失败”，“
成功”：false，“
errorState”：“GRANULAR_REPLICATION_FAILURE”，“
failedObjects”： {
“products”： [
{ “id”： “prod-001”， “status”：“TARGET_ERROR” }
]，
“priceTables”： []，
“contentAssets”： []
}，“
startDate”：“2026-03-11T22：13：20Z”，“
结束日期”："2026-03-11T22:13:25Z"
}

示例：粒度复制事件不完整

{
“processId”： 456，
“类型”：“GRANULAR”，“
targetSystem”：“生产”，“
状态”：“不完整”，“
成功”：false，“
errorState”：“GRANULAR_REPLICATION_INCOMPLETE”，
“successfulObjects”： {
“products”： [
{ “id”： “prod-001” }
]，
“priceTables”： [
{ “id”： “prod-001@usd-prices” }
]，
“contentAssets”： []
}，“
failedObjects”： {
“products”： [
{ “id”： “prod-002”， “status”：“IMPORT_ERROR” }
]，
“priceTables”： [
{ “id”： “prod-003@eur-prices”， “status”：“NOT_FINISHED” }
]，
“contentAssets”： []
}，“
startDate”：“2026-03-11T22：13：20Z”，“
结束日期”："2026-03-11T22:13:25Z"
}

粒度复制实施说明

• type 是文本字符串 GRANULAR; 每个对象粒度复制流不同于进程级 复制、 发布 和 Code* 事件类型。
• processId 是粒度复制作业执行 ID，而不是进程 UUID。
• endDate 反映事件的发出时间，而不是最终任务结束时间。
• 对于失败的事件，errorState 为 GRANULAR_REPLICATION_FAILURE ，对于不完整的事件，则为 GRANULAR_REPLICATION_INCOMPLETE。
• 每个对象存储桶（products、 priceTables、 contentAssets ）始终存在于有效负载中，即使为空也是如此。
• 故障状态值是机器可读代码，而不是本地化文本。
• 每个事件类型都由全局复制事件属性和每个事件功能切换（已完成、失败和未完成事件各一个）进行控制。如果禁用了其中任何一个，则不会发送该事件。