EVAL Uni Genève / Accueil / Documentation - étudiant - enseignant - technique - nouveautés (nota: liens tous désactivés)

Documentation technique - Comment fonctionne le système


ENVIRONNEMENT INFORMATIQUE

EVAL est un site Web, installé sur un serveur Apache version 1.2 et une station Unix Sun Ultra-1 sous Solaris 2. Les documents html ont été édités avec Xemacs 19.15, ainsi que les scripts Perl, version 5.003. Les graphiques sont créés par Gnuplot 3.5 (1993) et la routine ppmtogif de NETPBM. La version PostScript des questionnaires papier est produite par LaTeX2e et dvips.

STRUCTURE DU SITE

EVAL est constitué de scripts Perl appelés par des documents html. Les données spécifiques de chaque cours, questionnaire, réponses et rapport, sont regroupées par répertoires unix, protégés par le système de mots de passe du serveur.

Page d'accueil

index.html --- page d'accueil

   register.html --- entrée des informations pour une demande de dossier

	cgi-bin/register.pl --- sauvegarde des informations
				envoi d'un mail à l'administrateur

   cgi-bin/select.pl/ETUQS  --- accès étudiant, sélection du questionnaire 

      cours/9999/quest/quest.html --- entrée des réponses (ici pour le cours 9999)
         cgi-bin/quest.pl/9999    --- sauvegarde des réponses

   cgi-bin/select.pl/ETURAP --- accès étudiant, sélection du rapport
      cours/9999/results/raptot.html --- Consulter le rapport

   cgi-bin/select.pl/ENSEI  --- accès enseignant, sélection du dossier

   cgi-bin/select.pl/DEMQS  --- démonstration, sélection du questionnaire
   cgi-bin/select.pl/DEMRAP --- démonstration, sélection du rapport
   cgi-bin/select.pl/DEMENS --- démonstration, sélection du dossier enseignant

   doc/intro_doc.html  --- Documentation, introduction
   doc/user_doc.html   --- doc étudiant
   doc/owner_doc.html  --- doc enseignant
   doc/tech_doc.html   --- doc technique (ce document-ci)
   doc/nouveautes.html --- récents développement

   admin/index.html --- administration

	cgi-bin/admin/make_eval.pl  --- créer un dossier d'évaluation
	cgi-bin/admin/admin_eval.pl --- édition de la liste des évaluations
	admin/messages.html --- messages type aux enseignants


Dossier de cours pour l'enseignant (ici pour le cours 9999)

cours/9999/ens/index.html --- dossier de cours pour l'enseignant

   cours/9999/questions.html --- liste des questions
   cgi-bin/ediq.pl/9999      --- modification du questionnaire
   cgi-bin/q2ps.pl/9999      --- questionnaire PostScript

   cgi-bin/access.pl/9999 --- liste des accès au serveur pour envoi de questionnaires

   cgi-bin/rapgen.pl/9999 --- production du rapport

   cours/9999/results/raptot.html --- Consulter le rapport
   cours/9999/results/raptxt.html --- textes seulement
   cours/9999/results/rapgif.html --- graphiques seuls
	une image par question, 1.gif, 2.gif, ...15.gif

   cgi-bin/import.pl/9999/EDINUM --- saisie de réponses par questionnaires papier
   cgi-bin/import.pl/9999/EDITXT --- ..., commentaires

   cours/9999/data/num.html  --- données brutes, questions par choix
   cours/9999/data/txt.html  --- ..., commentaires
   cours/9999/data/histogram --- tableau de fréquences

   cgi-bin/rapac.pl/9999 --- choix des limites d'accès au rapport

Structure du répertoire d'un cours

/cours/9999/        répertoire de base (ici pour le cours de code 9999)
            ens/      répertoire de l'enseignant (accès enseignant)
          quest/      répertoire du questionnaire (accès étudiant+enseignant)
           data/      répertoire des données (accès enseignant)
        results/      résultats et figures (accès enseignant, +év. étudiants)

PRINCIPAUX SCRIPTS PERL

select.pl - Sélection du cours

Appelé par la page d'accueil - accès général.

Produit une liste des évaluations en cours, en fonction du type d'appel (accès étudiant au questionnaire ou au rapport, accès enseignant au dossier de cours, accès de démonstration). Les liens pointent sur un questionnaire html, un rapport ou le dossier (répertoire) d'un cours. Ces documents sont à priori toujours dans des répertoires protégés. A chaque premier accès d'une session, le logiciel de navigation (Netscape ou autre) demande donc un nom d'utilisateur et un mot de passe.

Se termine en affichant l'adresse (location) sélectionnée (si les accès sont validés).

quest.pl - Saisie des réponses

Appelé par le bouton ENVOI du questionnaires html d'un cours - accès étudiant.

Les réponses du questionnaire, préfixées par la date d'envoi (en secondes) sont ajoutées en une ligne au fichier data/data du répertoire du cours. Le fichier est verrouillé lors de cette écriture, pour éviter des conflits d'accès (routine flock). Le format est celui du protocole HTTP, par exemple:
832148597:Q01=3&T01=No+comment!&Q02=4T02=I+was+too+busy [..]
Q01,T01,Q02,T02,... sont les variables représentant le choix et les commentaires des questions 1,2,...

Se termine en affichant un message de quittance et de recommandations.

rapgen.pl - Production du rapport

Appelé par le dossier d'un cours, par l'enseignant ou l'administrateur - accès enseignant.

A partir du fichier brut data deux fichiers sont produits, l'un pour les réponses par choix, l'autre pour les commentaires (fichiers num et txt). Ces fichiers ont également une version html. Les fichier num et txt peuvent provenir d'une importation de données manuscrites, dans ce cas le fichier data est ignoré (sauf pour la démonstration).

Un tableau des fréquences est ensuite produit, sauvé dans un fichier simple (histogram) et un fichier html. Pour chaque question par choix un graphique en barres est produit par un script gnuplot, et converti au format gif (ppmtogif).

En fonction du texte du questionnaire (fichier de base quest.qtx du dossier de l'enseignant) un rapport rassemble le texte des questions, les images des histogrammes et les commentaires ou réponses ouvertes. Une version ne contenant que les graphiques et une autre rassemblant les textes sont également réalisées.

Se termine en affichant une confirmation et un lien sur le rapport.

ediq.pl - Edition du questionnaire

Appelé par le dossier d'un cours ou en retour du formulaire html produit - accès enseignant.

Affiche une version texte du questionnaire dans une fenêtre d'édition d'un formulaire html, dans un format simple: chaque question débute sur une nouvelle ligne, par son numéro, les choix multiples sont précédés chacun par "//".

Des boutons d'envoi permettent de revenir à la version précédente ou à la version originale, d'enregistrer la version modifiée, de trier ou renuméroter les questions, d'afficher le questionnaires sous sa forme html. A chaque enregistrement le fichier quest.qtx est converti en un questionnaire html (formulaire). Un document html est aussi produit pour afficher une simple liste des questions.

Si des données sont déjà entrées dans le fichier data, la modification du questionnaire n'est plus possible (sauf pour la démonstration).

q2ps.pl - Questionnaire PostScript

Appelé par le dossier d'un cours - accès enseignant.

Reprend le fichier quest.qtx (tel que produit par ediq.pl) et le transcrit en un document LaTex. Le fichier .tex est traité par latex, puis par dvips.

Se termine en proposant le transfert du fichier PostScript sur le système de l'utilisateur.

import.pl - Importation de données manuscrites

Appelé par le dossier d'un cours, séparément pour les données des questions par choix et pour celles des commentaires ou questions ouvertes. Egalement appelé en retour du formulaire html produit - accès enseignant.

Comme ediq.pl, mais plus simplement, affiche une fenêtre d'édition d'un formulaire html permettant de charger les fichiers num et txt, repris ensuite pour la production du rapport. Les formats des données sont précisés dans le formulaire. Si des données sont déjà entrées dans le fichier data, l'importation n'est plus possible (sauf pour la démonstration).

make_eval.pl - Création d'un dossier de cours

Appelé par la page d'administration - accès administrateur.

Affiche les requêtes en attente (transmises par register.pl), permet de corriger la première de la liste et en envoi crée le dossier de cours. Un répertoire modèle, copie stable du dossier de démonstration, est copié avec ses sous-répertoires sur le répertoire du nouveau dossier, désigné par le code du cours. Les fichiers spécifiques sont ensuite modifiés. Le fichier des utilisateurs est augmenté de deux nouvelles entrées, une pour le cours et une pour l'enseignant.

Se termine par une page de quittance et des liens sur l'adresse e-mail de l'enseignant et le fichiers de messages types.

admin_eval.pl - Edition de la liste des évaluations en cours

Appelé par la page d'administration - accès administrateur.

Edition par champs de la liste des évaluations en cours. Permet la modification des informations, leur tri, l'ajout ou le retrait de cours. Le fichier de base est celui qui est repris par le script de sélection de cours, select.pl. Pour chaque évaluation on garde les informations suivantes:
- les codes du cours et de l'enseignant, le mode du questionnaire,
- les dates de la demande, du dossier, des début et fin de l'évaluation, du dépouillement de réponses manuscrites et du rapport,
- la faculté, l'accès au rapport, le nombres d'étudiants annoncés, le nombre de réponses, le nom du cours, les coordonnées de l'enseignant, des remarques.

/ Retour accueil EVAL / Documentation - étudiant - enseignant - technique - nouveautés


EVAL eval@unige.ch
Last modified: Mon Sep 7 14:28:01 MET DST 1998