Questo articolo illustra come preparare un file "stores" per l'import con Splio.
Troverai un esempio di un file per questo ambito alla fine di questo articolo.
Prerequisiti
-
Conoscenza di base del formato CSV e della codifica UTF-8
-
Un editor di testo compatibile con la codifica UTF-8
-
Un software di fogli di calcolo
-
Generazione della sotto-sequenza nel file di configurazione nell'ambito “stores”
Preparazione di un file negozi
Modifica il file di import tramite il tuo editor di testo preferito, compatibile con la codifica UTF-8. Se necessario, utilizza un software di fogli di calcolo che già conosci per verificare il numero e la posizione delle colonne.
💡 | Ricordati sempre di salvare il tuo lavoro utilizzando la codifica UTF-8 senza BOM.
Intestazione e colonne
La prima linea del file, denominata intestazione, è utilizzata per determinare il contenuto delle linee successive. Pertanto, deve contenere solamente i nomi delle colonne.
⚠️ | Considera che Splio ignorerà il file se trova un nome di colonna che non identifica oppure se il file non contiene la colonna obbligatoria store_id.
Le seguenti colonne sono disponibili nell'ambito "stores":
|
Colonna |
Necessaria |
Tipo di dati/ Lunghezza massima |
Descrizione |
|
id negozio (store_id) |
Sì |
Testo (max. 50 caratteri) |
L'ID esterno del negozio; questa colonna è obbligatoria e deve essere univoca per ogni negozio. |
|
nome (name) |
No |
Testo (max. 120 caratteri) |
Il nome del negozio. |
|
online |
No |
0 o 1 |
1 se si tratta di un negozio online, 0 in caso contrario. |
|
data di aggiornamento (date_updated) |
No |
YYYY-MM-DD HH:mm:ss |
Data in cui il negozio è stato aggiornato l'ultima volta. |
|
manager |
No |
Testo (max. 120 caratteri) |
Il nome del responsabile del negozio. |
|
tipo di negozio (store_type) |
No |
Testo (max. 120 caratteri) |
Il tipo di negozio da visualizzare su Splio. |
|
data di creazione (date_added) |
No |
YYYY-MM-DD HH:mm:ss |
Data in cui il negozio è stato creato. |
|
c0 |
No |
|
Una colonna personalizzata definita nel tuo universo per "stores". Puoi includere fino a 32 colonne da "c0" a "c31". |
📗 | Nota che tutti i nomi delle colonne sono sempre in minuscolo.
Esempio di un file
Un file conciso contenente tre negozi può avere la seguente struttura:
store_id;name;online;manager
MSEST;"Megastore East";"0";"Emma Smith"
EXBBY;"Express Store Brigby";"0";"Bob Brown"
OLDLV;"Online Delivery";"1";NULL
📗 | Tutte le righe hanno esattamente 4 colonne: store_id, name, online (solo l'ultima linea è un negozio online) e manager. Non vengono utilizzate colonne personalizzate.
Denominare il file
Salva il file con un nome composto dal nome dell'universo, l'ambito ("stores"), la sotto-sequenza e la data odierna. Ad esempio:
myuniverse_stores_apparel_20210315.csv
Questo nome di file appartiene all'universo "myuniverse", sottosequenza "apparel" definita per i negozi, ed è datato 15 marzo 2021.
Per maggiori informazioni, consulta il paragrafo "Linee guida per la denominazione dei file" nel documento di panoramica.
Ora puoi caricare il file su SFTP/FTPS.
Date
Tutte le date utilizzate nei file di import di iscrizione devono essere formattate nel seguente modo: 4 cifre per l'anno, 2 per il mese e 2 per il giorno, seguite da ore, minuti e secondi con 2 cifre per ciascuno. Il formato corretto per la data del 15 marzo 2021 alle 13:37 sarà:
2021-03-15 13:37:00
Il giorno e l'ora sono separati da uno spazio vuoto. Puoi omettere la parte dell'orario e utilizzare solo la data. In tal caso Splio utilizzerà il primo orario possibile del giorno (mezzanotte). Quindi,
2018-09-09
equivale a
2018-09-09 00:00:00
⚠️ | Utilizzare le date senza un orario non dovrebbe mai essere un'opzione per le date e gli orari. 00:00:00 corrisponde alla mezzanotte e Splio tenterà di elaborare ogni data in questo modo. Quest'azione potrebbe generare degli errori e, pertanto, dei trigger associati alle date potrebbero non avvenire in modo corretto.
📗 | Un ulteriore vantaggio nell'utilizzare una data completa è che potrai cercare e filtrare per data con una maggiore precisione.
⚠️ | Utilizza sempre lo stesso fuso orario (GMT+1 per i clienti al di fuori della Cina e GMT+8 per i clienti cinesi) durante l'import delle date con l'orario.
Spiegazione: NULL e valori di cancellazione
NULL è un valore speciale che indica al database che il campo che lo contiene è vuoto.
Il tuo universo Splio può essere configurato in modo che interpreti i valori NULL come istruzioni per i campi vuoti. Puoi utilizzarlo per cancellare i valori archiviati nel database. Per farlo, assicurati che il valore importato sia esattamente NULL. Evita spazi iniziali e spazi finali: " NULL" o "NULL " saranno riconosciuti come valori di stringa.
Se questa opzione non è impostata, Splio considererà i valori per i campi dove il valore importato è NULL.
Differenza tra NULL e stringa vuota
"" è una stringa vuota. Nella maggior parte dei casi, sia NULL sia "" saranno importati come un valore vuoto.
L’aspetto più importante è che la stringa vuota "" non è mai considerata un valore NULL, pertanto non comporterà la cancellazione di un valore esistente.