? Installation de PopinaK, Vérification de version, Mise à jour et Désinstallation

À l'ouverture du logiciel, une vérification est effectuée pour détecter si une version antérieure n'est pas présente sur votre réseau. En effet, si vous possédez plusieurs postes/caisses, il est important que les versions du logiciel soient toutes de la même version.

Deux contrôles peuvent êtres effectués :

Premier contrôle (Lors d'une installation ou Mise à jour) :

Une comparaison de la version du logiciel que vous êtes en train d'installer est effectuée avec celle mémorisée dans la table PARAM (colonne PARAM, champ KEZIA_Version - autant de lignes que de postes) :

• Si égale : pas de problème.
  
  

• Si la version mémorisée dans PARAM est antérieure à la version que vous installez, alors la version que vous souhaitez installer sera conservée (par exemple, vous souhaitez installez une version 16 et la version actuellement mémorisée est la 15).
  
  

• Si la version mémorisée dans PARAM est postérieure à la version que vous installez, alors un message d'erreur apparaîtra (par exemple, vous souhaitez installez une version 15 et la version actuellement mémorisée est la 16).

Nous vous conseillons de vous procurer la dernière version du logiciel et de recommencer.

Second contrôle (Au démarrage du logiciel) :

Une comparaison de la version du logiciel est effectuée au démarrage du logiciel avec les autres postes du magasin dans la table PARAM (colonne PARAM, champ KEZIA_Version - autant de lignes que de postes) :

• S'il existe un poste en défaut (version inférieure à celle inscrite dans PARAM - vous avez un poste utilisant la  version 16 et un ou plusieurs postes en version 15), un message vous indiquant que certains de vos postes ne sont pas mis à jours apparaîtra.
  
  

• Un bouton nommé "Détail de" vous permet d'afficher la liste des postes concernés.
  
  

• Le bouton "Copier l'erreur" vous permet de copier le message d'erreur dans le presse-papier de Windows.
  
  

Nous vous conseillons d'appeler rapidement le support (ou votre Agence) pour mettre à jour les postes concernés.

Ce chapitre décrit la mise à jour de PopinaK  en mode monoposte (c'est à dire sur un seul poste - cas du magasin qui n'a qu'une seule caisse).

Privilégiez la dernière version du logiciel disponible sur le FTP ! À nuancer en fonction du client, sachant que certaines versions nécessitent une mise à jour de tout le parc pour fonctionner correctement.

• Double-cliquez sur l'exécutable d'installation.

(!!!!!! toujours d'actualité?) Notez qu'il existe une version d'installation "non admin" qui permet de lancer le logiciel sur un poste administré. En effet, PopinaK doit normalement être exécuté en mode administrateur. C'est la version qu'il faut utiliser sur des postes où la session de l'utilisateur n'a pas de droits administrateur (par exemple en TSE).

La personne qui installe, en revanche, a les droits administrateur.

• Choisissez le répertoire où se trouve le dossier existant (généralement C:\PopinaK) :
  
  
• Une sauvegarde vous est proposée, vous devez la faire.
  • Les sous répertoires de base sauvegardes les sous-répertoires par défaut que le logiciel installe.
  • Tous les sous répertoires sauvegarde en plus les sous-répertoires que vous auriez pu créer ultérieurement.

La sauvegarde créera un dossier à la racine du disque dur (C:) qui reprendra le nom du répertoire PopinaK, en y ajoutant la mention "copie" ainsi que la date.

• La sauvegarde se fait (plus ou moins longue selon le volume de données).
  
  

• L'installation se poursuit.
  
  

• Un résumé de l'installation vous est proposé. Vérifiez (cliquez éventuellement sur Précédent en cas d'erreur) et cliquez sur Installer pour démarrer l'installation de la Mise à jour.

La désinstallation de PopinaK ne supprime pas la ou les base(s) de données crée(s). Pour ce faire, il faudra passer par l'explorateur Windows afin de supprimer manuellement le dossier C:\Serveur HF\BDD.

Pour Windows 10 :

• Cliquez sur  puis  (Raccourci : Touche Windows+i).
  
  

• Sélectionnez PopinaK dans la liste, puis cliquez sur Désinstaller.
  
  

• Cliquez sur Désinstaller dans la fenêtre de dialogue.
  
  

• Cliquez sur Terminer à la fin de la désinstallation.

Pour Windows 11 :

• Cliquez sur puis puis (Raccourci : Touche Windows+i).
  
  

• Cliquez sur Applications.
  
  

• Cliquez sur Applications Installées.
  
  

• Cherchez PopinaK dans la liste puis cliquez sur les points de suspension pour désinstaller.

Au démarrage du logiciel, une vérification de la date est effectuée. Plusieurs messages peuvent apparaître si le logiciel constate un écart entre la date du jour et la date de la dernière facture (ou la date Windows).

• La dernière date utilisée est incohérente avec la date système actuelle. Veuillez confirmer la date du jour :
  • En cas de coupure Internet + dernière facture datant de plus de 3 jours (et uniquement dans ce cas), cette fenêtre apparaît. Vérifiez et saisissez simplement la bonne date ou servez-vous du tactile en choisissant la date dans le calendrier. Vérifiez et faites OK pour lancer le logiciel.
  • Si la connexion Internet est rétablie, le logiciel vérifie la date et vous demande de confirmer.
    
    

• Attention, la date saisie est antérieure à la dernière facture :
  • Ici le logiciel vous prévient qu'il constate un écart entre la date système (Windows) et la date de la dernière facture. Cela pourrait se produire si un jour vous avez eu un plantage dans une version antérieure du logiciel et que malheureusement certaines factures auraient été saisies à une date postérieure. Si vous hésitez, appelez votre Agence.
  • Pour rétablir la bonne date, écrivez "CONTINUER" en capitales dans le champ et cliquez sur OK.

Cette fonction permet de lancer le logiciel en connectant directement l'utilisateur choisi. Vous n'aurez plus cette fenêtre de choix d'utilisateur au démarrage.

Le logiciel démarrera directement dans le menu principal (sauf exception, voir plus bas).

Pour l'activer, il vous faudra modifier le raccourci du logiciel présent sur le bureau, en y intégrant les identifiants (et mot de passe) de l’utilisateur souhaité :

• Faites un clic droit sur l'icône raccourci de PopinaK puis cliquez sur Propriétés :
  
  
• Par exemple, si l'on voulait se loguer directement en Superviseur, dans le champ Cible, il faudrait saisir :
  "PopinaK.exe" "AUTOLOG" -lance="0" -login="SUPERVISEUR" -pwd=""
  
  
• Dans cet exemple, le Superviseur n'a pas de mot de passe. Sinon, il faudrait le saisir après -pwd="
  • Si le mot de passe était par exemple 12345, cela donnerait :
    "PopinaK.exe" "AUTOLOG" -lance="0" -login="SUPERVISEUR" -pwd="12345".
    
    

En écrivant -lance="1", cela permet au logiciel de démarrer directement en caisse.

Dans le cas d'une installation multisite, veuillez suivre la procédure décrite dans le chapitre Procédure de création/ajout d'un site distant.

À chaque démarrage du logiciel, une vérification de connexion à Internet est effectuée via une requête HTTP. Si le résultat de cette requête est faux, la licence ne peut pas être vérifiée et une période d'essai de 20 jours est relancée.

Au premier lancement, une fenêtre d'identification d'intervenant s'affiche.

Elle sert à identifier le technicien qui intervient dans le logiciel. Une trace de ce qui à été fait sera conservée dans le Journal des Événements Techniques (J.E.T.).

Dans le cas d'une réinstallation (remplacement d'une caisse par exemple), veillez à supprimer les clefs de registre de la caisse sur laquelle vous allez installer le logiciel (bouton SOS - effacer les clefs).

Cela étant dit, le logiciel détectera le problème et vous demandera si vous voulez continuer ou arrêter. Soyez très vigilant : si vous continuez et que les infos de licence qui restaient dans la base correspondent à un client existant, vous effacerez sa licence....

Base de données : Une fois identifié, une fenêtre apparait vous permettant de configurer l'accès à la base de données. Renseignez les informations requises et Valider.

• Mode Autonome Possible : Permet d'activer le mode autonome pour la caisse. Si la connexion au serveur contenant la base de données est coupée, la caisse peut fonctionner seule et enregistrer des ventes.
  Si l'adresse du serveur contenant la base de données n'est pas locale (127.0.0.1 ou localhost) le Mode Autonome Possible est activé par défaut.
  Vous trouverez plus d'informations concernant le Mode Autonome dans le chapitre correspondant.
  
  
• Informations Société : Une deuxième fenêtre apparaît permettant de saisir les informations du commerçant qui apparaît au premier lancement du logiciel. Une connexion Internet est requise pour le contrôle des données saisies.
  Saisissez le code client et faites Entrée. Pour un nouveau client, une recherche par SIRET peut être effectuée (il faut être connecté à Internet). Si la recherche est infructueuse, la seconde fenêtre vous permettra de saisir les informations.
  Dans le cas d'une mise à jour, la seconde fenêtre apparaîtra avec les informations récupérées grâce au numéro de SIRET existant. Vérifiez-les (il est possible de les modifier) et confirmez les.

La fenêtre principale de Kezia II s'affiche :

• Vous trouverez sur le côté gauche la liste permettant d'accéder aux différentes fonctionnalités.
  
  
• Au centre vous trouverez des statistiques détaillées.
  
  
• En bas une barre d'informations vous montrant la version du logiciel, l'ip du poste, du serveur, la date de la dernière sauvegarde, la date et l'heure locales, le numéro de Site, les numéros de Poste et de Caisse et surtout, le nom de votre base de données.

Vous pouvez maintenant faire votre premier encaissement : Cliquez sur le bouton Caisse dans la fenêtre principale et sélectionner un Vendeur.

Pour plus d'informations sur le module Caisse, consultez le chapitre La Vente.

Voici la procédure pour installer un site distant  et le connecter au site 0 (site principal ou siège).

Veuillez consulter la documentation technique de Replicator avant toute installation de sites distants.

Il peut arriver que la caisse tactile ou le PC tombent en panne (crash disque dur par exemple) et qu'il faille restaurer les données du logiciel car la base de données n'est plus lisible.

Le client doit posséder une sauvegarde récente de sa base de données car il est censé en sauvegarder chaque jour l'intégralité sur un support amovible (clef USB, disque dur externe...).

• Récupérer la sauvegarde (il s'agit d'une archive au format zip nommé par exemple : Poste1_20170920_2025.ZIP) du client et décompresser son contenu.
  La sauvegarde contient la base de données, le répertoire des journaux des événements techniques de chaque poste 'KeziaIIPisteAudit' et le fichier 'PopinaK.xml' (ce fichier mémorise la taille et la position des fenêtres).
  
  

• Effectuer une copie du fichier 'PopinaK.xml' d'origine situé dans le dossier C:\PopinaK du nouveau poste ou du poste restauré.
  
  

• Recopier les répertoires 'KeziaII' et 'KeziaIIPisteAudit' (contenant respectivement la base de données et les pistes d'audit) situés dans le dossier 'C:\Serveur HF\BDD' du nouveau Poste ou du Poste restauré.
  

Voici la Liste des fichiers à récupérer en cas d'absence de sauvegarde :

• C:\PopinaK (contient la version de l'exécutable, les états, les bibliothèques et le fichier kezia.xml).
  
  
• C:\Serveur HF\BDD (contient la base de données et le répertoire des pistes d'audit de chaque caisse).
  
  
• La table Réseau qui contient le numéro de poste lié à la licence de l'application ! Ce numéro est lié à l'adresse Mac de la carte réseau.
  En cas de remplacement de matériel, la correspondance entre le numéro de la caisse et l'adresse MAC ne se fera plus, rendant impossible le lancement du logiciel.
  Pour réattribuer le numéro de Poste au nouveau PC, il sera nécessaire d'effacer (remise à blanc) le champ AdresseMAC de la table Réseau.
  
  
• La table Param qui contient toutes les informations clients (SIRET, adresse, e-mails, en-têtes, options dans le logiciel,...).
  
  
• La clef de sérialisation de la base de registre qui se trouve à l'emplacement suivant : HKEY_LOCAL_MACHINE -> SOFTWARE -> WOW6432Node -> KeziaII.
  Sa suppression entraîne une demande de sérialisation au lancement de l'application.

Pour l'installation de PopinaK, se référer au chapitre Installation de PopinaK en Mono-Poste.

Au lancement du logiciel, l’application contrôle la présence d’une clé de registre dans le système. Si celle-ci est absente, la procédure de sérialisation démarre.

À la fin de la procédure, les données d’identification du client sont écrites sur un serveur distant.

Mécanisme de Contrôle et Types de Licences :

On en distingue deux types de licences : Location et Achat. 

Elles sont temporaires au moment de l’installation et devront être validées dans un second temps.

• En location : Licence temporaire de 20 jours renouvelable une fois (40 jours en tout). Chaque période de 20 jours est elle-même divisée en deux périodes de 10 jours.
  Ensuite, le poste devra se connecter au serveur de licences au moins une fois tous les 90 jours.
  
  
• Achat : Licence temporaire de 20 jours renouvelable une fois (40 jours en tout). Chaque période de 20 jours est elle-même divisée en deux périodes de 10 jours.
  Une fois la licence validée, plus aucun contrôle ne sera effectué sur le serveur de licences.

Les données d’identification du client sont :

• Code Client + Nom du Client.
• Localité.
• Adresse e-mail.
• Numéro de site + Numéro de poste.
• SIRET.
• Type de licence (Location ou Achat).
• Version de l’exécutable de Kezia II.
• Numéro de série du disque dur.
• Date / Heure de la connexion.

Si la clé de registre recherchée est présente dans le système, des contrôles visant à déterminer la validité de la sérialisation sont réalisés. Si ces contrôles passent, le logiciel s’exécute.

Fonctionnement :

• A la fin de la première période de 10 jours (le onzième jour), un message non bloquant demandera au commerçant d’appeler le service technique. Ce message s’affichera pendant les 10 jours suivant, au démarrage du logiciel et à l’ouverture du module Caisse. 
  

• À la fin de la seconde période de 10 jours, le commerçant ou un technicien peut demander un renouvellement de 20 jours supplémentaires.
  
  

• À la fin de la seconde licence de 20 jours, seul un technicien pourra refaire une demande.
  
  

• La validité finale de la licence sera déterminée par le contrat de location.
  
  

• Lorsque la licence est validée, un message d’activation apparaît au démarrage du logiciel

Les licences émises à l’installation (Location ou Achat) sont toujours temporaires. Elles doivent ensuite être validées par le service compétent.

(!!!!!! pas sûr, a voir une fois en prod) Procédure de Sérialisation : Sérialisation "mode commerçant" :

Si une erreur est détectée dans le système de sérialisation, il vous est possible d’obtenir une licence temporaire permettant de démarrer le logiciel. Cette demande de licence est « vue » côté serveur et validée (ou refusée le cas échéant).
La transformation de licence temporaire en licence définitive est totalement transparente. Seul un message d’information apparaîtra au démarrage du logiciel.

Si une erreur de sérialisation est détectée, un message "Un problème est détecté sur la licence" s’affichera au démarrage du logiciel.

a développer / captures temporaires

Une connexion intervenant sera nécessaire.

L'intervenant se connectera via le service KCloud : https://wakclouddevauth.azurewebsites.net/device, puis renseigner le code de connexion affiché précédemment.

!!!!!! possibilité de migration kezia v9 / v10 -> PopinaK ?

Il est possible de passer une version 9 de Kezia II mono-site en version 10 de façon transparente.

Avertissements :

• Réservé aux sites ne répliquant pas ! NE PAS migrer en multi-site (ne peut se faire que dans une configuration mono-site).

  • Pensez à mettre à jour les bibliothèques (les bibliothèques de la v9 doivent être remplacées par des versions 10) !

    • La licence doit être un code client unique : il doit être en monosite et la vérification se fait dans la table LicenceClient.fic (champs ClientCode, ClientLocalite et NumSite).

    • Le même ClientCode ne doit pas être affecté à plusieurs localités.

Prérequis :

• Commercer par le poste contenant la BDD (une fois la migration faite, installer la v10 sur les postes connectés).

• Le dossier de l'exécutable doit être C:\KeziaII.

• Le dossier de la base de données doit être C:\Serveur HF\BDD\KeziaII.

• Aucun ticket ne doit rester en attente (traiter ces tickets ou vider la table). S'il en reste, la migration ne démarrera pas.

• Vérifiez que le Centre de Contrôle est fermé avant de commencer.

Procédure :

Il faut lancer le (dernier) setup de la v10 et pointer sur le dossier de l'exe de la v9 (C:\KeziaII) :

Démarrer l'installation (Suivant).

Une sauvegarde complète sera automatiquement effectuée dans le répertoire indiqué :

Finir l'installation en ne cochant aucune case à la fin.

Lancer le nouvel exécutable v10 dans le dossier C:\KeziaII

Dans ce même dossier, vous noterez la présence d'un répertoire Archive_v9 contenant l'ancienne version 9 de Kezia II qui demeure consultable en lecture seule (aucune vente possible). Elle n'affichera que les documents existants. Il suffit de lancer l'exécutable KeziaII.exe contenu dans ce dossier.

La version 10 quant à elle, affichera les documents datant de l'année en cours + deux ans.

• Lancez Kezia II depuis le nouvel exe : 

• Vous devrez vous connecter en Intervenant :

• Vous verrez ensuite cette fenêtre récapitulative :

• Il faudra préciser la forme juridique et le SIREN (car ces données n'existent pas nativement en v9).

• Validez, vous arrivez sur cette fenêtre :

• Cliquez sur Migrer. Des mises à jour vont se faire puis vous arriverez sur cette fenêtre :

• Faites Démarrer la Copie et la migration commence.

Ensuite, quand vous lancerez la version 10, il faudra compléter les en-têtes et pieds de tickets.

RETOUR EN ARRIÈRE :

• Si vous avez fini la migration :

  • Supprimer dans C:\Serveur HF\BDD le dossier KeziaII, puis renommer KeziaII_V9 en KeziaII.

• Si vous n'avez pas encore lancé la migration (vous n'avez pas appuyé sur le bouton Démarrer la Copie) :

  • Cliquez sur Abandonner.

  • Supprimez tout dans C:\KeziaII.

  • Dézippez dans C:\KeziaII, le .zip situé dans C:\KeziaII_copie_AAAAMMJJ.

  • Vérifier en lançant KeziaII v9.

  • Si tout est OK, supprimez C:\KeziaII_copie_AAAAMMJJ et refaire le bon raccourci sur le bureau (celui qui pointe vers l'exe d'origine).

PopinaK peut s'utiliser conjointement avec des Bibliothèque permettant de débloquer/rajouter certaines fonctionnalités.

• bibClavierTactile_version_1.00Ai.WDL :Permet de faire apparaître un clavier tactile lorsque l'on double-clique dans un champ texte de Kezia II.
  
  
• bibBalanceSM5100_version_11.20180920-6.wdl : Permet de gérer les balances SM120, SM5100 et SM5300 avec Scalink pour les relier à Kezia II.
  
  
• KII_bib_FonctionsMCU_V10_WD20.wdl : Permet de générer des MCU préenregistrées à l'aide un clic droit (voir le chapitre concernant les Macro Codes Utilisateurs).
  
  
• bibInfoChamp.WDL : Permet de connaître le nom d'une fenêtre dans Kezia II (réservé aux techniciens).
  
  
• bibBalanceDigiManager_V2_version_12.20190502-7 : Permet de relier des balances entre elles (et in fine à Kezia II) via DigiManager.