Importation des données magasins depuis un fichier CSV/FTPS
L'importation des données magasins depuis un fichier CSV/FTPS permet d'importer automatiquement des données de magasins dans Quant depuis un serveur FTPS. Cette importation peut être utilisée pour créer de nouveaux magasins dans Quant ou pour mettre à jour les données de magasins (par exemple nom du magasin, surface de vente, adresse, etc.).
1. Préparation du fichier pour l'importation
Tout d'abord, il faut créer un fichier Excel avec les données de magasins. Le fichier doit contenir un ID de magasin unique. Ensuite, ajoutez les informations concernant les magasins que vous souhaitez envoyer (nom, surface, ville, rue, etc.) dans les autres colonnes. Chaque ligne représente un magasin et chaque colonne représente une propriété. Une fois le fichier prêt, vous devez l'exporter et l'enregistrer au format CSV.
Plus d'informations sont disponibles dans le manuel Préparation des données pour l'importation vers Quant.
2. Téléchargement du fichier sur le serveur FTPS
Téléchargez le fichier à importer dans le dossier approprié, par exemple Magasins sur le serveur FTPS.
3. Paramétrage de la tâche automatique
Dans la section Tâches automatiques, créez une nouvelle tâche Importer les données des magasins à partir d'un fichier CSV.
Avant de lancer l'importation, vous devez modifier les attributs suivants dans l'onglet Paramètres :
- Cochez l'attribut Activé pour activer la tâche.
- Renseignez les Extensions de fichiers.
- Définissez correctement le Format du fichier CSV pour qu'il corresponde à votre fichier importé, notamment le jeu de caractères et les délimiteurs.
- Dans la ligne Mappage des attributs de magasins CSV, assignez les attributs de Quant correspondants à toutes les colonnes que vous souhaitez importer.
- Remplissez la ligne Adresse (serveur principal) avec « ftp.extech.eu », ainsi que votre Nom d'utilisateur (serveur principal) et Mot de passe (serveur principal) pour le serveur FTPS.
- Indiquez dans le champ Chemin serveur (serveur principal) le nom du dossier où se trouve le fichier sur votre FTP.
- Nous recommandons également de renseigner les e-mails pour les notifications, où vous pouvez saisir une ou plusieurs adresses e-mail auxquelles seront envoyés des e-mails relatifs aux statuts d’erreur.
Paramètres de tâches automatiques
Attributs
Voici la liste des autres attributs que vous pouvez définir dans le cadre d'une tâche automatique :
Attribut | Description | Type |
Activé | Indique si la tâche automatique est active et si les données peuvent être transférées. | oui/non |
Titre | Nom personnalisé de la tâche automatique. | texte |
Description | Description personnalisée de la tâche automatique. | texte formaté |
Fréquence | Fréquence à laquelle les fichiers doivent être importés depuis le FTPS. | temps |
Notes | Notes. | long text |
Emails pour les notifications | Une ou plusieurs adresses e-mail pour recevoir les messages d'erreur. | liste de chaînes |
Extension de fichier | Extensions possibles que le fichier importé peut contenir. | texte formaté |
Modèle de nom de fichier | Filtrage des fichiers à importer selon une expression. Pas nécessaire si un seul fichier dans le dossier. | texte |
Extraire les fichiers ZIP | A cocher si vous importez un fichier compressé. | oui/non |
Avertir si aucun fichier à importer depuis | Date après laquelle une absence d'import génère une alerte. | sélection de la date |
Chaînes de valeur vides | Valeurs à ignorer ou traiter comme chaînes vides. | texte formaté |
Séparateur de colonnes | Délimiteur de colonnes utilisé dans le fichier CSV. | sélection |
Échappement | A cocher si le fichier utilise les caractères d'échappement. | oui/non |
Caractère d'échappement | Caractère utilisé pour l'échappement. | texte formaté |
Ignorer le caractère d'échappement | A cocher pour ignorer le caractère d'échappement. | oui/non |
Mappage des attribute de magasins CSV | Attributs de Quant associés aux colonnes à importer. | texte formaté |
Jeu de caractères | Jeu de caractères utilisé dans le fichier CSV. | sélection |
Nombre de lignes d'en-tête | Nombre de lignes servant d'en-tête. | nombre |
Séparateur décimal | Symbole utilisé comme séparateur decimal. | sélection |
Valeur de chaîne pour VRAI | Valeur représentant « VRAI », par exemple 1. | texte |
Unité de mesure | Unité utilisé comme cm, mm etc. | sélection |
Séparateur des éléments de liste | Délimiteur utilisé dans les listes. | sélection |
Format de date | Format des dates, ex. 31.12.19. | sélection |
Hôte du serveur principal | Par défaut "ftp.extech.eu", sauf si vous utilisez votre propre serveur. | texte |
Port du serveur principal | Standard 21. | texte |
Nom d'utilisateur (serveur principal) | Identifiant d'accès au serveur FTPS. | texte |
Mot de passe (serveur principal) | Mot de passe d'accès au serveur FTPS. | texte |
Type de client FTP (serveur principal) | Type de client FTP utilisé. | sélection |
SSL implicite (serveur principal) | A cocher si vous utilisez SSL par défaut. Sinon, le SSL explicite est utilisé: | oui/non |
FTP simple (serveur principal) | A cocher pour utiliser le FTP sans chiffrement. | oui/non |
Ne pas modifier les fichiers sources (serveur principal) | A cocher pour laisser le fichier sur le FTPS après importation. | oui/non |
Chemin du serveur (serveur principal) | Nom du dossier où se trouve le fichier produit, ex. Spécifique_magasin | texte |
4. Lancement de la tâche automatique
Une fois tous les paramètres nécessaires configurés, vous pouvez lancer immédiatement l'importation via le bouton Lancer ou attendre que l'importation s'exécute automatiquement selon la fréquence définie. Une fois la tâche automatique réussie, un message apparaîtra en haut à droite pour confirmer l'importation. Dans la section Magasins, vous pouvez vérifier si les magasins ont bien été importés.
Si l'importation a échoué, vous trouverez plus de détails sur les raisons de l'échec dans le Journal d'exécution.
5. Journal d'exécution
Dans l'onglet Journal d'exécution, vous pouvez consulter un récapitulatif de chaque exécution de la tâche automatique, avec les statistiques, erreurs et avertissements.
En sélectionnant une ligne, vous pouvez afficher ses détails avec le bouton Afficher les éléments.
Si une tâche se termine avec une erreur ou un avertissement, vous pouvez consulter le message d'erreur ou d'avertissement correspondant via les boutons Afficher les erreurs et Afficher les avertissements.