Installation et fonctionnement de McdValetConsole

0000002309     -      18/12/2023

McdValetConsole est le successeur de McdValet. Cette application console est conçue pour fonctionner avec la version 8.4 des Mercator MCD, MFD, DIST et SOS. Par rapport à son prédécesseur, McdValetConsole apporte ces améliorations :

  • l'aspect planification (heure de déclenchement) n'est plus assuré par McdValet mais est pris en charge par le Planificateur de tâches de Windows (taskschd.msc). Cela apporte beaucoup plus d'options au niveau de la planification.
  • McdValetConsole peut envoyer un mail à un ou plusieurs destinataires en cas d'erreur, en cas de succès ou dans les deux cas. En cas d'erreur, le mail contient le log des échanges. 

L'exécution de McdValetConsole ne "consomme" pas d'utilisateur Mercator.

 

Installation de McdValetConsole

Placez dans le répertoire principal de Mercator :

Le fichier ini contient ces options :

  • MercatorUser : nom de l'utilisateur Mercator dont les droits et paramètres vont être utilisés par McdValet
  • MercatorPassword : mot de passe de cet utilisateur
  • MercatorDossier (optionnel) : l'ID du dossier Mercator dans une configuration multi-dossiers. A blanc si cette configuration n'est pas utilisée.
  • SmtpHost : serveur SMTP pour l'envoi des mails (host.mydomain.com ou host.mydomain.com:port)
  • SmtpUser et SmtpPassword (optionnels) : à compléter uniquement si le serveur SMTP requiert une authentification
  • SmtpSenderMail : adresse mail d'envoi
  • SmtpSenderName : nom de l'envoyeur de mails
  • SmtpTimeOut : délai d'attente en secondes après l'envoi d'un mail vers le serveur SMTP
  • SmtpEnableSsl (optionnel) : True - False ou 1 - 0

Configuration

La configuration doit d'abord être effectuée dans Mercator

Au niveau des séquences, il faut créer une séquence spécifique dont le code correspondra au code de la séquence qui réceptionnera les documents à la centrale.
Dans cette nouvelle séquence, il faut cocher "Envoyer vers la centrale" (et décocher "Distant" si coché).

Dans un dossier avec liaison vers un terminal de paiement, nous préconisons d'ajouter un mode de paiement "Carte SOS". Celui-ci permet, lorsque le terminal ne répond pas très bien, de pouvoir clôturer la vente sans utiliser un mauvais mode de paiement.

Via "Outils > Paramètres > Config .Echanges Centrale" : il faut spécifier les données à échanger. Le cas échéant, le bouton "Dupliquer" permet de dupliquer vers une nouvelle fiche qui sera prise en compte à partir d'une heure déterminée.

Ensuite, via "Outils > Paramètres > Paramètres McdValet" : il faut créer une ou plusieurs fiches correspondant à un batch McdValetConsole. Cette fiche doit être complétée comme suit :

  • Libellé : information libre
  • E-mail succès : à compléter si on souhaite recevoir un email de confirmation lorsque les échanges se sont déroulés avec succès. On peut indiquer plusieurs adresses en les séparant par ;
  • E-mail échec : à compléter si on souhaite recevoir un email lorsque les échanges se sont conclus par une erreur. On peut indiquer plusieurs adresses en les séparant par ;
  • Echanges : le type d'échanges souhaité :
    • Importer
    • Exporter
    • Exporter et importer
    • Importer et exporter
  • Réessais : le nombre de tentatives supplémentaires en cas d'échec
  • Intervalle : le nombre de secondes entre 2 tentatives

L'information ID n'est pas éditable et est attribuée automatiquement par Mercator. Elle peut toutefois être "copiée" afin d'être utilisée à l'étape suivante.

Création de tâches dans le planificateur de Windows

Le planificateur de tâches peut être démarré par le raccourci se trouvant dans "Outils Système" de Windows ou via la commande %windir%\system32\taskschd.msc /s

Via clic-droit sur "Bibliothèque du planificateur de tâches", il est possible d'ajouter une nouvelle tâche. (Créer une tâche). Dans cette tâche :

  • créez un déclencheur avec les paramètres horaires et de répétition souhaités
  • créez une action
    • programme : le chemin complet vers McdValetConsole.exe
    • argument : l'ID copié à l'étape précédente.

Remarques

  • avant d'exécuter une tâche dans le planificateur de tâches, testez-la en faisant simplement un raccourci vers McdValetConsole.exe suivi d'un espace et de l'ID de la fiche de paramètres McdValet
  • en cas de problèmes, consultez les logs dans le sous-répertoire LogMcdValet du répertoire principal de Mercator
  • dans le planificateur de tâches, le résultat de la dernière exécution est noté comme suit :
    • succès : 0x0
    • échec : 0x1
  • le planificateur de tâches de Windows est un outil standard. Mercator n'assure aucun support par rapport à ce produit et ne prodigue aucune formation le concernant.