Questo articolo spiega come preparare un file “stores” per effettuare l'importazione con Splio.

Prerequisiti

Conoscenza di base del formato CSV e della codifica UTF-8.
Un editor di testo compatibile con UTF-8.
Un software per fogli di calcolo.
La sottosequenza deve essere definita nel file di configurazione nella sezione "stores".

Preparare un file di stores

Modifica l'import file con l'editor di testo UTF-8 che preferisci. Eventualmente, usa un foglio di calcolo con cui hai dimestichezza per controllare il numero e la posizione delle colonne.

📘
Ricordati sempre di salvare utilizzando la codifica UTF-8 senza BOM.

Header e Colonne

La prima riga del file, chiamata header, viene utilizzata per determinare il contenuto delle righe successive. Pertanto, deve essere costruita solo a partire dai nomi delle colonne.

Colonna	Obbligatorio	Tipo di dati / Lunghezza massima	Descrizione
store_id	Sì	Testo (max. 50 caratteri)	L'identificatore esterno del punto vendita; questa colonna è necessaria e deve essere unica per ogni store.
name	No	Testo (max. 120 caratteri)	Il nome dello store
online	No	0 o 1	1 se è un store online, 0 se non lo è.
date_updated	No	YYYY-MM-DD HH:MM:SS	Data dell'ultimo aggiornamento dello store.
manager	No	Testo (max. 120 caratteri)	Il nome dello store manager.
store_type	No	Testo (max. 120 caratteri)	Il tipo di store da visualizzare su Splio.
date_added	No	YYYY-MM-DD HH:MM:SS	Data di creazione dello store.
c0	No		Una colonna personalizzata definita nel tuo universo per "store". Puoi includere fino a 32 colonne denominate da "c0" a "c31".

Si noti che tutti i nomi delle colonne sono sempre minuscoli.

Esempio di un file

Un file corto contenente tre stores ha il seguente aspetto:

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 quattro colonne, store_id, nome, online (solo l'ultima riga è uno store online) e manager. Non vengono utilizzate colonne personalizzate.

Nominare il file

Salva il tuo file con un nome composto dal nome dell'universo, dalla sezione (“stores”), dalla sottosequenza e dalla data attuale. Ad esempio:

myuniverse_stores_apparel_20210315.csv

Questo file appartiene all'universo “myuniverse”, alla sottosequenza “apparel” definita per gli stores ed è datato 15 marzo 2021.

Per saperne di più, consulta la sezione “Linee Guida per la Denominazione dei File” nell'articolo Panoramica.

Ora è possibile caricare il file su SFTP/FTPS.

Date

Tutte le date utilizzate negli import files 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, 2 cifre ciascuno. Il formato corretto per il 15 marzo 2021, alle 13:37, è il seguente:

2021-03-15 13:37:00

Il giorno e l'ora sono separati da uno spazio. È possibile omettere l'orario e inserire solo la data. In tal caso, Splio considererà automaticamente la mezzanotte come ora di riferimento. Ad esempio, 2018-09-09 verrà interpretato come 2018-09-09 00:00:00.

🚧

Usare date senza l'ora non dovrebbe mai essere un'opzione per le date e gli orari: 00:00:00 è mezzanotte e Splio tenterà di elaborare la data come tale. Questo può causare errori e alcuni trigger associati alle date non funzioneranno. Un ulteriore vantaggio dell'uso delle date complete è che sarà possibile cercare e filtrare per data con molta più precisione.

Quando importi date con l’orario, assicurati di utilizzare sempre lo stesso fuso orario (è GMT+1 per i clienti al di fuori della Cina e GMT+8 per i clienti cinesi).

Dettagli aggiuntivi: NULL e cancellazione dei dati

NULL è un valore speciale che indica al database che il campo corrispondente è vuoto.

Puoi configurare il tuo universo Splio affinché interpreti i valori NULL come istruzioni per svuotare i campi. Questa funzione ti consente di cancellare i dati memorizzati nel database. Assicurati che il valore importato sia esattamente NULL, senza spazi aggiuntivi all'inizio o alla fine, altrimenti " NULL" o “NULL” verranno trattati come valori di stringa.

Se non abiliti questa opzione, Splio manterrà i valori per i campi in cui il valore importato è “NULL”.

Differenza tra NULL e stringa vuota

"" è una stringa vuota. Nella maggior parte dei casi, sia NULL che "" saranno importati come valori vuoti.

Soprattutto, la stringa vuota "" non viene mai considerata un valore NULL, quindi non provoca la cancellazione di un valore esistente.