README.md 3.63 KB
Newer Older
Olivier Lezoray's avatar
Olivier Lezoray committed
1
## Description
Olivier Lezoray's avatar
Olivier Lezoray committed
2
Outil pour afficher des emploi du temps créés avec ADE
Olivier Lezoray's avatar
Olivier Lezoray committed
3
4

## Principe
Olivier Lezoray's avatar
Olivier Lezoray committed
5
6
7
8
9
10
11
12
13
14
15
16
Dans l'enseignement supérieur, le logiciel ADE est souvent utilisé pour créer les emploi du temps.
Il possède une fonctionnalité interessante qui consiste à pouvoir visualiser ses créneaux de cours dans son
logiciel favori de calendrier. Pour cela, il faut effectuer un export au format ical. L'URL générée est alors au format suivant :
http://ade.unicaen.fr/jsp/custom/modules/plannings/anonymous_cal.jsp?resources=2480&projectId=1&calType=ical

Dans cette URL apparait un numéro de ressource (resources=2480 dans l'exemple) et plusieurs ressources peuvent être précisées en précisant leurs numéros séparés par des virgules. Pour connaitre le numéro d'une ressource il faut le localiser dans l'URL générée par l'export d'ADE.

En exploitant cette URL il est donc possible de récupérer automatiquement l'emploi du temps d'une ressource et de l'afficher dans un document HTML. C'est ce que propose l'outil proposé. 

Pour cela, un web service nommé "EDTReader.php" est proposé. Il prend deux paramètres passés en GET :
1. le numéro de la ressource pour laquelle on veut l'emploi du temps
2. le format retenu pour l'emploi du temps (parmi "week", "day" ou "hour")
Olivier Lezoray's avatar
Olivier Lezoray committed
17
```php
Olivier Lezoray's avatar
Olivier Lezoray committed
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<?php
header('Content-type: text/json');
require_once("iCalReader.class.php");


require_once("AdeEdtReader.class.php");
$myAdeEdtReader = new AdeEdtReader();

//or with the whole set of arguments for settings outside of the university of Caen
/*
$myAdeEdtReader = new AdeEdtReader(
        array(
            "proxy"=>"tcp://proxy.unicaen.fr:3128",
            "ade_url"=>"http://ade.unicaen.fr:80/jsp/custom/modules/plannings/anonymous_cal.jsp",
            "projectId"=>1,
            "examCodes"=>array("CTRL","Examen","Ctrl","CTP")
        )
);
*/

$result=$myAdeEdtReader->retrieveEDT($_GET["ressource"], $_GET["format"]);
echo json_encode($result);
?>
Olivier Lezoray's avatar
Olivier Lezoray committed
41
```
Olivier Lezoray's avatar
Olivier Lezoray committed
42
43
44
45
Le web service repose sur l'utilisation d'une classe PHP "AdeEdtReader" qui effectue une interrogation du webservice ADE. Ce web service renvoie en réponse du JSON qui contient l'emploi du temps de la ressource pour la semaine entière à venir (week), la journée en cours (day), ou l'heure en cours (hour). Le JSON peut ensuite être récupéré en Javascript coté client et l'emploi du temps affiché dans un document HTML.



Olivier Lezoray's avatar
Olivier Lezoray committed
46
### Principe de récupération puis affichage de l'EDT d'une ressource ADE
Olivier Lezoray's avatar
Olivier Lezoray committed
47
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/SchemaRecapitulatif.png)
Olivier Lezoray's avatar
Olivier Lezoray committed
48

Olivier Lezoray's avatar
Olivier Lezoray committed
49
## Exemples d'utilisation pour le Département MMI de l'IUT à Saint-Lô
Olivier Lezoray's avatar
Olivier Lezoray committed
50
### Affichage de l'EDT à la semaine d'une ressource spécifique
Olivier Lezoray's avatar
Olivier Lezoray committed
51
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/displayEDTOfOneRessource.png)
Olivier Lezoray's avatar
Olivier Lezoray committed
52
### Affichage de l'EDT à la semaine avec choix de la ressource parmi plusieurs
Olivier Lezoray's avatar
Olivier Lezoray committed
53
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/displayEDTWithChoiceOfRessource.gif)
Olivier Lezoray's avatar
Olivier Lezoray committed
54
### Affichage de l'EDT à la semaine de plusieurs ressources avec switch automatique entre elles
Olivier Lezoray's avatar
Olivier Lezoray committed
55
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/displayEDTWithAutomaticSwitch.gif)
Olivier Lezoray's avatar
Olivier Lezoray committed
56
### Affichage de l'EDT à la journée de deux ressources simultanément avec switch automatique entre plusieurs ressources
Olivier Lezoray's avatar
Olivier Lezoray committed
57
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/displayEDTWithTwoAutomaticSwitchByDay.gif)
Olivier Lezoray's avatar
Olivier Lezoray committed
58
### Affichage de l'EDT des créneaux horaires encours pour plusieurs ressources, avec défilement automatique
Olivier Lezoray's avatar
Olivier Lezoray committed
59
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/displayEDTsOfCurrentHour.gif)
Olivier Lezoray's avatar
Olivier Lezoray committed
60

Olivier Lezoray's avatar
Olivier Lezoray committed
61