...
Le QR-Code européen consiste en une url dans laquelle on retrouve l'url d'accès au serveur ESC http://esc.gg/ suivi d'un numéro de carte 'ESCN' qui est un identifiant codé en hexadécimal, formaté pour une meilleur lecture avec des - supplémentaires.
Exemple : d88b02c1-894e-1038-a711-001999465982
Cet ESCN est construit pour être unique, ESUP-SGC utilise directement la librairie escn-generator disponible depuis les repositories centraux de maven (le code source y est également donné) : https://search.maven.org/artifact/eu.europeanstudentcard/escn-generator
Cet identifiant de carte est construit via l'heure système suffixé d'un code qui correspond au pic de l'établissement lui-même préfixé par un numéro supplémentaire.
Dans l'exemple de d88b02c1-894e-1038-a711-001999465982 on retrouve ainsi le code pic 999465982 de l'Université de Rouen Normandie.
On note que la "version" hexadecimal correspond à d88b02c1894e1038a711001999465982, soit une chaîne hexadecimale de 16 octets.
...
On active l'utilisation du QR-Code européen (en lieu de l'usage de l'EPPN en tant que QR-Code) en allant dans l'interface web, "Admin" > "Configurations" > "QRCODE_ESC_ENABLED" que l'on doit mettre à true.
...
Pour proposer à certains "userType" (populations) d'utilisateurs d'activer leur carte dans ESCR, il faut renseigner le paramètre DISPLAY_FORM_EUROPEAN_CARD dans l'interface web, "Admin" > "Configurations".
Le paramètre ENABLE_EUROPEAN_CARD permet quant à lui de sélectionner les userType pour lesquels on active par défaut la carte dans ESCR.
Générer un token d'API
- Se connecter sur https://router.europeanstudentcard.eu
- Sélectionner "Organisations" sur le menu de gauche
- Dans le tableau qui s'affiche, cliquez sur l'icône "oeil"
- Dans le tableau API tokens, cliquer sur "+ ADD", nommez-le ("esup-sgc" par exemple) et mettez une date lointaine, sauf si vous souhaitez le changer régulièrement
- Le token s'affiche une seule fois, reportez le dans la configuration du bean europeanStudentCardService (key)
Nouveau logo ESC
En 2024, l'hologramme ESC a été abandonné au profit d'un nouveau logo à imprimer au niveau du QR-Code.
Voir : https://erasmus-plus.ec.europa.eu/news/new-european-student-card-logo-a-fresh-look-for-improved-access-to-student-services
ESUP-SGC embarque les différentes déclinaisons de ce logo - cf https://github.com/EsupPortail/esup-sgc/tree/master/src/main/webapp/images/esc-logo
Pour les intégrer dans vos templates, vous pouvez modifier la CSS de votr thème de carte (Admin < Thèmes de cartes) en gardant à l'esprit que lors d'une édition en 1 temps,
- le "#right img" (ainsi que #right::after et #right::before depuis esup-sgc 2.6.1) est caché pour le panneau noir
- alors que le "#left p et #left img" (ainsi que #left::after et #left::before depuis esup-sgc 2.6.1) sont cachés pour les panneaux couleurs.
Aussi, imprimer le logo en noir et blanc par exemple est relativement simple car on peut s'appuyer sur l'image du qr-code qui est également imprimé en noir et blanc :
| Bloc de code | ||
|---|---|---|
| ||
#specimenCarte #qrcode {
position: absolute;
padding-top: 0.4cm;
background-repeat: no-repeat;
background-position-y: 0cm;
background-size: 1.8cm auto;
background-image: url(/resources/images/esc-logo/esc-logo-vertical-bw.svg);
bottom: 0.1cm;
width: 1.8cm;
right: 0.1cm;
} |
Imprimer le logo en couleur est peu plus compliqué car il faut s'appuyer sur le bloc #right, qui n'est pas caché (édition 1 temps) par ./src/main/webapp/WEB-INF/views/manager/print-card-b64.jspx
On peut écrire :
| Bloc de code | ||
|---|---|---|
| ||
#specimenCarte #right:after {
background-image: url("/resources/images/esc-logo/esc-logo-vertical-color.svg");
background-size: 1.8cm;
background-repeat: no-repeat;
display: inline-block;
width: 1.8cm;
height: 0.5cm;
content: '';
top: 3cm;
left: 6.65cm;
position: absolute;
} |