Cet article explique comment préparer un fichier "stores" pour l'import avec Splio.

Pré-requis

Connaissance de base du format CSV et de l’encodage UTF-8.
Un éditeur de texte compatible UTF-8.
Un tableur
La sous-séquence doit être définie dans le fichier de configuration dans le scope "contacts".

Préparer un fichier de magasins

Modifiez le fichier d'importation à l'aide de votre éditeur de texte compatible UTF-8. Si nécessaire, utilisez un tableur avec lequel vous êtes à l'aise pour contrôler le nombre et la position des colonnes.

📘
N'oubliez pas d'enregistrer avec le codage UTF-8 sans BOM.

En-tête et colonnes

La première ligne du fichier, appelée en-tête, est utilisée pour déterminer le contenu des lignes suivantes. Elle ne doit donc être construite qu'à partir des noms des colonnes.

🚧
N'oubliez pas que Splio ignorera le fichier si il rencontre un nom de colonne qu'il ne peut pas reconnaître, ou si le fichier ne contient pas le champ obligatoire store_id.

Les colonnes suivantes sont disponibles dans les fichiers "magasins" :

Colonne	Obligatoire	Type de champ / longueur max	Description
store_id	Oui	Texte (max. 50 caractères)	L'ID externe du magasin ; cette colonne est obligatoire et doit être unique pour chaque magasin.
name	Non	Texte (max. 120 caractères)	Le nom du magasin.
online	Non	0 ou 1	1 si ecommerce, 0 si magasin physique.
date_updated	Non	YYYY-MM-DD HH:MM:SS	Date de dernière mise à jour du magasin
manager	Non	Texte (max. 120 caractères)	Le nom du manager du magasin.
store_type	Non	Texte (max. 120 caractères)	Le type de magasin à afficher dans Splio.
date_added	Non	YYYY-MM-DD HH:MM:SS	La date de création du magasin
c0	Non		Une colonne personnalisée définie dans votre univers pour les magasins. Vous pouvez en inclure jusqu'à 32 columns, de “c0” à “c31”.

Note : tous les noms de colonnes sont en minuscules.

Exemple de fichier

Voici un fichier court qui contient trois magasins :

store_id;name;online;manager
MSEST;"Megastore East";"0";"Emma Smith"
EXBBY;"Express Store Brigby";"0";"Bob Brown"
OLDLV;"Online Delivery";"1";NULL

Toutes les lignes ont quatre colonnes, store_id, name, online (seulement la dernière ligne est online), et manager. Pas de colonnes personnalisées dans cet exemple.

Nommez votre fichier

Enregistrez votre fichier sous un nom composé du nom de l'univers, du scope ("magasins"), de la sous-séquence et de la date actuelle. Par exemple :

myuniverse_stores_apparel_20210315.csv

Ce nom de fichier appartient à l'univers "myuniverse", sous-séquence "habillement" défini pour les magasins, et est daté du 15 mars 2021.

Si vous souhaitez en savoir plus, vous pouvez lire l'article “File Naming guidelines” dans la section Overview.

Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.

Dates

Chaque date se compose de 4 chiffres pour un an, 2 pour un mois et 2 pour un jour, suivis des heures, des minutes et des secondes, de 2 chiffres chacun. Une date correcte pour le 15 mars 2021, 13h37, prendra la forme suivante :

2021-03-15 13:37:00

Le jour et l'heure sont séparés par un espace vide. Vous pouvez omettre la partie heure et utiliser uniquement la date. Si vous le faites, Splio considérera l'heure la plus tôt possible pour la journée (minuit). Donc,2018-09-09 est traité exactement comme si vous aviez entré2018-09-09 00:00:00.

🚧

Il est obligatoire d'utiliser les heures, minutes et secondes pour les dates : 00:00:00 équivaut à minuit et Splio traitera chaque date sans heure comme ceci. Cela peut causer des erreurs et des triggers associés avec des dates échoueront. Utiliser des dates complètes présente l'avantage supplémentaire de vous permettre d'effectuer des recherches et de filtrer par date avec beaucoup plus de précision.

Lorsque vous importez des dates avec l'heure, utilisez toujours la même timezone pour les dates (c'est GMT+1 pour les clients en dehors de la Chine, et GMT+8 pour les clients chinois).

Explications : NULL et valeurs de suppression

NULL est une valeur spéciale qui indique à la base de données que le champ qui la contient est vide.

Votre univers Splio peut être configuré pour interpréter les valeurs NULL comme des instructions pour vider les champs. Vous pouvez l'utiliser pour effacer les valeurs stockées dans la base de données. Pour ce faire, assurez-vous que la valeur importée est exactement NULL. Vous devez éviter les espaces de début ou de fin: "NULL " ou " NULL" seront reconnus comme des valeurs de chaîne.

Si cette option n'est pas définie, Splio conservera les valeurs des champs où la valeur importée est NULL.

Différence entre NULL et une chaîne vide

"" est une chaîne vide. Dans la plupart des cas, NULL et "" seront importés en tant que valeur vide.

Plus important encore, la chaîne vide "" n'est jamais considérée comme une valeur NULL, donc elle n'entraînera pas l'effacement d'une valeur existante.