...
- https://github.com/EsupPortail/esup-sgc-client/releases/tag/esupsgcclient-v2.0 (Encodage manuel)
- https://github.com/EsupPortail/esup-sgc-client/releases/tag/esupsgcclient-r2d2-v2.0 (Encodage via le robot ZXP3)
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.
| Info |
|---|
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 -client demande une connexion shibboleth via une webview intégrée (identique à l'application mobile) et utilise un localstorage pour stocker les informations nécessaires.
...
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
git clone https://github.com/EsupPortail/esup-sgc-client.git git checkout -b esupsgcclient-univ-ville esupsgcclient-v2.13 |
Paramétrage
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
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
esupSgcUrl = https://esup-sgc.univ-ville.fr
esupNfcTagServerUrl = https://esup-nfc-tag.univ-ville.fr
encodeCnous = false
localStorageDir = /AppData/Local/EsupSgcClient/ |
Compilation esup-sgc-client
...
Si vous utilisez l'installateur windows, vous n'avez qu'à lancer le client depuis le raccourci créé par celui-ci, l'installateur embarque directement une distribution d'un openjdk et openjfx !proposés par la communauté Zulu !
Vous pouvez aussi utilise openJDK fourni depuis Sinon, sur vos postes, nous recommandons l'usage d'openJDK https://jdk.java.net et openJFX openJFX fourni depuis https://gluonhq.com/products/javafx/ (voir également https://openjfx.io/openjfx-docs/ ) qui sont des produits opensource et gratuits .également.
esup-sgc-client est compatible avec les JDK 9 et supérieurs. Depuis juin 2022, l'installateur windows embarque les versions JDK/JFX 18 packagées par Zulu (les dernières en date).
Suivant l'intégration de JAVAFX, la La commande à lancer est la suivante :
| Bloc de code | ||||
|---|---|---|---|---|
| ||||
java.exe --module-path %PATH_TO_FX% --add-modules javafx.controls,javafx.fxml,javafx.base,javafx.media,javafx.graphics,javafx.swing,javafx.web -Dcom.sun.webkit.useHTTP2Loader=false -jar esupsgcclient-shib.jar |
L'option "-Dcom.sun.webkit.useHTTP2Loader=false" donnée ici à titre indicatif permet de forcer l'usage de HTTP 1 et peut permettre d'éviter d'éventuels problèmes avec des serveurs web (apache) un peu anciens.
Précisions
Les installations d'openJDK et OpenJFX correspondent à dézipper leurs archives dans un répertoire donné.
...
Si vous utilisez cette commande au travers d'un raccourci windows (pour faciliter son usage c'est une bonne idée, et c'est ce que propose l'installateur windows que vous pouvez générer depuis https://esup-sgc-client-web-installer.univ-rouen.fr), n'oubliez pas également de préciser le répertoire d'exécution comme étant également C:\esup-sgc-client.
...