Différences

Ci-dessous, les différences entre deux révisions de la page.

--- report:trainingsessions:userguide [2026/01/26 15:14] – [La vue de "Programmes de cours" (multicours)] florence
+++ report:trainingsessions:userguide [2026/10/17 00:23] (Version actuelle) – admin
@@ Ligne 4: / Ligne 4: @@
 ==== Introduction ====
-**Pour accéder au rapport de session de formation depuis un (contexte) cours :** Administration/rapport/session de formation
+**Pour accéder au rapport de session de formation depuis un (contexte) cours :** menu //Plus// du cours, puis //Rapports// > //Sessions de formation//.
 Le rapport de session de formation compile les résultats d'analyse des temps de trace du bloc [[:Blocks:UseStats|Mesure d'Activité (Use_Stats)]] et les agrège dans des rapports représentatifs de la structure pédagogique du cours.
 Accessoirement, il est possible d'extraire des états Excel des différentes vues des rapports.
-L'enseignant peut utiliser 6 vues principales :
+Le rapport se présente sous la forme d'onglets. Selon ses droits et la configuration de la plate-forme, l'utilisateur dispose de 8 vues au plus :
-  * La vue individuelle de détail
+^ Onglet ^ Vue ^ Disponible si ^
-  * La synthèse par étudiant
+| Détail du participant | [[#la_vue_individuelle|La vue individuelle de détail]] | toujours |
-  * La vue de groupe (ou cours)
+| Rapport multicours | [[#la_vue_de_programmes_de_cours_multi_cours|La vue de "Programmes de cours"]] (version Pro) | le cours appartient à un groupe de cours |
-  * L'extraction brute de donnée de cours
+| Résumé par participant | [[#resume_par_participant|La synthèse par étudiant]] | capacité //viewother// |
-  * La vue consolidée transverse du site
+| Formation | [[#la_vue_de_groupe_ou_de_cours|La vue de groupe (ou cours)]] | capacité //viewother// |
-  * L'intégration des notes et scores dans les rapports
+| Batchs | [[#l_extraction_de_donnees_brutes_du_cours_le_moteur_de_batchs|L'extraction brute de données de cours]] | capacité //batch// |
+| Tous les cours | [[#l_extraction_consolidee_transverse|La vue consolidée transverse]] | capacité //viewother// |
+| Notes | [[#integration_des_notes_dans_les_rapports_de_sortie|L'intégration des notes et scores dans les rapports]] | capacité //usegrading// |
+| Rapports dédiés | Rapports spécifiques fournis par des sous-plugins //tscustom// | au moins un rapport dédié est défini pour le cours |
+=== Droits d'accès ===
+^ Capacité ^ Rôles par défaut ^ Usage ^
+| ''report/trainingsessions:view'' | enseignant non éditeur, enseignant, gestionnaire | accès au rapport |
+| ''report/trainingsessions:viewother'' | enseignant non éditeur, enseignant, gestionnaire | voir les autres participants (résumé, formation, tous les cours) |
+| ''report/trainingsessions:batch'' | gestionnaire | extraction brute et programmation de batchs |
+| ''report/trainingsessions:iscompiled'' | étudiant | être pris en compte dans les rapports |
+| ''report/trainingsessions:downloadreports'' | gestionnaire, enseignant, enseignant non éditeur | télécharger les états générés |
+| ''report/trainingsessions:usegrading'' | gestionnaire, enseignant | régler l'intégration des notes |
+=== Le formulaire de sélection ===
+Chaque vue propose un formulaire de sélection : mode de début, dates de début et de fin (ou « jusqu'à maintenant »), participant, groupe. La date de début peut être une date choisie ou le début du cours dans toutes les vues ; la date de création du compte et la date d'inscription ne sont proposées que dans les vues centrées sur un participant (détail du participant, rapport multicours, tous les cours). La valeur par défaut est fixée dans les réglages du plugin (//Date de début par défaut//).
+La sélection est mémorisée pour le cours pendant la session de navigation, et partagée par toutes les vues du rapport : changer d'onglet ne la réinitialise pas. En cas de conflit, la priorité est : formulaire soumis, puis paramètres d'URL, puis sélection mémorisée, puis valeurs par défaut.
+Dans les réglages du plugin, les options //Ignorer les étudiants suspendus// et //Ignorer les inscriptions suspendues// permettent d'écarter des rapports les étudiants suspendus, ou ceux qui n'ont que des inscriptions suspendues.
 ==== La vue individuelle ====
@@ Ligne 23: / Ligne 44: @@
 **Modalité : ** Individuelle
 Comme son nom l'indique cette vue sert à examiner le détail des temps d'usage d'un apprenant unique choisi parmi les inscrits au cours.
 La vue individuelle récupère les "gap times" de l'étudiant et les répartit dans une structure représentative de l'organisation pédagogique. Cette structure peut dépendre du format de cours utilisé :
 === Pour les formats en sections ===
@@ Ligne 31: / Ligne 52: @@
 Le rapport est construit sur la base des sections en suivant le plan linéaire de la construction du cours. Une somme partielle par section est donnée.
-Format supportés : Thématique, Hebdomadaire, Flexsection, Tabtopics...
+Formats supportés : Thématique, Hebdomadaire, Flexsection, Tabtopics...
 === Pour les formats paginés ===
@@ Ligne 37: / Ligne 58: @@
 Les formats paginés tels que le [[format:page|format "page"]] organisent le cours en hiérarchie d'écrans.
 La hiérarchie des pages est examinée dans les données du format de cours. Le rapport est présenté ensuite linéairement dans le sens de lecture naturel de la hiérarchie de pages.
 Formats supportés : [[:format:page|le format page]]
@@ Ligne 43: / Ligne 64: @@
 === Etats générés ===
-La vue individuelle exporte un état Excel qui est le reflet exact des données publiées sur la fiche de session individuelle. Il est composé de deux feuilles Excel. La première fournit la table d'extraction des temps réalisés sur la structure de cours. La deuxième est dédiée à la liste des sessions de connexion.
+La vue individuelle exporte un état Excel qui est le reflet exact des données publiées sur la fiche de session individuelle. Il est composé de deux feuilles Excel. La première fournit la table d'extraction des temps réalisés sur la structure de cours. La deuxième est dédiée à la liste des sessions de connexion ; elle n'est produite que si l'option //Voir le détail des sessions// est activée dans les réglages du plugin.
 === Affichage des sessions ===
-Les sessions affichées dans la vue individuelle sont restreintes au sessions de travail qui traversent le cours dans lequel on visualise le rapport. Une session est une séquence continue d'interactions entre l'utilisateur et la plate-forme à partir d'une trace explicite de connexion (loggedin) et une déconnexion constatée.
+Les sessions affichées dans la vue individuelle sont restreintes aux sessions de travail qui traversent le cours dans lequel on visualise le rapport. Une session est une séquence continue d'interactions entre l'utilisateur et la plate-forme, depuis une trace explicite de connexion (loggedin) jusqu'à une déconnexion constatée. Pour un cours appartenant à un groupe de cours, sont retenues les sessions qui traversent au moins un des cours du groupe. Voir le [[:report:trainingsessions:technique|guide technique]] pour le détail du calcul.
-==== La vue de "Programmes de cours"  (multi cours) ====
+==== La vue de "Programmes de cours" (multi cours) ====
-Uniquement en version "Pro" du Trainingsessiosn.
+Uniquement en version "Pro" du TrainingSessions.
-Si des groupes de cours sont décrits dans les réglages généraux du plugin et si le cours courant appartient à un de ces groupes de cours (un seul possible), alors cet onglet apparaîtra pour obtenir un rapport consolidé sur l'ensemble des cours du groupe.
+Les groupes de cours se définissent dans les réglages généraux du plugin, dans l'option //Groupes de cours// : un groupe par ligne, sous la forme d'une liste d'identifiants de cours séparés par des virgules. Si le cours courant appartient à un de ces groupes de cours (un seul possible), alors l'onglet //Rapport multicours// apparaît pour obtenir un rapport consolidé sur l'ensemble des cours du groupe.
-Les indicateurs généraux sont additionnés, et le détail de chaque cours apparaît dans le rapport.
+Les indicateurs généraux sont additionnés, et le détail de chaque cours apparaît dans le rapport. Les bornes de dates sont calculées sur l'ensemble du groupe, et les temps hors cours ne sont comptés qu'une seule fois.
 ==== Résumé par participant ====
 Cet écran affiche une vue compacte des données qui seront extraites dans le "rapport de synthèse". Ce rapport est une sortie compacte, avec un étudiant par ligne sur une population donnée.
 //Avertissement performance :// Cet écran compile en temps réel les agrégations de temps des étudiants de la sélection. Il peut provoquer une charge importante à très importante sur des groupes de grande taille. On préférera pour ces cours opter pour une sortie par groupe réduits, ou une sortie différée par la programmation de batchs.
+=== Les colonnes du résumé ===
+Les colonnes affichées sont définies dans l'option //Colonnes de sortie dans le rapport résumé// des réglages du plugin : une clé de colonne par ligne. Une colonne se désactive en plaçant un ''#'' en début de ligne, et l'ordre de sortie se modifie en réordonnant la liste. Chaque clé est associée à un format : ''a'' pour du texte, ''t'' pour une date, ''d'' pour une durée, ''n'' pour un nombre. Les dates de début et de fin d'inscription font partie des colonnes disponibles. La [[:report:trainingsessions:columnlist|liste complète des colonnes de sortie]] est décrite à part.
+Ces colonnes peuvent être personnalisées **pour un cours donné** grâce au champ personnalisé de cours //report_trainingsessions_summarycolumns// : saisissez une clé de colonne par ligne. Si le champ est vide ou contient ''**default**'', la liste globale s'applique.
 === La sélection "Groupe" ou "Tous les groupes" ou "Groupe des enseignants du cours" ===
@@ Ligne 70: / Ligne 97: @@
 Elle permet d'avoir une vue d'ensemble sur les avancements du groupe ou du cours, lorsque seules les visites des activités suffisent à suivre la progression des étudiants. Si vous désirez avoir un suivi plus sophistiqué des avancements, vous utilisez alors plutôt les fonctions d'achèvement du cours, ou un module comme le [[:ModLearningTimeCheck|Suivi des temps d'apprentissages]] ou l'usage du bloc Progression.
-La vue "groupe" ou "cours" permet de réduire la vision à un seul groupe dans le cas de cours "chargés". L'état extrait par cette vue tient compte de cette sélection dans le formulaire de choix supérieur.
+Les barres de progression des interfaces Web du rapport peuvent être masquées grâce à l'option //Afficher les barres de progression// des réglages du plugin.
-L'état produit est un classeur assemblant les des mêmes deux feuilles que la vue de détail de l'étudiant pour tous les étudiants de la sélection. Il faut veiller à ne pas demander une production d'un état sur une trop grande population étant donné que le nombre de feuilles total d'un classeur Excel est limité.
+==== La vue de groupe ou de cours ====
+**Modalité :** Groupe/Cours
+La vue "groupe" ou "cours" (onglet //Formation//) permet de réduire la vision à un seul groupe dans le cas de cours "chargés". L'état extrait par cette vue tient compte de cette sélection dans le formulaire de choix supérieur.
+L'état produit est un classeur assemblant les mêmes deux feuilles que la vue de détail de l'étudiant pour tous les étudiants de la sélection. Il faut veiller à ne pas demander une production d'un état sur une trop grande population étant donné que le nombre de feuilles total d'un classeur Excel est limité.
 ==== L'extraction de données "brutes" du cours / Le moteur de "batchs" ====
@@ Ligne 78: / Ligne 111: @@
 **Modalité :** Groupe/Cours
-Cette vue est essentiellement destinée à organiser la production d'états réguliers et systématiques, soit sous la forme des états détaillés tels qu'ils peuvent être obtenus dans les deux précédentes vues, soit sous une forme plus condensée.
+Cette vue (onglet //Batchs//, réservé aux utilisateurs ayant la capacité //batch//) est essentiellement destinée à organiser la production d'états réguliers et systématiques, soit sous la forme des états détaillés tels qu'ils peuvent être obtenus dans les deux précédentes vues, soit sous une forme plus condensée.
 Lorsque la sélection est d'une taille raisonnable, une compilation "immédiate" est réalisée. Sinon, vous avez accès à un programmateur qui permet de planifier la production des rapports à des heures de faible audience.
+=== Programmer un batch ===
+Le formulaire //Ajouter un batch// demande :
+   * **Construction du rapport** : un participant complet par feuille, un participant (résumé) par ligne dans une feuille unique, rapports de session seulement, ou //Jours ouvrés (alternants)//. Ce dernier choix n'apparaît que si le couplage avec Learning Time Check est activé dans les réglages et que des jours ouvrés sont déclarés.
+   * **Portée** : cours courant, tous les cours, ou le groupe de cours (//Programme//) si le cours en fait partie. Le groupe de cours est résolu au moment de l'exécution. La portée n'est pas proposée pour les rapports "un participant par ligne" ni pour les jours ouvrés, qui portent toujours sur le cours courant.
+   * **Format du document** : texte (CSV) et XLS, ainsi que PDF et JSON dans la version Pro.
+   * **Répertoire de sortie** : un chemin absolu sur le serveur.
+   * **Date de la tâche** : le moment où le rapport doit être produit.
+   * **Répétition** (options de la version Pro) : //Exécuter une fois//, //Rejouer le même rapport//, //Rejouer en période glissante// (les dates de début et de fin sont décalées de l'intervalle à chaque exécution) ou //Rejouer et décaler la fin de période uniquement//.
+   * **Intervalle de répétition** (en minutes, 1440 par défaut) : si la valeur est positive, le batch n'est pas supprimé après exécution mais remis en jeu décalé de ce délai.
+Les batchs programmés sont exécutés par la tâche planifiée //Rapports différés// de Moodle, qui s'exécute par défaut à 3h00 chaque nuit du mardi au samedi. Cette fréquence se règle dans l'administration des tâches planifiées. Des scripts en ligne de commande sont aussi fournis (répertoire ''cli'') pour lancer tous les batchs des cours ou extraire des rapports CSV.
 Notez que la table de programmation vous permet de demander la production "immédiate" d'une des programmations de rapport. Vous devez simplement utiliser cette possibilité avec prudence si la population sur laquelle porte le rapport est importante.
 Notez que la compilation des temps recalcule systématiquement les données de journalisation de Moodle. Il n'est actuellement pas prévu de modèle de données de précalcul qui permettrait d'alléger (en contrepartie d'une perte de flexibilité) le poids de traitement de la requête.
+Les rapports générés et conservés dans la zone de fichiers du plugin peuvent être supprimés automatiquement : l'option //Horizon de suppression// des réglages fixe l'âge au-delà duquel ils sont supprimés par la tâche planifiée //Suppression des anciens rapports// (la valeur 0, par défaut, les conserve indéfiniment).
 ==== L'extraction consolidée transverse ====
@@ Ligne 90: / Ligne 139: @@
 **Modalité :** Individuelle
-Ce rapport donne un bilan pour un étudiant particulier de temps exécutés sur l'ensemble des cours auxquels il participe.
+Cet onglet //Tous les cours// donne un bilan pour un étudiant particulier de temps exécutés sur l'ensemble des cours auxquels il participe. L'état Excel produit comporte une feuille de synthèse sur l'ensemble des cours et, si l'option //Voir le détail des sessions// est activée, une feuille des sessions.
 ==== Intégration des notes dans les rapports de sortie ====
-Cet écran, en plus de champs de sortie configurés dans la configuration globale du plugin, permettent d'ajouter un certain nombre d'items de note aux rapports générés.
+Cet écran (onglet //Notes//, réservé aux utilisateurs ayant la capacité //usegrading//), en plus de champs de sortie configurés dans la configuration globale du plugin, permet d'ajouter un certain nombre d'items de note aux rapports générés.
    * La note globale du cours