Ti trovi qui:
Eventi di replica a livello di processo
Gli eventi di replica a livello di processo vengono generati quando un processo di replica di B2C Commerce raggiunge uno stato terminale. Utilizzarle per tenere traccia del completamento o dell'esito negativo dei processi di replica in blocco.
Disponibile in: B2C Commerce versione 26.6 e successive.
ID evento
| ID evento | Descrizione | Quando viene sparato |
|---|---|---|
sf.cc.replication.completed
|
Replica completata correttamente | Quando un processo di replica raggiunge lo stato COMPLETATO |
sf.cc.replication.failed
|
Replica non riuscita | Quando un processo di replica raggiunge lo stato FAILED |
Intestazioni HTTP
Gli eventi di replica a livello di processo utilizzano le intestazioni standard documentate in Intestazioni HTTP comuni per gli eventi di B2C Commerce, con x-sf-cc-event-id impostato sull'ID evento sopra elencato.
Campi payload comuni
Entrambi gli eventi sf.cc.replication.completed e sf.cc.replication.failed includono questi campi all'interno dell'oggetto payload.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
processId
|
string | Sì | Identificatore univoco per il processo di replica |
uuid
|
string | Sì | UUID del processo di replica |
type
|
string | Sì | Tipo di processo di replica (vedere Tipi di processo) |
targetSystem
|
string | Sì | Nome del sistema di destinazione, in genere Development o Production |
Stato
|
string | Sì | Stato attuale del processo (vedere Stati del processo) |
isDataReplication
|
booleano | Sì |
true per la replica dei dati, false per la replica del codice |
Successo
|
booleano | Sì |
true per gli eventi completati, false per gli eventi non riusciti |
description
|
string | No | Descrizione del processo di replica fornita dall'utente |
codeVersion
|
string | No | Identificatore di versione del codice per le repliche di codice |
replicationGroups
|
Matrice | Sì | Elenco dei gruppi di replica inclusi. Vedere ID dei gruppi di replica. |
data di inizio
|
string | Sì | Data e ora ISO-8601 all'avvio del processo |
data di fine
|
string | Sì | Data e ora ISO-8601 al termine del processo |
Gli eventi non riusciti (sf.cc.replication.failed) includono anche errorState, un codice di errore leggibile dal computer. Vedere Stati di errore di replica.
Tipi di processo
Il campo tipo indica l'operazione di replica.
| Valore di replica dei dati | Descrizione |
|---|---|
ReplicationPublication
|
Trasferimento dei dati e pubblicazione immediata |
Replica
|
Solo trasferimento dati (replica in due fasi) |
Pubblicazione
|
Pubblicazione dei dati trasferiti in precedenza |
Annulla
|
Annullamento di una replica precedente |
| Valore di replica del codice | Descrizione |
|---|---|
CodeReplicationPublication
|
Trasferimento del codice e pubblicazione immediata |
Replica del codice
|
Solo trasferimento codice |
Pubblicazione del codice
|
Pubblicazione del codice trasferito in precedenza |
CodiceAnnulla
|
Annullamento di una replica di codice precedente |
Stati del processo
Il campo stato indica lo stato del processo.
| Valore | Descrizione |
|---|---|
IN ATTESA
|
Il processo è stato creato ed è pronto per l'avvio |
INIZIALIZZAZIONE
|
Il processo si sta preparando per l'esecuzione |
CORSA
|
Il processo è in corso |
FINALIZZAZIONE
|
Il processo è in fase di finalizzazione |
COMPLETATO
|
Processo completato con successo |
NON RIUSCITO
|
Processo non riuscito |
L'opzione ANNULLATO è deprecata e non dovrebbe comparire nei nuovi eventi.Esempio: replica dei dati riuscita
{
"eventType": "sf.cc.replication.completed",
"timestamp": "2026-03-11T13:31:13.755934395Z",
"tenantId": "zzzz_stg",
"payload": {
"processId": "12345",
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"tipo": "ReplicationPublication",
"targetSystem": "Produzione",
"stato": "COMPLETED",
"isDataReplication": true,
"success": true,
"description": "Aggiornamento settimanale del catalogo",
"replicationGroups": [
{
"id": "ORGANIZATION_CATALOG",
"tipo": "ORGANIZZAZIONE"
},
{
"id": "CATALOGO",
"tipo": "REPOSITORY",
"domain": "storefront-catalog-m-en"
}
],
"startDate": "2026-03-11T13:31:03Z",
"endDate": "2026-03-11T13:31:13.727Z"
}
}
Esempio: replica non riuscita
{
"eventType": "sf.cc.replication.failed",
"timestamp": "2026-03-11T14:22:18.442Z",
"tenantId": "zzzz_prd",
"payload": {
"processId": "12346",
"uuid": "660e8400-e29b-41d4-a716-446655440001",
"tipo": "Replica",
"targetSystem": "Produzione",
"stato": "FAILED",
"isDataReplication": true,
"success": false,
"description": "Aggiornamento di emergenza del contenuto",
"errorState": "ErrorConnectLiveSystem",
"replicationGroups": [
{
"id": "SITE_CONTENT",
"tipo": "SITO"
},
{
"id": "SITO",
"tipo": "REPOSITORY",
"dominio": "RefArch"
}
],
"startDate": "2026-03-11T14:22:15Z",
"endDate": "2026-03-11T14:22:18.442Z"
}
}
Esempio: replica di codice riuscita
{
"eventType": "sf.cc.replication.completed",
"timestamp": "2026-03-11T15:05:32.118Z",
"tenantId": "zzzz_prd",
"payload": {
"processId": "12347",
"uuid": "770e8400-e29b-41d4-a716-446655440002",
"tipo": "CodeReplicationPublication",
"targetSystem": "Sviluppo",
"stato": "COMPLETED",
"isDataReplication": false,
"success": true,
"codeVersion": "version1",
"replicationGroups": [],
"startDate": "2026-03-11T15:00:00Z",
"endDate": "2026-03-11T15:05:32.118Z"
}
}
Note
- Il campo
della descrizioneè un testo facoltativo fornito dall'utente. - Una matrice
replicationGroupsvuota indica una replica di solo codice. - Gli stati di errore sono codici leggibili dalla macchina, non testo localizzato. Vedere Stati di errore di replica.
- ID dei gruppi di replica
Gli eventi di replica trasportano nel payload uno o più gruppi di replica di B2C Commerce. Ogni gruppo di replica identifica un'unità di dati che ha partecipato alla replica. Utilizzare questa pagina per scoprire gli argomenti di un determinato ID di gruppo. - Stati di errore di replica
Gli eventi di replica a livello di processo di B2C Commerce non riusciti (sf.cc.replication.failed) includono un campoerrorStatecon un codice leggibile dal computer che identifica l'errore. Utilizzare questa pagina per scoprire il significato di uno stato di errore.
