(it) File di configurazione
Panoramica
Questo articolo offre una spiegazione dettagliata della struttura del file di configurazione che definisce il funzionamento del motore di importazione.
Questo articolo come a una guida pratica: non è necessario leggerlo tutto, ma utilizzarlo per individuare le informazioni specifiche di cui hai bisogno. Il file è dotato di collegamenti ipertestuali che semplificano la ricerca delle opzioni di configurazione pertinenti.
Alla fine dell'articolo troverai un esempio di file.
Prerequisiti
- Conoscenza di base o avanzata della sintassi JSON.
- Un contatto in Splio per ricevere e convalidare il tuo file di configurazione.
- Un editor di testo o di codice.
Utilizza il tuo editor di testo o di codice preferito per creare e modificare i file di configurazione. È consigliabile utilizzare un editor in grado di convalidare la sintassi JSON, poiché ti aiuterà a individuare errori comuni come virgole, virgolette o parentesi mancanti. Se non conosci nessun software di questo tipo, puoi usare [JSON Editor Online], un software gratuito disponibile online.
Definire il file di configurazione
Il file di configurazione è un documento di testo che segue il formato JSON (JavaScript Object Notation).
- Nome del file: _imports_config.json
- Codifica: UTF-8 senza BOM
- Formato: JSONFilename: _imports_config.json
Le variabili metasintattiche nella definizione sottostante, che devono essere sostituite con nomi e valori specifici, sono racchiusi tra parentesi angolari ("<>"). Le sezioni opzionali sono racchiuse tra parentesi quadre ("[]"). I puntini di sospensione (". . .") sostituiscono le ripetizioni.
{
"<universe>":{
"<scope1>":{
"<sub-sequence1>":{
"<configoption11>":"<value11>"[,
"<configoption12>":"<value12>"[, . . . ] ]
}[,
"<sub-sequence2>":{
"<configoption21>":"<value21>"[,
"<configoption22>":"<value22>"[, . . . ] ]
}[, . . . ] ]
}[,
"<scope2>":{
"<sub-sequence3>":{
"<configoption31>":"<value31>"[,
"<configoption32>":"<value32>"[, . . . ] ]
}[,
"<sub-sequence4>":{
"<configoption41>":"<value41>"[,
"<configoption42>":"<value42>"[, . . . ] ]
}[, . . . ] ]
}[, . . . ] ]
}
}
Universo
Il file deve contenere un solo oggetto "", il cui nome deve corrispondere a quello del tuo universo Splio e deve essere incluso nel nome del file.
Sezione
L'universo deve avere almeno un oggetto "". Le sezioni rappresentano i tipi di dati importati nel database di Splio.
Qui di seguito, ecco le sezioni disponibili:
- Contacts
- Products
- Stores
- Orders
- Abandoned carts
- Orders items
- Master Reward, Reward, Burn Reward (in riferimento ai programmi Loyalty)
- Credit points
- Events
- Delete contacts
- Card code (iscrizione a Loyalty)
- Tier change (cambio di livello)
Solo la sezione contatti ha una funzione di cancellazione equivalente.
Sottosequenza
Ogni sezione deve contenere uno o più oggetti “”. Le sottosequenze sono utilizzate per definire i file di importazione, che appartengono sempre a una specifica sottosequenza all'interno di un ambito. Le sottosequenze rappresentano diverse fonti di dati (ad esempio, basi esterne) o importazioni all'interno dello stesso ambito effettuate per motivi diversi.
Tutte le opzioni di configurazione sono definite all'interno delle sottosequenze.
Sezioni e opzioni di configurazione
Le seguenti sottosezioni elencano le opzioni di configurazione disponibili per ogni ambito.
Contatti
Per i contatti sono disponibili le seguenti opzioni di configurazione:
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Direcciones de correo electrónico de todas las personas que recibirán el informe una vez finalizada la importación. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno gli avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. |
| default cellphone prefix | Sì | numerico | Un prefisso internazionale (country code) da aggiungere a tutti i numeri di cellulare locali trovati nel file. Non verrà aggiunto ai numeri già presentati con un codice paese. |
| init lists | Sì | elenco di valori numerici | Un elenco che deve includere gli ID numerici di tutti gli elenchi Splio che devono essere inizializzati (cioè svuotati) prima dell'importazione. |
| create contacts | No | 0 (no) / 1 (sì, default) | Consente di creare nuovi contatti durante l'importazione. È attivato di default. Disattivandolo, si può impedire che un determinato file di importazione crei nuovi contatti. |
| update contacts | No | 0 (no) / 1 (sì, default) | Consente di aggiornare i contatti esistenti sulla base del file di importazione. È attivato di default. Disattivandolo, si può fare in modo che nessun contatto venga aggiornato durante l'importazione di questo file. Si può usare per iscrivere automaticamente i contatti alle mailing list. |
Suggerimento: se non si desidera cancellare (inizializzare) nessun elenco, è sufficiente fornire come valore un elenco vuoto: “init lists": [ ].
Prodotti
Los productos
I prodotti rappresentano varie tipologie di merci che possono essere acquistate dai contatti. Per i prodotti sono disponibili le seguenti opzioni di configurazione:
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi e mail di tutti coloro che riceverranno il report al completamento dell'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. |
| create products | No | 0 (no) / 1 (sì, default) | Consente di creare nuovi prodotti durante il processo di importazione. Questa funzionalità è abilitata di default. Disattivandola, si può evitare che un file di importazione specifico generi nuovi prodotti. |
| update products | No | 0 (no) / 1 (sì, default) | Consente l'aggiornamento dei prodotti esistenti utilizzando il file di importazione. Questa funzione è attivata di default. Disattivandola, è possibile impedire che i dati dei prodotti vengano aggiornati durante il processo di importazione. |
Stores
I punti vendita possono essere fisici o online.
Sono disponibili le seguenti opzioni di configurazione per i punti vendita:
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta completata l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su "1" (sì), i valori già presenti verranno sostituiti con NULL durante l'aggiornamento di un dato dal file, qualora il campo corrispondente nel file risulti vuoto. |
| create stores | No | 0 (no) / 1 (sì, default) | Consente di creare nuovi negozi durante l'importazione. Questa funzionalità è abilitata di default. Disattivandola, è possibile evitare che un file di importazione generi nuovi negozi. |
| update stores | No | 0 (no) / 1 (sì, default) | Consente di aggiornare i negozi esistenti in base al file di importazione. Questa funzionalità è abilitata di default. Disabilitando questa opzione è possibile impedire l'aggiornamento dei dati dei negozi durante l'importazione. |
Ordini
Gli ordini rappresentano gli acquisti effettuati dai contatti. Le seguenti opzioni di configurazione sono disponibili per gli ordini:
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta conclusa l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. |
| create orders | No | 0 (no) / 1 (sì, default) | Consente di generare nuovi ordini durante il processo di importazione. È attivato automaticamente, ma disattivandolo puoi evitare che il file di importazione crei nuovi ordini. |
| update orders | No | 0 (no) / 1 (sì, default) | Consente di aggiornare gli ordini già esistenti utilizzando il file di importazione. È attivo di default. Se lo disattivi, eviterai che i dati degli ordini vengano modificati durante il processo di importazione. |
| generate loyalty events | No | 0 (no, default) / 1 (sì) | Abilita la gestione degli ordini come eventi dal motore Loyalty, consentendo l'attivazione di regole in base a determinate condizioni. Senza questo parametro, le regole non possono produrre risultati in seguito agli ordini. È compatibile con lo stesso parametro applicato agli articoli dell'ordine. |
| only orders | No | 0 (no, default) / 1 (sì) | Abilita il motore Loyalty a gestire ordini privi di articoli, affinché le regole Loyalty possano attribuire i risultati. Questa opzione deve essere attivata solo sugli ordini o sugli articoli dell'ordine, ma non su entrambi contemporaneamente. |
Abandonedcarts
Abandonedcarts indica gli acquisti che non sono stati completati. Ecco le opzioni di configurazione disponibili per gestire i carrelli abbandonati:
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta conclusa l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. |
| create abandonedcarts | No | 0 (no) / 1 (sì, default) | Consente la creazione di nuovi carrelli abbandonati durante il processo di importazione. Questa opzione è attiva di default. Disattivandola, puoi evitare che un file di importazione crei nuovi carrelli abbandonati. |
| update abandonedcarts | No | 0 (no) / 1 (sì, default) | Consente di aggiornare i carrelli abbandonati esistenti utilizzando il file di importazione. È abilitato di default. Se disattivi questa funzione, impedirai che i dati sui carrelli abbandonati vengano aggiornati durante il processo di importazione. |
Ordersitems
Ordersitems indica gli articoli individuali in un ordine o in un carrello abbandonato.
Tieni presente che gli articoli in questa sezione non possono essere aggiornati tramite importazione, ma verranno eliminati ogni volta che viene importato (o aggiornato) un ordine o un carrello abbandonato corrispondente.
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta conclusa l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. |
| generate loyalty events | No | 0 (no, default) / 1 (sì) | Consente di elaborare gli ordini come eventi nel motore di Loyalty, così da attivare le regole in base alle condizioni stabilite. Se questo parametro non è impostato, le regole attivate dagli ordini non avranno alcun effetto. Compatibile con lo stesso parametro sugli articoli dell'ordine. |
| only orders | No | 0 (no, default) / 1 (sì) | Permette al motore di Loyalty di gestire articoli di ordini anche in assenza di ordini specifici per le regole Loyalty. Questa impostazione deve essere attivata su ordini o articoli di ordini, ma non su entrambi allo stesso tempo per permettere l'attribuzione dei risultati delle regole di Loyalty. |
Iscrizioni a Loyalty (codice carta)
Questa sezione utilizza le stesse opzioni di configurazione di Ordersitems sopra.
Tier change (cambio di livello)
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| force_points | No | 1 se si desidera attivare | Questo parametro aggiungerà i qpoints mancanti per raggiungere il livello indicato. Se non lo si utilizza, il membro resterà nello stesso livello con un numero insufficiente di qpoints e sarà retrocesso al livello inferiore al prossimo calcolo di retrocessione. |
Credito punti (creditpoints), Eventi (events), Eliminazione contatti (deletecontacts)
Questo gruppo di sezioni di importazione utilizza le stesse due opzioni di configurazione.
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta conclusa l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
Loyalty Rewards (masterreward, earnreward, burnreward)
L'importazione delle sezioni relative ai premi è descritta nell'articolo Rewards Loyalty.
| Opzioni di configurazione | Obbligatorio | Tipo di valore | Descrizione/indicazioni d'uso |
|---|---|---|---|
| report recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno il report una volta conclusa l'importazione. |
| alert recipients | Sì | elenco degli indirizzi email | Indirizzi email di tutti coloro che riceveranno avvisi durante l'importazione. |
| overwrite with empty values | No | 0 (no, default) / 1 (sì) | Solo per le "masterrewards" Se impostato su “1” (sì), i valori esistenti saranno sostituiti da NULL quando un dato viene aggiornato dal file e il campo nel file è vuoto. ⚠️ Non è possibile usare questa opzione per le sezioni "earnreward" e "burnreward" |
Updated 3 months ago