EsupHelpdeskViewer est une portlet JSR168 d'accroche présentant sommairement les derniers tickets apparus dans l'application Esup Helpdesk.
Elle a vocation à être affichée dans un ENT type EsupPortail / uPortal.
Elle propose une vue spécifique mobile.
Elle utilise EsupCommons V2 (et sa structuration en modules maven).
Compatibilité
EsupHelpdeskViewer (1.0.0) requiert un esup-helpdesk en version 3.28.5 ou supérieur.
Pour un comportement optimal on recommande cependant l'usage de EsupHelpdesk 3.29.7.
La version 1.1.0 à venir (prévue pour fin janvier) requerra un EsupHelpdesk 3.29.7 (ou supérieur).
Téléchargement
Nous proposons actuellement le téléchargement de la version 1.0.0
https://sourcesup.cru.fr/frs/?group_id=889
Sources
Entrepôt SVN : https://subversion.cru.fr/helpdeskviewer
Le trunk est la branche de travail.
Installation
Après avoir récupéré le war de la portlet, on peut lancer une commande similaire à celle-ci depuis EsupPortail/uPortal :
ant deployPortletApp -DportletApp=/home/esup/esup-helpdeskviewer.war
Configurations
Actuellement, la configuration de cette portlet se fait simplement lors de sa publication dans le portail, on peut donc saisir les configurations via l'interface graphique proposée par EsupPortail/uPortal.
La configuration minimale est de renseigner (surcharger) la préférence wsdlLocation en y indiquant l'url du Web Service de votre esup-helpdesk.
Attention: il vous faut au niveau d'esup-helpdesk renseigner comme il se doit la propriété webService.authorizedClientNames afin que le portail (et donc la portlet esup-helpdeskviewer) puisse contacter le WS de votre esup-helpdesk.
En rendant les préférences defaultUserView et defaultFilter éditables (pour l'utilisateur) [ces préférences sont configurées par défaut en read-only], la portlet sauvegardera le choix de vue de l'utilisateur dans la base de données uPortal (via les préférences utilisateurs du portail). Cela permet ainsi à l'utilisateur de retrouver son choix de vue entre 2 sessions ; cela implique cependant des accès base de données lecture/écriture à chaque changement de vue de l'utilisateur ; cette possibilité est donc désactivée par défaut via la contrainte read-only sur les préférences defaultUserView et defaultFilter.
Si vous devez changer la préférence userUidAttr (positionnée par défaut à "uid") permettant de récupérer l'identifiant de l'utilisateur via le portail et ainsi l'utiliser comme identifiant utilisateur d'esup-helpdesk, vous devrez vous assurer que celui-ci se trouve bien en tant que user-attribute dans le fichier portlet.xml de esup-helpdeskviewer.
Si vous utilisez esup-helpdesksviewer pour interroger un WS venant d'un heldesk déployé en mode portlet vous devez mettre dans la préférence portletFname le fname de votre helpdesk.
Vous pouvez également choisir d'ouvrir un lien directement dans la même page en mettant la valeur "null" pour la préférence target (utile en mode portlet).
Captures d'écran
Voici quelques captures d'EsupHelpdeskViewer
| Aucune image jointe à cette page. |
Crédits & Licence
Copyright (C) 2011 Esup Portail http://www.esup-portail.org
Copyright (C) 2011 UNR RUNN http://www.unr-runn.fr
@Author (C) 2011 Jean-Pierre Tran <Jean-Pierre.Tran@univ-rouen.fr>
@Contributor (C) 2011 Vincent Bonamy <Vincent.Bonamy@univ-rouen.fr>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.