Mobilité logistique - Principe et mise en oeuvre

Pré-requis

Divalto côté serveur

Depuis la version 10.5 (2020), une interface Web est disponible et exploite l'interface Web utilisée par un client léger HTML (LCWeb / HTML5).

Pour fonctionner dans ce mode, il faut avoir installé le Client léger Harmony Web pour permettre la connexion à l’ERP via un navigateur

Le pare-feu devra être aussi ouvert sur le port choisi.

L’usage de Harmony en version 411a minimum est recommandé.

En utilisation HTML5 (terminal ou poste), l’usage de l’agent d’impression est un pré requis que l’on soit en installation Saas ou On Premise. Son usage peut tout de fois être limité et simplifié dans son paramétrage en imprimant les étiquettes par un outil déporté, type Nice Label. Il reste dans ce cas les impression laser à faire transiter par l’agent d’impression.
Dans ce cadre, aucun aperçu avant impression n’est possible en imprimant sur un modèle d’imprimante lié à un agent d’impression.

En mode Saas, le serveur de client léger est déjà installé et configuré, ainsi que l’agent d’impression côté serveur. Il n’y a donc pas de mise en œuvre côté serveur Divalto. En OnPremise par contre, c’est à faire.

En OnPremise, comme en mode Saas, il faut installer l’agent d’impression sur le site client. Plus d’informations ici : Paramétrage de l'agent d'impression

Le masque A5ee_tnt_interface.dhsf doit posséder un “nom pour la sélection” sur le bouton de déconnexion. Fourni avec les versions maintenues de Divalto, il nécessitera à défaut une surcharge simple par l’intégrateur dans les versions antérieures de l’ERP. Ce point est expliqué plus bas.

Terminal et client WEB

https://www.wavelink.com/download-velocity_enterprise-app-modernization-software/

Une configuration est fournie dans cette page.

Principe : connexion et licences

 

Les écrans sont adaptés pour gérer des écrans graphiques (Tableau, Zoom, Saisie de champs etc…) avec une taille et des touches de fonctions adaptées

 

Exemple du menu principal C&L en mode graphique pour terminal mobile :

Informations complémentaires

  • Les menus “Démo” qui peuvent apparaitre au menu sont des exemples pour le développement uniquement. Consultez les informations concernant le développement terminal mobile pour plus d’informations

  • Parser un code barre GS1-128 ne fonctionne pas en client léger Divalto. Il faut impérativement se connecter :

    • sur un poste Windows, avec le client Web (navigateur Chrome..) ou le client Velocity pour Windows

    • ou sur un terminal avec le client Velocity (Telnet ou Web)

  • Telnet VS HTML5

  •  

    • Les traitements “telnet mobile” de la famille “Gestion commerciale, logistique avancée” ont été initialement développés pour les deux modes (caractère et html), ce qui explique le fait que les écrans existent en deux versions.

      • Par exemple

        • gteerf002.dhsi => écran en mode caractère

        • gteerf002.dhsf => écran en mode wpf

    • Les traitements existants en X.5 pour un mode “telnet caractères” sont donc disponibles en mode graphique HTML 5.

    • Historiquement, le WMS était exclusivement disponible en Telnet, et a lui aussi été migré en HTML5

    • cependant, depuis la version X.11, des évolutions sont uniquement réalisées sur la technologie HTML5 et ne seront pas portées en Telnet. Ceci est vrai pour C&L et le WMS.

Paramétrage ERP

Par défaut, ces deux menus ne sont pas activés :

image-20240129-152249.png

Il conviendra d’activer le (ou les) menu(s) dont vous avez besoin : G3f(u).

Configuration côté Client

  • Pour un PC Windows : navigateur internet, ou le client Velocity pour Windows de l'éditeur Ivanti.

  • Pour un terminal, il vous faut impérativement

    • un terminal sous Android

    • le client Wavelink Velocity for Android ARM Devices en version minimum 2.1.33.

    • une url d’accès

    • une configuration particulière dans le client Velocity

Génération de l’url

Des exemples sont fournis dans le dossier /divalto/Exemples/AppelProgrammeViaUrl.

Le fichier HTML permet de générer une url d’accès au base 64. C’est cette url générée qu’il conviendra de mettre en favori (Windows), ou dans la configuration de Velocity.
Le fichier .JS javascript doit être présent dans le dossier du fichier HTML pour que la génération du fichier fonctionne.

<html> <head> <title>Divalto</title> <script type="text/javascript" src="jquery-2.1.1.min.js"></script> </head> <body> <script type="text/javascript"> $(document).ready(function () { var url = 'http://localhost:8080/lcweb/default.aspx'; url += "?urlDivaMode=1&"; url += "urlDivaParamc="; var pp = ""; pp += "urlDivaProgram=ia.dhop&"; pp += "urlDivaParams=[LaunchProgram]{_Application}DAV{_Regroupement}FIC{_Ordre}10[numero_commande]12345"; // codage en base 64 if (window.btoa) { url += encodeURIComponent(window.btoa(pp)); } else { url += encodeURIComponent($.base64.encode(pp)); } document.write("<a href=\"" + url + "\">" + url + "</a>"); }); </script> </body> </html>

Seul le fichier HTML est à personnaliser :

  • modifier le nom du serveur

  • urlDivaMode=2 pour gérer correctement la connexion et reconnexion en mode terminal avec Velocity

  • la section LaunchProgram pour ouvrir le bon menu (Terminal C&L, Terminal WMS...).
    Attention ce menu doit être actif pour que cela fonctionne. On modifie la ligne dans le fichier en indiquant :

    urlDivaProgram=ia.dhop&urlDivaParams=[LaunchProgram]{_Application}DAV{_Regroupment} DMTW {_Ordre} 10

    va rediriger vers menu applic « DAV » – Regroupement « DMTW » - Ordre d’affichage « 10 » et on vérifie que la choix est actif.

  • forcer une taille d'écran
    Pour une taille d'écran optimale, on ajoutera une option à l’url de connexion depuis le terminal : « viewport=width=320px » afin de gérer la largeur de l’écran. Exemple :
    http://localhost:8080/lcweb/default.aspx?viewport=width=320px

  • ajouter en fin d’url un paramètre &end=1 . Note importante : il n’existe pas réellement de paramètre ‘end’, il est fictif, mais cela permet de contourner des erreur d’encodage/décodage base64 spécifiquement en mode mobile ; il doit donc impérativement être placé à la fin.

     

Exemple complet du contenu d’une page HTML pour accéder au WMS dans le cloud (pour l’utiliser, créez un fichier .HTML, éditer avec un bloc-notes et copier le contenu ci-après) (

<html> <head> <title>Divalto</title> <script type="text/javascript" src="jquery-2.1.1.min.js"></script> </head> <body> <script type="text/javascript"> $(document).ready(function () { var url = 'https://webapp.divaltocloud.com/lcweb/default.aspx?viewport=width=320px'; url += "&urlDivaMode=2&"; url += "urlDivaParamc="; var pp = ""; pp += "urlDivaProgram=ia.dhop&"; pp += "urlDivaParams=[LaunchProgram]{_Application}DAV{_Regroupement}DMTW{_Ordre}20"; // codage en base 64 if (window.btoa) { url += encodeURIComponent(window.btoa(pp)); } else { url += encodeURIComponent($.base64.encode(pp)); } url+="&end=1" document.write("<a href=\"" + url + "\">" + url + "</a>"); }); </script> </body> </html>

En résumé, vous modifierez les deux éléments en jaune en fonction de votre contexte :

En ouvrant ce fichier HTML5, vous obtenez un URL :

Vous remarquerez que pour changer uniquement le nom du serveur, vous pouvez simplement le faire en modifiant librement l’url obtenue sans remodifier le script de génération.

Voici le script de connexion au Saas Divalto sur le fonctionnel C&L mobilité :
https://webapp.divaltocloud.com/lcweb/default.aspx?viewport=width=320px&urlDivaMode=2&urlDivaParamc=dXJsRGl2YVByb2dyYW09aWEuZGhvcCZ1cmxEaXZhUGFyYW1zPVtMYXVuY2hQcm9ncmFtXXtfQXBwbGljYXRpb259REFWe19SZWdyb3VwZW1lbnR9RE1UV3tfT3JkcmV9MTA%3D&end=1

Voici le script de connexion au Saas Divalto sur le fonctionnel WMS :
https://webapp.divaltocloud.com/lcweb/default.aspx?viewport=width=320px&urlDivaMode=2&urlDivaParamc=dXJsRGl2YVByb2dyYW09aWEuZGhvcCZ1cmxEaXZhUGFyYW1zPVtMYXVuY2hQcm9ncmFtXXtfQXBwbGljYXRpb259REFWe19SZWdyb3VwZW1lbnR9RE1UV3tfT3JkcmV9MjA%3D&end=1

Déconnexion du terminal

Pour que la déconnexion se passe correctement, il y a deux choses :

  • le bouton de déconnexion sur le masque Divalto doit avoir un “nom pour la sélection” : _rf_disconnect (ne pas oublier le underscore devant)
    Dépendant de la version de l’erp, s’il n’y est pas, il faut surcharger ce masque et indiquer ce nom.

  • Le projet Velocity devra contenir un script qui sera exécuté lors du clic sur ce bouton.
    Voici un projet à personnaliser avec Velocity Console, mais qui contient le nécessaire au bon fonctionnement :

    • Menu WMS :

    • Menu C&L :