詳細情報:
プロセスレベルのレプリケーションイベント
プロセスレベルのレプリケーションイベントは、B2C Commerce レプリケーション処理が終了状態に達したときに起動します。これらを使用して、一括レプリケーション ジョブが完了または失敗したタイミングを追跡します。
使用可能なソリューション:B2C Commerce リリース 26.6 以降。
イベント ID
| イベント ID | 説明 | 発射時 |
|---|---|---|
sf.cc.replication.completed
|
レプリケーションは正常に完了しました | レプリケーション処理がCOMPLETED状態に達した場合 |
sf.cc.replication.failed
|
レプリケーションに失敗しました | レプリケーション処理がFAILED状態に達した場合 |
HTTP ヘッダー
プロセスレベルのレプリケーションイベントでは、「B2C Commerce イベントの一般的な HTTP ヘッダー」に記載されている標準ヘッダーを使用し、x-sf-cc-event-idを上記のイベント ID に設定します。
共通のペイロード フィールド
sf.cc.replication.completedとsf.cc.replication.failedの両方のイベントはペイロードオブジェクト内にこれらのフィールドを含みます。
| フィールド | タイプ | 必要あり | 説明 |
|---|---|---|---|
プロセス ID
|
string | あり | レプリケーション処理の一意の識別子 |
uuid
|
string | あり | レプリケーション処理の UUID |
type
|
string | あり | レプリケーション処理のタイプ (処理タイプを参照) |
targetSystem (ターゲットシステム)
|
string | あり | ターゲット・システム名(通常は「開発」または「本番」) |
state
|
string | あり | プロセスの現在の状態 (プロセスの状態を参照) |
isDataReplication (英語)
|
ブール値 | あり |
データのレプリケーションの場合はtrue、コードのレプリケーションの場合はfalse |
成功
|
ブール値 | あり |
完了したイベントの場合はtrue、失敗したイベントの場合はfalse |
description
|
string | なし | レプリケーション処理に関するユーザー指定の説明 |
codeVersion (コードバージョン)
|
string | なし | コードレプリケーションのコードバージョン識別子 |
レプリケーショングループ {{れぷりけーしょんぐるー
|
配列 | あり | 含まれるレプリケーション グループの一覧。「レプリケーション グループ ID」を参照してください。 |
開始日
|
string | あり | プロセス開始時の ISO-8601 タイムスタンプ |
終了日
|
string | あり | 処理終了時の ISO-8601 タイムスタンプ |
失敗したイベント ( sf.cc.replication.failed ) には、マシンで読み込み可能なエラーコードであるerrorStateも含まれます。「レプリケーション エラーの状態」を参照してください。
プロセスの種類
typeフィールドは、レプリケーション操作を示します。
| データレプリケーションの価値 | 説明 |
|---|---|
レプリケーションパブリケーション
|
データ転送と即時公開 |
レプリケーション
|
データ転送のみ (2 段階レプリケーション) |
論文発表
|
以前に転送したデータの公開 |
元に戻す
|
以前のレプリケーションを元に戻す |
| コードレプリケーション値 | 説明 |
|---|---|
CodeReplicationPublication (英語)
|
コードの転送と即時発行 |
コードレプリケーション
|
コードの転送のみ |
コードパブリケーション
|
以前に転送したコードの公開 |
コード元に戻す
|
以前のコードレプリケーションを元に戻す |
プロセスの状態
stateフィールドは、プロセスの状態を示します。
| 値 | 説明 |
|---|---|
待機中
|
プロセスが作成され、開始する準備が整いました |
初期化中
|
プロセスは実行の準備をしています |
実行中
|
処理が進行中です |
ファイナライズ
|
プロセスが完了しています |
完了しました
|
処理は正常に完了しました |
失敗
|
プロセスに失敗しました |
CANCELEDは廃止予定であり、新しいイベントには表示されません。例: データレプリケーションの成功
{
"eventType": "sf.cc.replication.completed",
"timestamp":"2026-03-11T13:31:13.755934395Z",
"tenantId": "zzzz_stg",
"payload": {
"processId":"12345",
"uuid":"550e8400-e29b-41d4-a716-446655440000",
"type":"ReplicationPublication",
"targetSystem":"Production",
"state":"COMPLETED",
"isDataReplication": true,
"success": true,
"description":"Weekly catalog update",
"replicationGroups": [
{
"id":"ORGANIZATION_CATALOG",
"type":"ORGANIZATION"
},
{
"id":"CATALOG",
"type":"REPOSITORY",
"domain": "storefront-catalog-m-en"
}
],
"startDate":"2026-03-11T13:31:03Z",
"endDate":"2026-03-11T13:31:13.727Z"
}
}
例: レプリケーションの失敗
{
"eventType": "sf.cc.replication.failed",
"timestamp":"2026-03-11T14:22:18.442Z",
"tenantId": "zzzz_prd",
"payload": {
"processId":"12346",
"uuid":"660e8400-e29b-41d4-a716-446655440001",
"type":"Replication",
"targetSystem":"Production",
"state":"FAILED",
"isDataReplication": true,
"success": false,
"description":"Emergency content update",
"errorState":"ErrorConnectLiveSystem",
"replicationGroups": [
{
"id":"SITE_CONTENT",
"type":"SITE"
},
{
"id":"SITE",
"type":"REPOSITORY",
"domain":"RefArch"
}
],
"startDate":"2026-03-11T14:22:15Z",
"endDate":"2026-03-11T14:22:18.442Z"
}
}
例: コードレプリケーションの成功
{
"eventType": "sf.cc.replication.completed",
"timestamp":"2026-03-11T15:05:32.118Z",
"tenantId": "zzzz_prd",
"payload": {
"processId":"12347",
"uuid":"770e8400-e29b-41d4-a716-446655440002",
"type":"CodeReplicationPublication",
"targetSystem":"Development",
"state":"COMPLETED",
"isDataReplication": false,
"success": true,
"codeVersion": "version1",
"replicationGroups": [],
"startDate":"2026-03-11T15:00:00Z",
"endDate":"2026-03-11T15:05:32.118Z"
}
}
注
説明フィールドは、オプションのユーザー指定のテキストです。- 空の
replicationGroups配列は、コードのみのレプリケーションを示します。 - エラー状態は機械で読み取り可能なコードであり、ローカライズされたテキストではありません。「レプリケーション エラーの状態」を参照してください。
- レプリケーション グループ ID
レプリケーションイベントのペイロードには 1 つ以上の B2C Commerce レプリケーショングループが含まれます。各レプリケーション グループは、レプリケーションに参加したデータの単位を識別します。このページを使用して、特定のグループ ID がカバーする内容を検索します。 - レプリケーション エラーの状態
失敗した B2C Commerce プロセスレベルのレプリケーションイベント (sf.cc.replication.failed) には、エラーを識別する機械可読コードを含むerrorStateフィールドが含まれます。このページを使用して、エラー状態の意味を調べます。
