세분화된 복제 이벤트

다음에서 사용 가능: 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페이로드 필드는 추적 가능 유형당 하나의 버킷으로 구성된 동일한 3개의 버킷 구조를 공유합니다.

성공적인 항목( objects및successfulObjects )에는id문자열이 포함됩니다. 실패한 항목( failedObjects )에는id문자열과 컴퓨터가 읽을 수 있는상태코드가 포함됩니다.

고장 상태 값

각failedObjects항목의status필드에는 컴퓨터가 읽을 수 있는 코드가 포함되어 있습니다.

노트 NOT_INVALIDATED객체는failedObjects에 표시되지 않습니다. 오브젝트 가져오기에 성공했지만 캐시 무효화 단계가 완료되지 않은 경우에도 해당 오브젝트는 성공 목록( objects또는successfulObjects )에 보고됩니다. 0이 아닌 작업 수준 무효화되지 않은 개수는 작업이완료된이벤트가 아닌sf.cc.replication.granular.incomplete이벤트를 내보내도록 합니다.

예: 성공적인 세분화된 복제 이벤트

{
"프로세스 ID": 456,
"유형": "세분화",
 "대상 시스템": "프로덕션",
"상태": "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"
}

예: 실패한 세분화된 복제 이벤트

{
"프로세스 ID": 456,
"유형": "세분화",
 "대상 시스템": "프로덕션",
"상태": "실패",
 "성공": 거짓,
 "오류 상태": "GRANULAR_REPLICATION_FAILURE",
"failedObjects": {
"제품": [
{ "id": "prod-001", "상태": "TARGET_ERROR" }
],
"priceTables": [],
"contentAssets": []
},
"startDate": "2026-03-11T22:13:20Z",
"종료일": "2026-03-11T22:13:25Z"
}

예: 불완전한 세분화된 복제 이벤트

{
"프로세스 ID": 456,
"유형": "세분화",
 "대상 시스템": "프로덕션",
"상태": "불완전",
 "성공": 거짓,
 "오류 상태": "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입니다. 오브젝트별 세분화된 복제 흐름은 프로세스 수준복제 , 게시및코드*이벤트 유형과 다릅니다.
• processId는 프로세스 UUID가 아니라 세분화된 복제 작업 실행 ID입니다.
• endDate는 최종 작업 종료 시간이 아니라 이벤트가 발생한 시간을 반영합니다.
• errorState는 실패한 이벤트의 경우GRANULAR_REPLICATION_FAILURE되고 완료되지 않은 이벤트의 경우GRANULAR_REPLICATION_INCOMPLETE됩니다.
• 각 오브젝트 버킷( products , priceTables , contentAssets )은 비어 있더라도 항상 페이로드에 있습니다.
• 오류 상태 값은 현지화된 텍스트가 아니라 컴퓨터가 읽을 수 있는 코드입니다.
• 각 이벤트 유형은 전역 복제 이벤트 속성과 이벤트별 기능 토글(완료, 실패 및 미완료 이벤트에 대해 각각 하나씩)에 의해 제어됩니다. 둘 중 하나라도 비활성화되면 이벤트가 전송되지 않습니다.