Esup-emargement permert d'émarger un individu en cochant une simple case.
Mais l'application est pensé à l'origine pour fonctionner avec l'application Esup-nc-tag : Esup-nfc-tag
Il faut donc configurer esup-nfc-tag pour que l'on puisse 'badger' une carte avec un lecteur NFC ou un smartphone.
Dans esup-nfc-tag-server, il faut rajouter au fichier applicationContext-custom.xml les lignes personnalisée suivantes :
<bean id="emargementJavaExtApi" class="org.esupportail.nfctag.service.api.impl.AppliExtRestWs">
<property name="isTagableUrl" value="https://esup-emargement.univ-ville.fr/wsrest/nfc/isTagable"/>
<property name="validateTagUrl" value="https://esup-emargement.univ-ville.fr/wsrest/nfc/validateTag"/>
<property name="getLocationsUrl" value="https://esup-emargement.univ-ville.fr/wsrest/nfc/locations"/>
<property name="displayUrl" value="https://esup-emargement.univ-ville.fr/wsrest/nfc/display"/>
<property name="description" value="Web Service Emargement-java test"/>
<!--property name="backgroundColor" value="rgb(121, 119, 0)"/-->
<property name="header" value="https://esup-emargement.univ-ville.fr/resources/images/logo.png"/>
</bean>
Voilà à quoi correspond chaque appel au WS Rest :
getLocationsUrl : Permet à esup-nfc-tag-client d'afficher la liste des lieux attribuée aux surveillant connectée que renvoie esup-emargement. Elle correspond à la liste des lieux de session qui ne sont pas clôturées et qui ont lieu le jour même.
isTagableUrl :
On retourne "true" Si :
- l'individu qui badge appartient à la bonne session et est dans la bonne salle.
- l'individu qui badge appartient à la bonne session et n'est pas dans la bonne salle.
On retourne "false" Si :
- l'individu qui badge est complètement inconnu de la session. Il est quand même enregistré dans esup-emargement avec un lieu initial de session nul.
- eppn non reconnu
validateTagUrl :
On met à jour en base le la date d’émargement, le lieu d’émargement de l'individu, ainsi que le fait quel 'émargement est un 'badgeage.
Comme dit précédemment, si l'individu est complètement inconnu, on insère celui-ci dans la liste initiale. Il est repéré grâce à iun "flag" spécial.
Pour le contrôle du tagId, on peut choir esup-sgc par example :
<bean id="tagIdCheckApiEsupSgc" class="org.esupportail.nfctag.service.api.impl.TagIdCheckRestWs">
<property name="tagIdCheckUrl" value="https://esup-sgc.univ-ville.fr/wsrest/nfc/tagIdCheck"/>
<property name="idFromEppnInitUrl" value="https://esup-sgc.univ-ville.fr/wsrest/nfc/idFromEppnInit"/>
<property name="description" value="via Esup SGC"/>
</bean>
displayUrl :
Permet d'afficher lors du badgeage la photo dans esup-nfc-tag. On l'active via les configurations du contexte