Présentation
Esup-papercut est une (petite) portlet affichant les informations du compte Papercut de l'utilisateur.
Papercut est un outil payant de gestion d'impressions. Il propose notamment une gestion de quotas d'impressions.
En plus d'afficher le nombre d'impressions et le quota restant, esup-papercut permet à l'utilisateur de recréditer son compteur Papercut, ce via un paiment Paybox.
Paybox est un service de paiement en ligne (commercial) permettant de se décharger de la procédure de paiement en ligne via cartes bancaires, e-carte bleues, comptes paypal et autres.
Éléments requis
Pour fonctionner, esup-papercut requiert :
- la solution Papercut
- que celle-ci soit installée et en production dans l'établissement,
- que celle-ci utilise des comptes dont les identifiants sont connus dans l'ENT,
- que son Web Service soit accessible depuis l'ENT - IP déclaré dans le back-end papercut et token d'authentification connu de esup-papercut
- un compte paybox
- des paramètres d'identification de ce compte doivent être renseignés dans esup-papercut
Configurations
Papercut / Paybox
Le fichier src/main/resources/META-INF/spring/applicationContextEsupPapercut.xml permet de rentrer les configurations nécessaires à la fois à Papercut et Paybox.
esup-papercut peut être publiée plusieurs fois dans le portail avec des configurations différentes (un esup-papercut de test et un de production par exemple).
Aussi la préférence portlet paperCutContext (test par défaut dans portlet.xml) doit correspondre à une "key" de la "map" esupPaperCutServices dans src/main/resources/META-INF/spring/applicationContextEsupPapercut.xml
Les préférences portlet (issues de portlet.xml) permettent également de configuer :
- papercutUserUidAttr : attribut correspondant à l'identifiant de l'utilisateur dans papercut
- userEmail : non utilisé pour l'instant
- paperCutContext : la configuration papercut/paybox à utiliser - voir paragraphe ci-dessus.
- validatePayboxJustWithRedirection : permet de valider le paiement paybox via l'interraction navigateur client -> ENT (en plus de paybox -> ENT) : nous conseillons de le laisser à false en production.
- esupPapercutAdmin : groupe de l'ENT ayant accès à l'historique des transactions de tous les utilisateurs.
Base de données
esup-papercut utilise une base de données pour stocker (historiser) l'ensemble des transactions effectuées par l'utilisateur.
La configuration est à effectuer dans src/main/resources/META-INF/spring/database.properties
La base créée, la construction de la table peut se faire en démarrant une première fois esup-papercut avec dans src/main/resources/META-INF/persistence.xml le paramètre hibernate.hbm2ddl.auto à create.
Une fois ce premier démarrage effectuée et donc la table créée, remettez hibernate.hbm2ddl.auto à update (afin que la base ne soit pas écraser à chaque redémarrage !).
Copies d'écran