MercatorSelfScan

MercatorSelfScan est une application offrant les fonctionnalité de caisse autonome pour la saisie des ventes et la perception du paiement effectuées par le client (self-checkout). Il s'agit d'un programme autonome, qui se connecte à Mercator ERP. Il est construit sur base d'une application hybride Blazor, ce qui facilite le paramétrage et la personnalisation de son interface.

MercatorSelfScan requiert l'option SELFSCAN dans le voucher, suivie d'un ou plusieurs ID d'utilisateurs présents dans la table USERS. Par exemple :

SELFSCAN=A12345678X+Z87654321T

Il est compatible avec la version 11.0 ou ultérieure.

Dans un premier temps, il est nécessaire de disposer sur le poste d'un Mercator Core fonctionnel et à jour. (MercatorSelfScan n'est pas compatible avec la version classique de Mercator).

Ensuite, il est nécessaire d'installer le WebView2 Runtime.

Enfin, le contenu du fichier MercatorSelfScan.zip doit être dézippé dans un répertoire vide. Le fichier MercatorSelfScan.appsettings.json doit être modifié tel qu'indiqué plus bas, et notamment reprendre le chemin d'accès version le Mercator Core dans la clé MainDir. L'assembly MercatorDatabase.dll du Mercator lié doit être copiée dans le répertoire de MercatorSelfScan. L'application est démarrée via MercatorSelfScan.exe.

Lorsque l'application démarre, elle se met sur un mode "pas en service". Il est nécessaire qu'un membre du personnel active la caisse. Comme tous les logins proposés par le programme, cela peut s'effectuer :

• par la saisie d'un mot de passe valide dans Mercator
• par le scan depuis MercatorPenguin du code QR de login
• par la lecture d'un code-barres (sur une carte personnelle) qui contient ce mot de passe

Le self-checkout peut commencer.

Si le programme est paramétré pour gérer plusieurs langues, alors l'utilisateur peut choisir une langue parmi celles-ci. L'utilisateur démarre le scanning en touchant ce bouton :

Si le programme est paramétré pour demander la saisie d'une carte de fidélité, l'utilisateur pourra scanner cette carte ou choisir de continuer en tant que client anonyme.

Le client scanne alors tous les articles de son panier et le contenu de celui-ci s'affiche dans une grille. Un bouton "Article sans code-barres" permet de sélectionner les articles qui ne peuvent être scannés (voir ci-dessous). Quand l'utilisateur a scanné tous les articles, il doit toucher ce bouton :

Le client reçoit un écran l'invitant à choisir un mode de paiement (par exemple, cash via un monnayeur et un terminal de paiement par carte).

En fonction du paramétrage :

• le client reçoit un écran demandant s'il souhaite un ticket
• le client, identifié avec sa carte de fidélité et en fonction de sa fiche client, est informé que le ticket est disponible sous forme électronique dans une application, dans un site web, ...
• le ticket est imprimé automatiquement
• le ticket n'est jamais imprimé

Le cycle de vente du self-checkout se termine par un écran remerciant le client pour son achat.

Dans le haut de chaque écran, ces boutons sont disponibles :

Ils permettent de changer la langue de l'interface et d'appeler un membre le personnel à l'aide. Celui-ci reçoit une notification via MercatorSelfScanMonitor.

Tout ce qui se passe dans la caisse peut être monitoré à distance via une application autonome MercatorSelfScanMonitor.

Le paramétrage s'effectue en modifiant la valeur des clés dans le fichier MercatorSelfScan.appsettings.json. Celui-ci est lu au démarrage de l'application. Cela signifie qu'après toute modification, il faut redémarrer MercatorSelfScan.

• MainDir : répertoire du Mercator lié à MercatorSelfScan. Ce répertoire doit être un chemin local et non mappé. Attention : les backslashes doivent être doublés.
• IdDossier : pour les configurations multi-dossiers, l'ID du dossier. Sinon, vide.
• UserLogin : utilisateur Mercator sous lequel le SelfScan va fonctionner. Il est recommandé d'utiliser un super-user afin de s'assurer qu'une session soit toujours disponible.
• Password : mot de passe dans Mercator pour cet utilisateur.
• DeveloperTools : indiquez 1 pour activer les outils développeurs permettant d'accéder à la console et d'inspecter les éléments HTML (via CTRL-SHIFT-I). En production, cette valeur doit être 0.
• DefaultLanguage : langue pour le démarrage de l'application. Choix possibles : F N E D.
• AvailableLanguages : liste des langues disponibles pour les utilisateurs. Si cette valeur contient une seule langue, le sélecteur de langue n'est jamais affiché.
• CustomerField : colonne de la table CLI pour la recherche de la carte de fidélité. Si cette valeur est vide, l'étape de scan de la carte de fidélité n'est pas affichée.
• DefaultCustomer : id du client par défaut si le client ne s'identifie pas avec sa carte de fidélité.
• Sequence : séquence de vente utilisée.
• PriceUpdatable : indiquez si le prix unitaire de vente est modifiable. Cette modification a toujours lieu moyennant le login d'un assistant. Valeurs possibles : 0 et 1.
• MaxRowsCart : le nombre maximum de lignes qui s'affichent dans la liste des articles déjà scannés. Une fois ce nombre dépassé, une pagination est affichée.
• MaxLengthCart : le nombre maximum de caractères pour l'affichage de la désignation dans la liste des articles déjà scannés.
• FreeRemoveInCart : la suppression d'une ligne scannée est-elle libre ou requiert elle la validation d'un assistant ? Valeurs possibles : 0 et 1.
• PayTerms : terminaux de paiement disponibles. Liste séparée par une virgule. Valeurs possibles :
  • Czam
  • DevTest (terminal de test pour le développement ou le débuggage)
• PayTypes : n° des modes de paiements associés aux terminaux repris ci-dessus. Le nombre d'éléments dans cette liste séparée par une virgule doit être égal au nombre d'éléments dans PayTerms. (Le n° est celui de "Outils / Paramètres / Modes de Paiement".)
• PrintTicket : la dernière étape du processus de vente doit-elle imprimer un ticket et afficher un message indiquant que le ticket a été imprimé ? Valeurs possibles :
  • 0 : ne pas imprimer de ticket
  • 1 : toujours imprimer le ticket
  • le nom d'une colonne bit de la table CLI (par ex. C_PRINT_TICKET) dont la valeur indique le comportement souhaité
• SecondsFinish : nombre de secondes après lesquelles l'interface affiche automatiquement la page de remerciement lorsque les processus de paiement et d'impression du ticket sont terminés.
• SecondsThankYou : nombre de secondes après lesquelles l'interface est réinitialisée (retour à l'étape n°1) lorsque le processus de vente est terminé.
• Name : le nom de cette caisse. Il apparaîtra dans MercatorSelfScanMonitor. Si cette valeur est vide, le nom de la machine est utilisé.
• MonitorHost : les coordonnées TCP de MercatorSelfScanMonitor sous la forme "adresse ip:port". Si MercatorSelfScanMonitor n'est pas utilisé, cette valeur doit être vide.

Le look de l'application peut être largement modifié en éditant ces fichiers se trouvant dans le sous-répertoire wwwroot :

• index.html
• css/style.css
• css/mercator.css
• les images

MercatorSelfScan peut gérer les articles sans code-barres. Pour cela, il utilise en écran nommé ItemSelector qui permet à l'utilisateur de sélectionner un article sur base de sa photo et de son nom et de spécifier, le cas échéant, la quantité.

Pour que cet écran soit visible, il faut que la clé ItemSelectorRecordsPerPage soit supérieure à zéro. Cette page prend en compte les clés suivantes :

• ItemSelectorColumns : nombre de colonnes. Valeurs possible 1, 2, 3, 4, 6, 12
• ItemSelectorRecordsPerPage : nombre d'éléments par page
• ItemSelectorImageSize : la taille de l'image associée, en pixels
• ItemSelectorMaxLength : le nombre maximal de caractères pour que la désignation soit toujours affichée sur une seule ligne

La page ItemSelect peut afficher :

• Des rubriques : la sélection d'une rubrique permet d'accéder à une liste "enfant" contenant d'autres rubriques et/ou d'autres articles
• Des articles permettant la sélection directe

Ce système permet de présenter les articles selon n'importe quelle arborescence, par exemple les rayons, familles et sous-familles ou une autre classification au choix. Il est possible de mélanger les articles et les rubriques. Cela permet d'afficher les éléments dans un ordre jugé optimal pour l'utilisateur. (Par exemple, on affiche d'abord des rubriques mais déjà quelques articles les plus fréquemment achetés). Cet affichage est déterminé par une procédure stockée SQL libre. Cette procédure doit être nommée SP_SELFSCAN_ITEMSELECTOR et accepte ces paramètres :

• @langue char(1) : la langue sous la forme F, N, E, D
• @first int : le n° du premier record à renvoyer selon la pagination
• @last int : le n° du dernier record à renvoyer selon la pagination
• @level char(10) : un code libre permettant de reconnaître la rubrique. Le niveau supérieur est reconnu par @level = ''
• @id char(10) : l'identifiant de la rubrique ou de l'article

Le code repris ci-dessous donne un exemple d'une telle procédure stockée. Les noms des colonnes dans la table @t ainsi que la colonne RowCount sont attendus par MercatorSelfScan.

CREATE PROCEDURE [dbo].[SP_SELFSCAN_ITEMSELECTOR] 
	@langue char(1),@first int,@last int,@level char(10),@id char(10)
AS
BEGIN
	declare @t table (recno int identity(1,1), [level] char(1),id char(10),name varchar(250),img varbinary(MAX))

	if @level = ''
	begin
		insert into @t ([level],id,name,img)
		select 'R' as level,id,nom as name,img from RAYONS where (img is not null) and (DATALENGTH(img) > 0)
		union
		select null as level,s_id as id,s_modele as name,s_image1 as img from STOCK where s_id in ('100058','100059','100060')
	end

	if @level = 'R'
	begin
		insert into @t ([level],id,name,img)
		select 'F' as level,id,nom as name,img from FAMILLES where (id_rayon = @id) and (IMG is not null)
		union
		select null as level,s_id as id,s_modele as name,s_image1 as img from STOCK where (s_id_rayon = @id) and (s_image1 is not null) and (DATALENGTH(s_image1) > 0)
	end

	if @level = 'F'
	begin
		insert into @t ([level],id,name,img)
		select null as level,s_id as id,s_modele as name,s_image1 as img from STOCK where (s_id_famil = @id) and (s_image1 is not null) and (DATALENGTH(s_image1) > 0)
	end

	declare @rowcount int
	select @rowcount = count(*) from @t
	select *,@rowcount as [rowcount] from @t where recno between @first and @last
	
END

Le comportement de MercatorSelfScan peut être personnalisé à l'aide d'un customizer SelfScan présent dans le Mercator lié. Ce customizer doit implémenter l'interface MercatorUi.ICustomizers.ISelfScanStarted, qui va exiger cette méthode :

A partir de là, il est possible de s'inscrire sur des événements documentés ci-dessous. Cette méthode est appelée lors du démarrage de MercatorSelfScan.

La classe MercatorUi.SelfScan dispose d'une propriété ConfigurationManagerAppSettings qui permet d'accéder au contenu du fichier MercatorSelfScan.appsettings.json, via le nom de clé :

Cet accès est en lecture seulement.

Il est permis d'ajouter des clés supplémentaires dans le fichier json, pour les exploiter ici.

Personnaliser les chaînes de caractères

Toutes les chaînes de caractères affichées dans l'interface sont personnalisables. Pour cela, il faut intercepter l'événement ChangeStringResource de l'objet MercatorUi.SelfScan.

Si on souhaite connaître le nom et la valeur des ressources contenues dans MercatorSelfScan, il suffit de placer temporairement ce code, qui produira un fichier contenant les ressources affichées durant la session. Le fichier est produit lors de la fermeture de MercatorSelfScan.

Personnaliser les colonnes de la grille des articles scannés

Dans cette grille, toutes les données présentes dans LIGNES_V sont disponibles. MercatorSelfScan propose une liste de colonnes par défaut. Celle-ci peut être adaptée en ajoutant, en modifiant ou en retirant des colonnes, via l'événement ChangeCartColumns. Dans l'exemple ci-dessous, on montre comment

• ajouter en seconde position une colonne avec le code-barres qui est contenu dans S_CLE1.
• supprimer la colonne avec la croix permettant de supprimer une ligne

La classe MercatorBlazor.GridColumn dispose d'une méthode Clone() qui permet de dupliquer facilement une colonne existante.

Modification des requêtes SQL

Toutes les requêtes SQL peuvent être interceptées et modifiées si le customizer implémente l'interface IStringUpdater. Chaque requête est identifiable par son ID.

Dans l'exemple ci-dessous, nous montrons comment modifier la requête de recherche du client sur base de sa carte de fidélité, pour exclure les clients en sommeil.

Personnalisation par rapport aux spécificités du lecteur de code-barres

La classe MercatorUi.SelfScan.SelfScan passée à la méthode SelfScanStarted contient une propriété BarcodeReader de type MercatorUi.SelfScan.BarcodeReader. Cette propriété doit être populée avec une instance d'une classe concrète qui est dérivée de cette classe abstraite.

Il est nécessaire dans la classe concrète de surcharger la méthode SetEnabled qui permet d'activer et de désactiver le scanner. (Il est essentiel que le scanner soit désactivé quand l'utilisateur est dans un écran qui n'attend pas de scan).

Lorsque la classe concrète reçoit un code-barres (événement code-barres lu), il faut appeler la méthode OnScanSuccessful en lui passant le code-barres qui vient d'être lu.

Remarque : si cette mise en place n'est pas effectuée, MercatorSelfScan présente un émulateur de lecteur de code-barres qui permet d'utiliser le logiciel en mode "démo".

Conseil : ce customizer est centralisé dans la base de données de Mercator et s'applique donc à toutes les caisses. Nous recommandons d'ajouter une clé dans MercatorSelfScan.appsettings.json qui comportera les informations de connexion relatives au scanner installé sur ce poste. (Par exemple, le port COM ou le port USB utilisé). Cette clé sera lue tel que décrit ci-dessus.

Ci-dessous le code pour un scanner Datalogic MAGELLAN™ 3410VSi configuré pour émuler un port COM :

Personnalisation d'un éventuel indicateur lumineux

Certains postes de scanning sont pourvus d'un indicateur lumineux (led) permettant d'afficher, selon la couleur, le statut de la caisse automatique. En général, ce dispositif est connecté via un port USB ou un port COM. Ce port peut être ajouté dans le fichier MercatorSelfScan.appsettings.json tel qu'indiqué ci-dessus. Un moyen simple est d'utiliser l'événement SendingToMonitor qui est levé en diverses circonstances pour envoyer des messages de statut à l'application MercatorSelfScanMonitor.

Ci-dessous un exemple de code compatible avec une caisse Toshiba permettant de spécifier la couleur de la led. Celle-ci présentera ces couleurs ;

• vert : caisse active
• orange : avertissement sur la caisse
• rouge : caisse nécessitant une intervention du personnel
• éteint : caisse non active

Ci-dessous un exemple de code compatible avec une caisse permettant seulement d'allumer et d'éteindre la led.

Exclure certains articles de la vente

Il s'avère souvent nécessaire ou obligatoire d'exclure certains articles du scanning autonome (par exemple l'alcool). Cette exclusion peut s'effectuer via un customizer placé sur la séquence de vente et qui répond à l'événement BeforeInsertItem. Via e.CancelInsertItem = true, il est possible d'empêcher l'insertion de cet article. La raison de cette exclusion pourra être placée dans la propriété billingEngine.TagString et sera affichée tant au client que via l'application MercatorSelfscanMonitor.

Ci-dessous un exemple de code. Il faut y noter le test sur cette condition 

if (Globals.IsMercatorSelfScan)

qui permet de déterminer si l'encodage a lieu dans MercatorSelfScan ou pas.