esup-sgc-client correspond au client esup-sgc/esup-nfc-tag permettant après impression de la carte à
2 clients esup-sgc-client sont proposés depuis le dépot git https://github.com/EsupPortail/esup-sgc-client :
Par rapport à leurs versions 1.0, ces clients ont été créés pour sortir du système Java Web Start (fichier JNLP) qui est en cours d’abandon par JAVA.
Il est nécessaire d'utiliser une version 2.2 (ou supérieur) d'Esup-NFC-TAG-Server pour faire fonctionner le client 2.0 |
Le lancement par jnlp nous permettait de passer les paramètres d'encodage à l'application (notamment le numéro Id du périphérique et les urls d'esup-sgc et esup-nfc-tag). Avec la nouvelle application on récupère maintenant un jar que l'on peut lancer directement. Au passage, l'application n'a plus besoin d'être signée. L'établissement qui met en place cette nouvelle application doit par contre la packagée elle-même, ce pour pouvoir y renseigner les urls esup-sgc et esup-nfc-tag de ses propres serveurs.
La nouvelle application demande une connexion shibboleth via une webview intégrée (identique à l'application mobile) et utilise un localstorage pour stocker les informations nécessaires.
L'application doit pouvoir écrire un fichier localstorage qui se situe :
|
Pour que le client Esup-Sgc-Client voit l'application d’écriture SGC configurée dans Esup-NFC-TAG-Server, il faut que l'option "Visible" soit cochée dans l'interface d'Esup-NFC-TAG-Server. |
L'application nécessite :
La webcam est placée pour filmer le lecteur de carte (procéder à la mise au point si besoin). Lorsqu'une carte est posée sur le lecteur de carte, la webcam détecte le QR code et la procédure d'encodage démarre
Documentation de mise en œuvre ESUP-SGC / ESUP-NFC-TAG#SGC/ESUP-NFC-TAG-Installationmaterielle
Le plus rapide est de récupérer le jar esup-sgc-client et/ou l'installateur windows depuis https://esup-sgc-client-web-installer.univ-rouen.fr/
Vous pouvez le packager/builder vous même également cependant, cf ci-dessous.
git clone https://github.com/EsupPortail/esup-sgc-client.git git checkout -b esupsgcclient-univ-ville esupsgcclient-v2.1 |
Il faut modifier le fichier src/main/resources/esupsgcclient.properties pour y mettre vos adresses esup-nfc-tag-server et esup-sgc et activer ou non l'encodage CNOUS
esupSgcUrl = https://esup-sgc.univ-ville.fr esupNfcTagServerUrl = https://esup-nfc-tag.univ-ville.fr encodeCnous = false |
Dans le dossier esup-sgc-client executer :
mvn clean package |
Pour disposer du jar au sein du site ESUP-SGC :
Copier le fichier esupsgcclient-2.1-jar-with-dependencies.jar en le renommant esupsgcclient-shib.jar dans la webapp esup-sgc ou dans vos sources sous src/main/webapp/ avant de compiler esup-sgc
pour le client zxp3 le fichier doit être renommé esupsgcclient-r2d2-shib.jar.
Si vous utilisez l'installateur windows, vous n'avez qu'à lancer le client depuis le raccourci créé par celui-ci, l'installateur embarque directement un openjdk et openjfx !
Sinon, sur vos postes, nous recommandons l'usage d'openJDK https://jdk.java.net et openJFX https://gluonhq.com/products/javafx/ (voir également https://openjfx.io/openjfx-docs/ ) qui sont des produits opensource et gratuits.
La commande à lancer est la suivante :
java.exe --module-path %PATH_TO_FX% --add-modules javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web -jar esupsgcclient-shib.jar |
Les installations d'openJDK et OpenJFX correspondent à dézipper leurs archives dans un répertoire donné.
Sur un poste windows, on peut par exemple les dézipper dans un répertoire C:\esup-sgc-client, on aura ainsi
En plaçant le JAR d'esup-sg-client (esupsgcclient-shib.jar) dans ce même répertoire C:\esup-sgc-client on peut ainsi finalement exécuter le JAR ainsi :
C:\esup-sgc-client\jdk-12.0.1\bin\java.exe --module-path C:\esup-sgc-client\javafx-sdk-12.0.1\lib --add-modules javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web -jar C:\esup-sgc-client\esupsgcclient-shib.jar |
Si vous utilisez cette commande au travers d'un raccourci windows (pour faciliter son usage c'est une bonne idée), n'oubliez pas également de préciser le répertoire d'exécution comme étant également C:\esup-sgc-client.
A l'exécution ce client esup-sgc-client esupsgcclient-shib.jar écrit en effet 2 fichiers dans le répertoire courant :
Esup-sgc-client-zxp3 est l'application permettant d'encoder les cartes Mifare Desfire dans le cadre du Système de gestion de carte Esup-sgc. Elle est identique à Esup-sgc-client mais elle utilise une imprimante Zebra ZXP3 pour automatiser l'encodage.
L'application nécessite :
La webcam est placée dans l'imprimante (qui reste ouverte) pour filmer le lecteur de carte. Il faut donc placer quelque chose dans le capteur de fermeture du couvercle. voir : https://www.esup-portail.org/wiki/pages/viewpage.action?pageId=613384398
Via les outils du driver (sous windows "Propiétés de l'imprimante > Device Settings > Tools > Command to send to printer") lancer la commande : +OS 0
réponse : 0 <ACK>
git clone https://github.com/EsupPortail/esup-sgc-client.git git checkout -b esupsgcclient-r2d2-v2.0 esupsgcclient-r2d2-v2.0 |
1.Installation des dépendances ZSDK_API et ZSDK_CARD_API
Pour communiquer avec la Zebra ZXP3 esup-sgc-client-zxp3 utilise le SDK Zebra. Pour fonctionner il est installé en tant que depot maven local.
Le sdk se récupère à cette adresse : https://www.zebra.com/fr/fr/products/software/barcode-printers/link-os/link-os-sdk.html
Après l'installation du mpsdk-installer, vous pouvez ainsi récupérer et copier les deux jar présents dans le dossier link_os_sdk/PC-Card/v2.12.3968/lib :
Pour la compilation avec maven, copier tout le dosier com situé dans src/lib dans le dossier ~/.m2/repository
2.Compilation maven
Depuis le répertoire source on lance :
mvn package |
Vous pouvez alors renommer target/esupsgcclient-r2d2-2.1-SNAPSHOT-jar-with-dependencies.jar en esupsgcclient-r2d2-shib.jar.
Sur le poste client il vous faut également indiquer dans le path le répertoire link_os_sdk/PC-Card/v2.12.3968/lib en plus du répertoire bin de votre JDK+JFX Zulu - voir copié d'écran :
Avec JDK+JFX Zulu, et en valuant ainsi votre PATH, vous n'avez plus qu'à lancer le jar ainsi :
java -jar esupsgcclient-r2d2-shib.jar |
Note : documentation du SDK : http://techdocs.zebra.com/link-os/2-12/
Voir Configuration / paramétrage
voir la FAQ : FAQ
L'application esup-cnous-client permet la lecture et l'encodage de l'application CNOUS sur une carte préalablement configurée (application desfire F58540 déjà présente)
Pour un fonctionnement avec le client esup-sgc-client, l’exécutable doit être copié dans le dossier c:\cnousApi du poste sur lequel sera lancé l'encodage. De plus, l'application nécessite la présence de 4 librairies dans ce même dossier:
la version de la dll cnous doit etre x64
git clone https://github.com/EsupPortail/esup-crous-client.git |
Pour compiler la solution il suffit de télécharger la dernière version de Visual Studio Community (https://www.visualstudio.com/fr/downloads/) ainsi que le framework .net version > 2