Canal
MonDossierWeb
Canal MonDossierWeb
But
Ce canal est constitué de fonctionnalités développées
par Nancy 2 et par Rennes 1 et représente le dossier d'un étudiant
: MonDossierWeb.
Nancy 2 et Rennes 1 n'extraient pas les données provenant d'APOGEE de
la même façon, il existe donc la possibilité d'installer
des plug-ins d'après votre méthode d'extraction des données
(voir Fonctionnalités)
Pré-requis
Cette version du canal a été testée sur Apogée
3.20 avec une base Oracle 9i. Le canal ne fonctionne pas sur une base Oracle
8i.
Il est nécessaire d'avoir installé les packages suivants au préalable
:
- Connecteur Apogée
- esup-utils-mag
- Canal MailTo (utilisé
en servant ; optionnel : voir la partie Configuration)
- Avoir installé dans uPortal le driver oracle 9i (pour Apogée
3.20) nommé ojdbc14.jar qui remplace
le précédent classes12.jar
Oracle 9i est indispensable pour un bon fonctionnement du canal.
Installation
Récupération de la distribution
- Aller sur la page de téléchargement
Esup pour récupérer la dernière version du package.
- Préparation du fichier de configuration CMonDossierWeb.xml
(voir Configuration)
- Préparation du déploiement : modifier les chemins d'installation
du fichier build.properties.
- Lancement de la commande "ant deploy", pour déployer le
service dans les bons répertoires.
- L'administrateur uPortal doit ensuite enregistrer la nouvelle channel dont
la classe est org.esupportail.portal.channels.gestion.CMonDossierWeb.CMonDossierWeb
Installation des plug-ins
Les sources des plug-ins se situent dans le répertoire plugin présent
à la racine du package.
Ils ne sont pas deployés en même temps que le canal.
Pour les utiliser, il faut décommenter les lignes correspondantes dans
le fichier de configuration CMonDossierWeb.xml qui se trouve dans le répertoire
"properties" et mettre en commentaire les actions dont vous ne vous
servez pas.
Décommenter aussi dans le fichier CMonDossierWeb.ssl qui se trouve dans
webpages/stylesheets/org/esupportail/portal/channels/gestion/CMonDossierWeb/
les lignes correspondant aux plug-ins.
Voir aussi le fichier Liens.xsl pour s'assurer des liens qui seront présent
à l'affichage du canal et le fichier default.xsl pour décommenter
la déscription du plugin Résultat.
Faire ensuite un "ant deploy" pour déployer les modifications
de configurations ayant trait aux plug-ins.
Pour les deployer, il faut lancer la commande :
"ant plugCalRent" pour deployer le plug-in calendrier de Rentrée.
"ant plugCalExam" pour deployer le plug-in de calendrier d'examens.
"ant plugResultats" pour deployer le plug-in d'affichage des résultats
de l'année en cours.
Configuration
Modifier le fichier CMonDossierWeb.xml sachant
que :
- pool : fait référence au pool
de connexion vers Apogée. Ce pool doit conserver le nom "default"
. Pour plus de détails sur la configuration du pool voir le package
database.
- extMail : indique l'extension ajoutée
au login des étudiants pour constituer leur adresse mail. Laisser vide
cette balise entraine le non affichage de l'adresse mail dans les différentes
pages
- lienContact : permet d'afficher un lien "Nous
contacter" avec comme adrese la valeur passer à l'attribut value.
Pour ne pas utiliser cette fonctionnalité, mettre en commentaire la
balise.
- rappelIdentite : permet d'ajouter un rappel
de l'identité de l'étudiant sur chaque page. Prend comme valeur
true ou false.
- Remarque : Pour ne pas utiliser le canal
MailTo pour l'envoi des mails lors des clics sur les adresses électroniques
des étudiants, mettre en commentaire la balise <action name="sendMail"
..../>. Dans ce cas, les liens sur les adressses mail seront du type
mailto:...
Fonctionnalités
Ce canal propose les fonctionnalités suivantes :
Etat-civil
Adresses
Inscriptions
- Cette fonctionnalité affiche l'ensemble du cursus interne à
l'établissement et externe.
Calendrier d'examen
- On affiche que les calendriers dont le nom dans le référentiel
Apogée commence par @ (seule méthode trouvée pour l'instant
pour reconnaître les calendriers à publier).
- Plug-in CalExam : On affiche les calendriers définis et publiés
à travers les traitements personnalisés
d'APOGEE
Voir le répertoire oracle dans le plugin CalExam.
Notes et résultats
- Sont affichées toutes les notes et résultats à l'état
E ou T dans Apogée pour les VDI, VET ou éléments
- Les notes des épreuves sont toujours affichées.
- Plug-in Resultat : On affiche que les résultats de l'année
en cours en s'appuyant sur le module d'extraction APOGEE
Calendrier de rentrée
- Plug-in CalRent : On affiche le calendrier de rentrée en s'appuyant
sur le module d'extraction APOGEE
Voir le répertoire oracle dans le plugin CalRent.
Extension
Ce canal peut également être utilisé en mode servant via la classe MonDossierWebServant.java
Traitement personnalisé d'APOGEE
Entrée de menu que l'AMUE prévoit dans son logiciel APOGEE pour
permettre aux établissements d'intégrer leurs developpements internes.
L'installation de ces traitements personnalisés est décrite dans
le répertoire "oracle" des plug-ins.
