Importation des données de commande depuis un fichier CSV/FTPS

L'importation des données de commande depuis un fichier CSV/FTPS permet l'importation automatique des données de commande depuis un serveur FTPS dans le système Quant. Cette importation permet d'importer les commandes dans Quant.

1. Préparation du fichier pour l'importation

La première étape consiste à créer un fichier Excel contenant les informations sur les produits commandés. Le fichier doit inclure le QID de la commande, l'ID produit primaire et la quantité approuvée. Chaque ligne représente une commande pour un produit spécifique. Une fois le fichier prêt, il doit être exporté et enregistré au format CSV. Cette importation permet d'ajouter (recommander) de nouveaux produits à votre commande. En revanche, si certains produits doivent être supprimés, ils doivent être envoyés avec une quantité égale à 0.

Importation des commandes

2.  Téléchargement du fichier sur le serveur FTPS

Téléchargez le fichier à importer dans le dossier approprié, par exemple ordres 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 des données de commande depuis CSV.

Importer des données de commande depuis 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.
  • 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 des commandes importables CSV assignez les attributs correspondants de Quant à 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

Vous trouverez ci-dessous une liste des autres attributs configurables pour 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

Nombre max de sauts de ligne échappés

Nombre maximal de lignes échappés.

nombre
Mappage des attributs des commandes importables 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. orders.
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 Commandes, vous pouvez vérifier si les données ont bien été créées ou modifiées.

Lancement de la tâche automatique

Produits commandés - quantité approuvée

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.

Journal d'exécution

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.

Afficher les erreurs et les avertissements