粒度の細かいレプリケーション イベント

使用可能なソリューション:B2C Commerce リリース 26.7 以降。

イベント ID

HTTP ヘッダー

粒度の細かいレプリケーションイベントでは、「B2C Commerce イベントの一般的な HTTP ヘッダー」に記載されている標準の Commerce Cloud プラットフォームヘッダーを使用し、x-sf-cc-event-idを粒度の高いレプリケーションイベント ID ( 例: sf.cc.replication.granular.completed ) に設定します。

JSON ペイロード構造 — 共通フィールド

イベント固有のフィールド

きめ細かなプロセス状態

stateフィールドは、粒度の細かいレプリケーションジョブの最終状態を示します。

オブジェクトバケット

objects、successfulObjects、failedObjectsの各ペイロードフィールドは、同じ 3 バケット構造 (追跡可能なタイプごとに 1 つのバケット) を共有します。

成功したエントリ ( objectsおよびsuccessfulObjects ) にはid文字列が含まれます。失敗したエントリ ( failedObjects内) には、id文字列と機械可読ステータスコードが含まれます。

失敗ステータス値

各failedObjectsエントリのstatusフィールドには、機械可読コードが含まれています。

メモ NOT_INVALIDATEDオブジェクトはfailedObjectsには表示されません。オブジェクトが正常にインポートされても、キャッシュ無効化ステップが完了しない場合でも、オブジェクトは成功リスト ( objectsまたはsuccessfulObjects ) でレポートされます。ゼロ以外のジョブレベルの無効化されていないカウントは、ジョブが完了イベントではなくsf.cc.replication.granular.incompleteイベントを発行する原因です。

例: 粒度の細かいレプリケーション イベントの成功

{
"processId": 456,
"type":"GRANULAR",
"targetSystem":"Production",
"state":"COMPLETED",
"success": true,
"objects": {
"products": [
{ "id": "prod-001" }
],
"priceTables": [
{ "id": "prod-001@usd-prices" }
],
"contentAssets": []
},
"startDate":"2026-03-11T22:13:20Z",
"endDate":"2026-03-11T22:13:25Z"
}

例: 粒度の細かいレプリケーションの失敗イベント

{
"processId": 456,
"type":"GRANULAR",
"targetSystem":"Production",
"state":"FAILED",
"success": false,
"errorState":"GRANULAR_REPLICATION_FAILURE",
"failedObjects": {
"products": [
{ "id": "prod-001", "status":"TARGET_ERROR" }
],
"priceTables": [],
"contentAssets": []
},
"startDate":"2026-03-11T22:13:20Z",
"endDate":"2026-03-11T22:13:25Z"
}

例: 不完全な粒度の細かいレプリケーション イベント

{
"processId": 456,
"type":"GRANULAR",
"targetSystem":"Production",
"state":"INCOMPLETE",
"success": 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",
"endDate":"2026-03-11T22:13:25Z"
}

きめ細かなレプリケーションの実装に関する注意事項

• typeはリテラル文字列GRANULAR ;オブジェクトごとの粒度の細かいレプリケーションフローは、プロセスレベルのレプリケーション、パブリケーション、およびコード*イベントタイプとは異なります。
• processIdは、プロセス UUID ではなく、詳細なレプリケーションジョブの実行 ID です。
• endDateは、最終的なジョブの終了時刻ではなく、イベントが発行された時刻を反映します。
• errorStateは、失敗したイベントの場合はGRANULAR_REPLICATION_FAILURE、不完全なイベントの場合はGRANULAR_REPLICATION_INCOMPLETEです。
• 各オブジェクトバケット ( products、priceTables、contentAssets ) は、空の場合でも常にペイロードに存在します。
• エラーステータス値は機械可読コードであり、ローカライズされたテキストではありません。
• 各イベントの種類は、グローバル レプリケーション イベント プロパティとイベントごとの機能トグル (完了、失敗、および未完了のイベントに対してそれぞれ 1 つ) の両方によってゲートされます。どちらかが無効になっている場合、イベントは送信されません。