Interface ADE-EVE v1.2

Interface ADE-EVE v1.2 L'application est une librairie java installée sur le serveur ADE qui offre une interface graphique au niveau du client ADE et une interface pour des lancements planifiés via le gestionnaire des tâches d'ade. Elle permet la récupération des heures planifiées dans ADE et les envoie directement dans la base de données d'eve. Un certain nombre de comportements sont personnalisables via un fichier de paramètres. Sommaire : 1) Les interfaces a) L'interface graphique. b) Les tâches planifiées c) les fichiers de logs 2) La librairie java a) Les différentes classes b) Algorithme de récupération des données d'ade c) Algorithme d'envoi des données vers EVE 3) Installation et configuration a) pré-requis b) installation c) fichier de paramètres CustomAdeEve.properties Améliorations dans la v1.1 : - champ du code étape dans le fichier de paramètres (voir 3a). - vérification des services réalisés validés avec ADE (voir 1b). - possibilité de sélectionner un dossier dans l'interface graphique (voir 1a). Améliorations dans la v1.2 : - Vérification du total d'heures réalisées par rapport au total d'heures prévisionnelles pour chaque enseignant à la fin de la bascule du réalisé (voir 1a). - ajout du paramètre "ufr" dans les taches planifiées.

1) Les interfaces a) L'interface graphique. L'interface graphique peut être lancée à partir de n'importe quel client ADE. Un clic droit sur un formateur permet de lancer soit un "Etat des services prévisionnels" soit un "Etat des services réalisés" La sélection de plusieurs formateurs ou plusieurs dossiers est également possible, on peut même sélectionner le dossier "Formateurs" pour basculer toutes les heures mais dans ce cas-là le lancement via les tâches planifiées d'ade est plus adaptée.

La liste des heures planifiées s'affichent alors dans la fenêtre avec la durée totale. Plus le nombre d'enseignants sélectionnés est grand plus le temps de récupération des informations est important, on peut néanmoins arrêter le processus sans craintes avec le bouton "Fermer". Les utilisateurs autorisés (permission au niveau de l'utilisateur ADE, paramétrable dans le fichier de paramètre de l'interface ADE-Eve) pourront cliquer sur le bouton "Exportation Eve" pour envoyer les informations dans la base de données d'eve. Une fois l'exportation faite, le nombre de lignes réellement basculées s'affiche et permet de s'assurer qu'il n'y a pas eu d'erreur (les erreurs sont consignées dans le fichier de logs).

L'état des services réalisés utilise la même fenêtre mais ne concerne que les planifications qui ont eu lieu jusqu'au dernier jour du mois précédent. Les dates et heures de chaque séance sont en plus affichées car renseignées dans Eve : A la fin de la bascule des heures réalisées, une vérification est faite par rapport au prévisionnel : Si le total d'heures ETD (équivalent TD) réalisées est supérieur à celui des heures ETD prévisionnelles (validées niveau UFR), un message d'erreur comme cidessous est affiché dans les logs. Probleme : nb heures realisees > nb heures previsionnelle pour XXXXXX : realis= 84.75 previs=79.75 Note : on peut également avoir un état des heures sur d'autre ressources comme une filière ou une salle mais dans ce cas l'exportation vers Eve ne sera pas disponible.

b) Les tâches planifiées Généralement les bascules des heures seront lancées via une tâche planifiée d'ade en définissant un "job" dans les fichier CustomTasks.xml sur le serveur, par exemple : <job type="class" class="fr.ufc.adeeve.lanceurtache" user="root" param="projectid=12&service=realis&type=f-titulaire,f- Contractuel&ufr=901,902"> </job> L'utilisateur, le projet à utiliser, le type de services (réalisés ou prévisionnels) et les types d'enseignants et les codes des UFR prendre en compte sont spécifiés en paramètres sur la ligne de job. Pour avoir toutes les composantes, ne pas spécifier le paramètre "ufr" ou le mettre à vide. Les autres paramètres sont dans le fichier de configuration de l'interface. La seule sortie sera alors le fichier de log. Après l'envoi des services réalisés, une vérification des heures validées qui ne seraient plus présentes dans ADE est faite. Toutes les anomalies (heures n'existant plus ou heure de fin différente) sont remontées dans le fichier de log du serveur. c) les fichiers de logs Les informations de déroulement du programme, les insertions et modifications de lignes dans la base EVE, les erreurs et les chevauchement d'horaires sont enregistrés dans un fichier journalier de logs. Lorsque l'interface graphique est utilisée, ces informations sont inscrites dans un fichier sur le poste client. Pour une tâche planifiée, c'est un fichier sur le serveur qui est créé. Le nom est de la forme AdeEve_aaaa-mm-jj.log. Exemple de logs : Debut recuperation donnees ADE Fri Jun 03 14:59:49 CEST 2011 Fin recuperation donnees ADE Fri Jun 03 14:59:49 CEST 2011 Debut envoi services realises vers EVE Fri Jun 03 14:59:56 CEST 2011 passage statut a 'M' (modifiable) des lignes ADE non validees pour ABCDEFXX table SERVICE : 32 lignes insertion : 1234;5SESV410;NT8BGD;CM;2011-02-01 08:00;1.5 maj 564498 : 1234;5SBM408;NT7IMMUN;TD;2010-12-16 11:00;1.5 insertion : 1234;5SESV410;NT8BGD;CM;2011-05-03 08:00;1.5... Erreur, chevauchement avec SEID=564511, insertion impossible de : 1234;5SBM408;NT7IMMUN;CM;2010-09-23 11:00;1.5... suppression des lignes dont le statut est reste a M : 0 lignes Nombre de lignes exportees : 41 sur 42. Fin envoi vers EVE Fri Jun 03 14:59:56 CEST 2011 Debut recuperation donnees ADE Mon Jun 06 15:41:30 CEST 2011 Fin recuperation donnees ADE : 42 lignes, Mon Jun 06 15:41:30 CEST 2011 Debut envoi service previsionnel vers EVE Mon Jun 06 15:41:31 CEST 2011 remise a zero des heures ADE pour ABCDEFXX table PREVIS : 33 lignes mise a jour 289 : 1234;5SBM408;18190;TD;1.5 mise a jour 290 : 1234;5SBM408;18190;TD;1.5...

Matiere creee MACODE=63924 pour NT8BGD / CMAT01 insertion : 1234;CMAT01;63924;CM;1.5 insertion : 1234;CMAT01;63924;CM;3.0 suppression des lignes dont les heures sont a zero : 0 lignes Nombre de lignes exportees : 42 sur 42. Fin envoi vers EVE Mon Jun 06 15:41:32 CEST 2011

2) La librairie java a) Les différentes classes L'application est contenue dans une archive java (adeeve.jar) sous l'arborescence fr.ufc.adeeve. Elle est installée sur le serveur. Elle comprend les classe suivantes : - exportformateur : c'est la classe où ont lieu tous les traitements, elle contient principalement les méthodes recup() pour récupérer les données d'ade et envoi() pour envoyer les infos vers EVE - exportfenetre : la classe qui crée la fenêtre pour l'interface graphique, elle appelle la méthode recup(), affiche le résultat et appelle éventuellement la méthode envoi(). - lanceurfenetreprevis : la classe qui est appelée par ADE lors du clic droit sur un Formateur pour l'état des services prévisionnels. Elle instancie exportformateur pour du prévisionnel et exportfenetre pour l'affichage. - lanceurfenetrerealis : la classe qui est appelée par ADE lors du clic droit sur un Formateur pour l'état des services réalisés. Elle instancie exportformateur pour du réalisé et exportfenetre pour l'affichage. - lanceurtache : classe qui est appelée par le gestionnaire des tâches d'ade. Elle instancie exportformateur et appelle les méthodes recup() et envoi() suivant les paramètres du job. b) Algorithme de récupération des données d'ade * parcours de toutes les ressources sélectionnées + récupération des données de la ressource * parcours des évènements liés à cette ressource + récupération des données de l'évènement? si date de l'évènement vide ou inférieur à date en paramètre (services réalisés) + on récupère l'activité concernée par cet évènement? si le champ "étape de rattachement" est à vide sur l'activité * parcours des ressources "imposées" jusqu'à trouver un code étape? si cette ressource est un groupe d'étudiants * on parcourt les dossiers parents? si c'est un répertoire provenant de la synchronisation Apogée + on récupère le code étape.? fin si * fin parcours? fin si * fin parcours? sinon + le code étape est renseigné avec l'étape de rattachement? fin si + sauvegarde des données? fin si test date * fin parcours * fin parcours

c) Algorithme d'envoi des données vers EVE * parcourir les données récupérées d'ade + récupération des données? si l'enseignant existe dans EVE? si changement d'enseignant? si services réalisés? si pas le premier enseignant + suppression des lignes à 'M' pour l'enseignant précédent? fin si + marquage des lignes modifiables avec SESTATUT='M' pour l'ens en cours? sinon (service prévisionnel)? si pas le premier enseignant + suppression des lignes à zéro pour l'enseignant précédent? fin si + remise à zéro des heures ADE pour l'enseignant en cours? fin si? fin si? si type d'élément différent de CM TD ou TP + erreur? sinon si les heures sont > 0 + recherche de la matière d'eve à partir de (élément, étape) d'ade? si code matière trouvé (MACODE) + récupération MACODE? sinon la matière n'existe pas, on va la créer si autorisé dans les options? si ELCODE existe dans ELEMENT d'eve? si FICODEVET (version étape) existe dans FILIERE d'eve + on crée la nouvelle matière + on récupère le nouveau MACODE? si non + erreur : la filière n'existe pas? fin si? sinon + erreur : l'élément n'existe pas? fin si? fin si? si on a un code matière? si service réalisé + recherche du PCLE? si ligne (enseignant,horaire) existe dans EVE? si c'est une ligne venant d'ade? si cette ligne n'est pas déjà validée + mise à jour de matière et heures? sinon? si même matière + ok on touche à rien? sinon + erreur : créneau ADE validé déjà pris par autre matière? fin si? fin si? sinon + erreur : incompatibilité avec créneau non ADE? fin si? sinon (aucune ligne existante sur ce même créneau)? si ligne (ens, seheudeb, duree) en conflit avec ligne existante + erreur : conflit avec une autre ligne? sinon + insertion dans la table SERVICE? fin si? fin si? sinon (prévisionnel) + recherche de la première ligne (année, matiere, enseignant) ADE disponible dans la table PREVIS dont les heures sont à zéro? si la ligne existe + on renseigne les heures CM, TD et TP? sinon + on l'insère dans la table PREVIS

? fin si? fin si? si non + erreur : code matière introuvable? fin si (code matière existant)? fin si (heures > 0)? sinon (l'enseignant n'existe pas dans Eve) + erreur : enseignant inexistant dans Eve? fin si * fin parcours des donnée récupérées d'ade + suppression des lignes dont les heures sont à zéro ou le SESTATUT à 'M' pour le dernier enseignant

3) Installation et configuration a) Pré-requis Les codes étapes des dossiers des groupes d'étudiants issus de la synchro Apogee-ADE doivent être de la forme : code_étape + version_étape_2car sans séparateur comme dans EVE. -> v1.1 : ou alors utiliser un autre champ (comme codey) rempli à partir d'eve par un script (programme java disponible) une fois les groupes d'étudiants importés d'apogée dans ADE, ce qui évite de modifier ldap et myplanning Les types d'éléments dans ADE doivent être soit CM soit TD soit TP (pour l'instant CM, TD ou TP est quand même reconnu si il est simplement contenu dans le type). au niveau de l'activité dans ADE, pour les activités avec plusieurs groupes d'étudiants venant d'étapes différentes : champ en saisie manuelle de l'étape de rattachement afin de basculer les heures dans une seule étape choisie. Ce champ peut également être utilisé pour les UE sans étape de rattachement, après avoir saisi une étape fictive dans Eve. Sur le client, modification du fichier Client.properties : JavaParam=-Xmx256M au lieu de 128M Sur notre serveur de test, dans le fichier Server.properties nous avons -Xmx512M (en production nous avons 1024M) L'interface ADE-Eve n'a été testée qu'avec Eve fonctionnant sur une base MySql. Lorsque l'interface graphique est utilisée pour le transfert vers Eve, les logs ne peuvent pas être envoyés sur le serveur, ils sont stockés sur le client. Il faut peut-être prévoir un petit script pour les copier et ainsi les centraliser sur le serveur. b) Installation copie du fichier adeeve.jar dans le répertoire Server/lib du serveur ADE copie du fichier CustomAdeEve.properties dans le répertoire Config du serveur ADE pour modifier le libellé du champ supplémentaire au niveau de l'activité, ajout dans CustomKeywords_fr.properties de la ligne (si utilisation du champ "fuseau Horaire" pour l'étape de rattachement) : column.timezoneactivity=etape de rattachement pour modifier le menu du clic droit sur une ressource, ajout dans le fichier CustomPopupResources.xml : <javaaction class="fr.ufc.adeeve.lanceurfenetreprevis" icon="res/empty.gif" label="etat des services prévisionnels" nbselected="1+" /> <javaaction class="fr.ufc.adeeve.lanceurfenetrerealis"

/> icon="res/empty.gif" label="etat des services réalisés" nbselected="1+" (Possibilité de rajouter un attribut permission pour limiter l'affichage aux personnes autorisées à faire la bascule, mais de toute façon une personne non autorisée n'aura pas la possibilité de lancer le transfert, elle aura juste l'affichage) pour une copie automatique de la librairie java sur les clients, ajout dans CustomClientLib.xml de la ligne : <jar name="adeeve.jar" /> pour planifier une bascule automatique du prévisionnel tous les soirs et une bascule des services réalisés tous les 2 et 15 du mois, ajouter dans le fichier CustomTasks.xml les lignes : <job type="class" class="fr.ufc.adeeve.lanceurtache" user="root" param="projectid=12&service=previs&type=f-titulaire,f- Contractuel"> <startdate date="31/05/2011 23:00" format="dd/mm/yyyy HH:mm" /> <every value="1" unit="days" /> </job> <job type="class" class="fr.ufc.adeeve.lanceurtache" user="root" param="projectid=12&service=realis&type=f-titulaire,f- Contractuel"> <startdate date="02/06/2011 22:00" format="dd/mm/yyyy HH:mm" /> <every value="1" unit="months" /> </job> <job type="class" class="fr.ufc.adeeve.lanceurtache" user="root" param="projectid=12&service=realis&type=f-titulaire,f- Contractuel"> <startdate date="15/06/2011 22:00" format="dd/mm/yyyy HH:mm" /> <every value="1" unit="months" /> </job> Paramètres : - user = utilisateur ayant les droits en lecture sur tout - projectid = le numéro du projet sur lequel on veut faire les extractions - service = "previs" pour du prévisionnel ou "realis" pour du réalisé - type = type d'enseignant à prendre en compte. Si plusieurs, les séparer par des virgules sans espace. Si vide, tous les enseignants sont pris.

c) fichier de paramètres CustomAdeEve.properties # acces base de donnee EVE JdbcDriver=com.mysql.jdbc.Driver JdbcSource=jdbc:mysql://194.57.76.225:3306/eve_test JdbcLogin=login JdbcPassword=**** # permission que doit avoir l'utilisteur pour deverser dans EVE via l'interface graphique permission=projects_synchronize # permet d'identifier les dossier des groupes d'étudiants issus de la synchro Apogee, ils contiennent le code étape champ_synchro_etape=codez champ_synchro_etape_valeur=synchro Apogee # champ specifiant l'etape de rattachement au niveau de l'activite pour correspondance manuelle avec Eve (ex : timezone, maxseats, seatsleft) champ_etape_rattachement=timezone # creation automatique de la matiere (avec le semestre par defaut) si elle n'existe pas (0 ou 1) creation_matiere=1 semestre_defaut=sadeeve # SERVICE PREVISIONNEL # annee en cours au niveau de Eve annee_previs=2010 # valeur de PRSTATVALIDUFR par defaut, si egal 2 alors PRDTEVALIDUFR est egalement renseigne (a la date courante) prstatvalidufr=2 # si egal 1 alors PRDTEVALIDDPT est mis a la date courante prstatvaliddpt=1 # SERVICES REALISES # annee en cours au niveau de Eve annee_service=2010 # valeur par defaut de SESTATUT sestatut=s # indicateur de renseignement par défaut des dates de validation pour les employés : si egal a 1 alors la date courante est mise dans SEDTEVALIDxxx sevalidens=0 sevalidufr=0 sevaliddpt=0 # indicateur de renseignement par défaut des dates de validation pour les extérieurs : si egal a 1 alors la date courante est mise dans SEDTEVALIDxxx sevalidens_e=1 sevalidufr_e=0 sevaliddpt_e=0 # chemin d'acces au fichier de logs pour l'interface graphique cheminlogsclient=c:\\app\\ade\\client\\adeeve\\ # chemin d'acces au fichier de logs pour le job de CustomTask d'ade cheminlogsserveur=c:\\app\\ade\\server\\adeeve\\