Documentation des modules

Un article de DocAstairs.

Sommaire

[modifier] Ressources Humaines

[modifier] Ressources pédagogiques

[modifier] Gestionnaire de contenus

[modifier] Fonctionnement général

[modifier] Les themes

[modifier] Les catégories

[modifier] Création d'une categorie

[modifier] Les fichiers

[modifier] Fichiers textes

[modifier] Fichiers étapes

[modifier] Scénarios
[modifier] Ressources
[modifier] Scorm

[modifier] Etapes de parcours

[modifier] Exercices à télécharger

[modifier] Création en BO

Mail

Choix du formateur

Plate-forme

Choix du nom de fichier à rendre par l'apprenant

Choix correction par l'apprenant ou par le formateur (Sélection du modèle de correction si auto correction)

Note : La création à partir d'un modèle se fera dans le même thème pour le moment (dans d'autre thèmes ultérieurement)


[modifier] Correction

1) Par le formateur

a) A partir d'un modèle

b) A partir d'un stagiaire déjà corrigé

c) Choix critères et sous-critères

Note : Le formateur pourra corriger dès que l'apprenant aura cliquer sur l'étape (exercice à télécharger).

Il pourra forcer la correction d'un exercice plate-forme avant même que l'apprenant ait rendu son fichier.

2) Par l'apprenant (Auto correction)

Saisie des notes en front office

Note : Le formateur pourra modifier les choix de l'apprenant et y ajouter des commentaires.

Il pourra aussi joindre les fichiers de correction.

[modifier] Formations

Une formation possède un identifiant, un libelle, un parcours et des dates de débuts et de fin. Elle possède aussi des ressources, accessibles en FO.

[modifier] Participants d'une formation

Une formation est suivie par un formateur et par une classe. Une formation n'ayant qu'un seul formateur, les droits du formateur sont déterminés par rapport à une formation. Ce qui explique pourquoi on ne retrouve que les champs formation et droit dans la table formateur_droits. Un trigger est présent sur cette table pour insérer systématiquement les droits par défaut au formateur. L'affectation des droits des individus de la classe, la modification des droits des formateurs et la configuration des droits par défaut se font dans les ressources administratives.

[modifier] Ressources Administratives

[modifier] Les langues

Les langues sont gérées actuellement par des fichiers, et sans interraction avec la base de données. Par exemple pour connaitre les langues existantes, on parcours un repertoire (très long). Pour la nouvelle base de données, afin d'éviter de parcourir ce repertoire, on stocke les langues en base de données. Outre un gain de performance, cette gestion de langue en base a permi la mises en place de contraintes d'intégrité sur les entités liées à des langues (formations,...).

[modifier] Les fichiers

[modifier] Fichiers de langues

ANCIENNE BASE Les fichiers de langues sont localisés dans le repertoire lang de la racine du back-office. Il y a un répertoire par langue de la plate-forme, dont le nom est la langue en anglais (ex: french, english,...)

NOUVELLE BASE Les fichiers de langues sont localisés dans le repertoire langue de la racine du back-office. Il y a un répertoire par langue de la plate-forme, dont le nom est l'identifiant de la langue en base de données (ex: 4, 1,...)


Les repertoires de langues contiennent chacuns :

  • un fichier lang.php3 contenant l'ensemble des mots à utiliser sur la plate-forme
  • un fichier flag.gif, l'image du drapeau correspondant à la langue
  • l'ensemble des images spécifiques à la langue (images contenant du texte, etc... )

[modifier] Fichiers de configuration et langues par défaut

  • Le fichier config.ini.php

Ce fichier contient la langue à utiliser par défaut sur le back-office. Il est localisé à la racine du back-office.

[Langue]
langueParDefaut=french
  • Le fichier default_lang.php3

Ce fichier contient la langue séléctionnée par l'utilisateur sur le back-office . Il est localisé dans le repertoire langue du back-office. (lang pour l'ancienne base)

<?php
define("MY_LANG","french");
?>
  • Le fichier config_site.php

Il contient les langues disponibles pour les PGR.

define("L_French",1); indique que la langue française est disponible.

[modifier] La base de données

La nouvelle base permet la gestion des langues à partir de la base de données. Les langues de la plate-forme sont donc contenues dans la table langue avec les champs:

  • id : identifiant de la langue
  • libelle : libellé de la langue (une variable de langue pour le multilingue)
  • code : le code utilisé pour la manipulation des langues dans les scripts
  • locale : le code de la "locale" correspondant à la langue

[modifier] Les scripts

Les scripts devant manipuler des langues doivent utiliser le code de la langue car c'est ce code qui est utilisé dans les fichiers de configuration.

[modifier] Pour l'avenir...

La gestion de langue en base pourra à l'avenir permettre de créer un outil de manipulation des contenus des fichiers de langues:

  • Les mots des fichiers de langues seront stockés dans la table langue_message
  • Un outil PHP sera dévellopé pour faciliter la recherche et la saisie pour les différents languages.
  • Cet outil permettra la génération des fichiers de langues.
  • Il pourra etre partiellement intégré au back-office afin de proposer le multilingue pour la totalité des éléments de texte saisis par les utilisateurs.
  • Et il faudra encore réfléchir à ce qu'on pourra faire de plus, et travailler ces idées...


Rémi Cocquet 31 août 2006 à 18:17 (CEST)


[modifier] Les Statistiques

Inventaire des statistiques sur la plateforme

  1. Lien statistiques (BO)
    1. Par formation/Classe virtuelle
      Affichage des résultats par exercices (séries,exercices à télécharger) et graphe des moyennes par exercice
      Affichage des résultats des sondages
      Affichage des résultats des stagiaires et graphe de répartition des notes
    2. Par stagiaire
      Affichage des moyennes du stagiaire par formation avec graphe
      Affichage des résultats d'une formation pour le stagiaire
      Affichage des résultats des tests d'auto-positionnement (bilan général,détaillé + PDF)
  2. Lien statistiques générales (BO)
    1. Connexion (pour tous les stagiaires de la plate-forme)
      Graphes sur la durée et le nombres des connexions,sur la répartition mensuelle des connexions ainsi que sur le nombre de connexions pour une journée)
    2. Réactivité du formateur (pour les exercices à télécharger de type plate-forme)
      Mesure en jour(s)/heure(s)/minute(s) le temps entre la réception de l'exercice et la correction par le formateur
      Propose aussi un détail des résultats avec graphe et un classement des stagiaires
    3. Suivi présentiel
      Histogramme des acquis par groupe et par stagiaire
      Graphe des moyennes par groupe et par stagiaire
  3. Statistiques utilisateur (FO)
    1. Moyenne des séries Multi-exercices : X/ 20
    2. Moyenne des séries de QCM : X/ 20
    3. Moyenne des séries de Remplir les Blancs : X/ 20
    4. Moyenne des séries aléatoires mono-thème : X/ 20
    5. Moyenne des séries aléatoires multi-thème : X/ 20
    6. Moyenne des Exercices à télécharger : X/ 20
    7. Moyenne du Suivi Présentiel : X/ 20

[modifier] Fonctionnalités transverses

[modifier] Import/Export de données

Le module d'import/export à été conçu pour importer des données de n'importe quel format et de les exporter vers n'importe quel autre format. Il permet donc l'import de données vers la plate-forme et l'export de données de la plate-forme vers n'importe quel format de fichiers.

Des spécifications ont été rédigées lors de la phase de conception du module et expliquent plus précisément sont fonctionnement:

Import/Export

De plus, ce module, réalisé partielement, à été conçu pour être complété en fonction des besoins d'AFIDE et de ses clients. A cet effet, un HOW TO à été rédigé afin d'expliquer les différentes classes à implémenter pour étendre les formats de fichiers supportés et les entités de plate-forme gérées par le module.

Import/Export-Ajouter des entités

[modifier] CSV

Le format CSV est un format de fichier texte dont les données sont organisées sous la forme de lignes contenant des valeurs séparées par un séparateur (usuellement une virgule -coma-). C'est le format le plus simple utilisable pour l'import-export, et il suffit largement aux données linéaires.

[modifier] QCM

[modifier] Sondages

[modifier] QRC

[modifier] SRC

[modifier] Ftb

[modifier] Ressources textes

[modifier] Utilisateurs (classes virtuelles)

[modifier] XML

[modifier] HTML

[modifier] Excel

[modifier] Word