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 en version 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 (ou supérieur).
- La version 1.1.0 requiert maintenant un EsupHelpdesk 3.29.7 (ou supérieur).
Téléchargement
Nous proposons actuellement le téléchargement de la version 1.1.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.
Dans sa version 1.1.0, la portlet propose un mode édition permettant de choisir les filtres et le nombre de tickets à afficher dans la vue principale.
En rendant les préférences defaultUserView, display_userTabs, display_managerTabs et maxTickets éditables (pour l'utilisateur), la portlet sauvegardera le choix de vue de l'utilisateur ainsi que les modifications faites en mode "edit", 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 la préférences defaultUserView. A noter la préférence defaultFilter pour afficher le filtre par défaut dans les versions inférieures à 1.1.0.
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.
La préférence messageFile permet de lier un fichier properties particulier en indiquant le suffixe de celui-ci.
L'authUrl permet d'indiquer l'url d'authentification utilisée pour les liens du menu
Si vous utilisez esup-helpdeskviewer pour interroger un WS venant d'un helpdesk 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-2012 Esup Portail http://www.esup-portail.org
Copyright (C) 2011-2012 UNR RUNN http://www.unr-runn.fr
@Author (C) 2011-2012 Jean-Pierre Tran <Jean-Pierre.Tran@univ-rouen.fr>
@Contributor (C) 2011-2012 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.