Imports - Magasins

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

Pré-requis

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

Comment préparer un fichier de magasins

Si nécessaire, utilisez votre tableur pour enregistrer le fichier des magasins au format CSV ou pour supprimer les colonnes que vous ne pouvez pas (ou ne souhaitez pas) importer.

💡 | N'oubliez pas d'enregistrer avec le codage UTF-8 sans BOM et d'utiliser des points-virgules (";") pour séparer les colonnes.

En-tête et colonnes

La première ligne du fichier est l'en-tête. Assurez-vous qu'il ne contient que des noms de colonne, sinon l'import échouera.

⚠️ | 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" :

📗 | 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.

Consultez notre Introduction pour en savoir plus sur les conventions de nommage.

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

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 2018, 13h17, prendra la forme suivante :

2018-08-09 10:00:05

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. Toutes les données loyalty sont considérées comme des informations financières. Cela signifie que vous et votre marque êtes responsables de ces données et vous ne devez pas laisser de côté les détails.

📗 | Importer des dates avec des heures permet de surcroit de faire un ciblage beaucoup plus précis.

⚠️ | 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).

Explication : NULL et valeurs de suppression

NULL est une valeur spéciale qui dit à 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 une instruction à vider les champs. Pour ce faire, assurez-vous que la valeur est exactement “NULL”.

Si cette option n'est pas définie, Splio gardera les valeurs des champs pour lesquels la valeur importée est “NULL”.

Différence entre “NULL” et chaîne de caractères vide

"" est une chaîne de caractères vides. Dans la plupart des cas, les valeurs “NULL” et "" seront importés comme valeurs vides.

Mais la valeur "" n'est jamais considérée comme valeur NULL, et donc n'effacera jamais une valeur préexistante.