Commit 838fb992 authored by Olivier Lezoray's avatar Olivier Lezoray 🇫🇷
Browse files

update README

parent 4050e1d0
## Description
Outil d'interrogation d'ADE
Outil pour afficher des emploi du temps créés avec ADE
## Principe
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")
<?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);
?>
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.
### Principe de récupération puis affichage de l'EDT d'une ressource ADE
![Demo une ressource](https://git.unicaen.fr/olivier.lezoray/edt/raw/master/img/demos/SchemaRecapitulatif.png)
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment