Imports – Magasins
Cet article explique comment préparer un fichier "stores" pour l'import avec Splio.
Table des matières
- Pré-requis
- Préparation d'un dossier de magasins
- En-tête et colonnes
- Exemple de fichier
- Nommez votre fichier
- Informations avancées
- Format de fichier
- Colonnes
- Monitoring
Conditions préalables
- 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 et d'utiliser des points-virgules (";") pour séparer les colonnes.
Utilisez votre éditeur de texte préféré pour ouvrir et modifier le fichier d'import.
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.
Les colonnes suivantes sont disponibles dans les fichiers "magasins" :
- store_id - l'identifiant externe du magasin ; cette colonne est obligatoire et doit être unique pour chaque magasin.
- name - le nom du magasin.
- online - 1 si une boutique en ligne, 0 sinon.
- store_type - le type de magasin à afficher dans Splio.
- manager - nom du gérant du magasin.
- Une colonne personnalisée, si elle est définie pour les magasins de votre univers Splio.
Les noms de colonnes sont toujours en minuscules.
N'oubliez pas que l'import échouera si vous n'incluez pas la colonne obligatoire (store_id) ou si vous utilisez une colonne qui n'existe pas.
Exemple de fichier
Un fichier court contenant trois magasins peut ressembler à ceci :
store_id;name;online
MSEST;Megastore East;0
EXBBY;Express Store Brigby;0
OLDLV;Online Delivery;1
Toutes les lignes ont exactement trois colonnes, store_id, name et online (seule la dernière ligne est une boutique en ligne). Aucune colonne personnalisée n'est utilisée.
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_20180315.csv
Ce nom de fichier appartient à l'univers "myuniverse", sous-séquence "habillement" défini pour les magasins, et est daté du 15 mars 2018.
Vous pouvez maintenant télécharger le fichier sur SFTP / FTPS.
Informations avancées
Cette partie du document contient des informations supplémentaires qui complètent le guide ci-dessus et fournissent plus de détails.
Format de fichier
Nom du fichier |
<universe>_stores_<name>_<date>(_<id>).csv |
Encodage |
UTF-8 |
Format |
CSV (no multiline) |
Séparateur de colonnes |
; (semicolon) |
Qualificateur de texte |
" (double quote, optional) |
Caractère d'échappement |
\ (backslash) |
Fin de ligne |
\n or \r\n |
Séparateur décimal |
. (dot) |
Colonnes
Le tableau ci-dessous contient des informations détaillées sur toutes les colonnes (champs) du scope "magasins".
/!\ N'oubliez pas que tous les noms de colonne sont sensibles à la casse. Pour cette raison, les noms par défaut sont tous en minuscules.
Colonne |
Obligatoire |
Type de données / longueur maximale |
Description |
store_id |
Oui |
Texte (max.50 caractères) |
Cette colonne représente l'identifiant externe du magasin à importer. Il sert de clé primaire du scope stores, donc Splio ignorera tous les fichiers où cette colonne est absente et sautera toutes les lignes où il ne contient pas de valeur. |
name |
Non |
Texte (max.120 caractères) |
Le nom du magasin tel qu'il apparaît dans Splio. |
online |
Non |
Boolean (0/1) |
Le type de magasin : en ligne ou retail. |
store_type |
Non |
Texte (max.120 caractères) |
Type de magasin affiché dans Splio. |
manager |
Non |
Texte (max.120 caractères) |
Le gestionnaire du magasin tel qu'affiché dans Splio. |
<custom> |
Non |
Texte (max.255 caractères) |
Voir ci-dessous |
Vous pouvez inclure des champs personnalisés définis dans votre univers Splio dans le scope des magasins dans vos imports. Pour ce faire, utilisez soit le nom du champ comme nom de colonne, soit les lettres "c" (minuscules) suivies de l'id numérique du champ.
Par exemple, si vous avez un champ appelé "franchise" dans votre base et que son identifiant est 12, vous pouvez utiliser "franchise" ou "c12" comme nom de la colonne.
Gardez à l'esprit que si Splio ne peut pas reconnaître le nom d'une colonne, il n'importera pas le fichier.
Monitoring
Les informations suivantes sont mises à disposition par Splio après l'import, généralement sous la forme du fichier journal dans le dossier / imports / logs.
- Si l'import a été abandonnée ou non et, si elle a été abandonnée, la raison (colonne inconnue, colonne d'ID externe manquante, champ personnalisé non déclaré)
- Le nombre de lignes traitées (importées + sautées) / importées / sautées
- Le nombre d'enregistrements nouveaux et mis à jour
- La raison pour laquelle chaque ligne a été ignorée (id externe NULL, trop de colonnes / pas assez de colonnes)