Différences

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

--- blocks:usestats:technique:settings [2026/01/13 08:19] – créée - modification externe 127.0.0.1
+++ blocks:usestats:technique:settings [2026/10/18 00:26] (Version actuelle) – admin
@@ Ligne 1: / Ligne 1: @@
 <html><!-- nomoodle --></html>{{ :blocks:logo-apl.png?nolink |}}<html><!-- /nomoodle --></html>
-===== Bloc Use Stats (Mesure d'activité) : Configuration Générale=====
+===== Bloc Use Stats (Mesure d'activité) : Configuration générale =====
 {{ :blocks:usestats:technique:usestat.png?nolink&300|}}
+Les réglages généraux donnent au bloc Use Stats la flexibilité nécessaire pour s'adapter à l'usage de la plate-forme. Ils conditionnent aussi les temps calculés par les rapports qui s'appuient sur le bloc, notamment [[:report:trainingsessions|Sessions de formation]].
-A partir de la version 2016020600, des nouveaux réglages généraux donnent une plus grande flexibilité au bloc Use Stats :
+==== Réglages de l'affichage du bloc ====
-==== Réglages de l'affichage  du bloc=====
 Ces réglages concernent ce qui est affiché dans l'espace du bloc lorsqu'il est inséré dans un écran de Moodle.
-Chemin : Admin du site/Plugins/blocs/mesures d'activité.
+Chemin : Administration du site / Plugins / Blocs / Mesure d'activité.
 {{ :blocks:usestats:technique:reglages-usestats1-fr.png?nolink&950 |}}
-**Depuis :** Afin de ne pas trop surcharger la page par une exploration de nombreuses traces à chaque affichage, la période de compilation par défaut est réglée à 90 jours. Vous pouvez la réduire pour des sites à très forte activité, et laisser les utilisateurs l'augmenter ponctuellement pendant une session s'ils en ont besoin. Notez que les temps affichés ne calculent bien évidemment que les temps compris dans la période de complation. Ce réglage est spécifié en "jours passés" à partir de la date courante.
+**A partir de :** afin de ne pas surcharger la page par l'exploration de nombreuses traces à chaque affichage, la période de compilation par défaut est de 60 jours. Vous pouvez la réduire pour des sites à très forte activité, et laisser les utilisateurs l'augmenter ponctuellement pendant une session s'ils en ont besoin. Les temps affichés ne comptent évidemment que la période de compilation. Ce réglage est exprimé en "jours passés" à partir de la date courante.
-**Filtrer les temps inférieurs à :** en dessous de ce temps (en secondes), les cours ne sont plus mentionnés dans l'affichage. Cela permet de clarifier l'affichage de la statistique. Un petit signal en bas de l'interface vous signalera que tous les cours et leurs temps ne sont pas complètement affichés.
+**Mode de rétrospective et source de la rétrospective :** la période peut être glissante ou à date fixe, et choisie par l'étudiant ou imposée par le réglage.
-**Afficher le temps "Hors cours" :** S'il est actif, le temps passé dans les pages d'accueil, les pages générales du site, ou d'autres espaces qui ne sont pas assimilables à des cours seront affichés. sinon, ces temps sont extraits du calcul.
+**Filtrer les temps inférieurs à :** en dessous de ce temps (en secondes, 60 par défaut), les cours ne sont plus mentionnés dans l'affichage. Cela clarifie l'affichage de la statistique. Un petit signal en bas de l'interface indique que tous les cours et leurs temps ne sont pas complètement affichés.
-**Temps de référence à afficher :** Étant donné la variabilité réglementaire en matière de validation des temps, vous pouvez ici choisir quel sera le temps de référence pour l'affichage :
+**Afficher le temps "Hors cours" :** s'il est actif (par défaut), le temps passé dans la page d'accueil, les pages générales du site ou d'autres espaces qui ne sont pas assimilables à des cours est affiché. Sinon, ces temps sont extraits du calcul.
-   - //Le temps complet du cours :// Ce temps comprend toutes les traces et temps intercalaires du cours.
-   - //Le temps des activités :// Ce temps ignore les temps intercalaires du cours qui ne sont pas explicitement affectable à des modules d'activités formels de Moodle. Il est donc important de bien réfléchir à la conception des cours afin que des apprentissages effectifs ne se voient pas ignorés parce qu'il n'ont pas de contexte d'activité désigné.
-==== Réglages de l'analyseur d'historique (des traces) ====
+**Temps de référence à afficher :** étant donné la variabilité réglementaire en matière de validation des temps, vous pouvez choisir le temps de référence pour l'affichage :
+   - //Le temps complet du cours :// ce temps comprend toutes les traces et temps intercalaires du cours.
+   - //Le temps des activités :// ce temps ignore les temps intercalaires du cours qui ne sont pas explicitement affectables à des modules d'activités formels de Moodle. Il est donc important de bien concevoir les cours afin que des apprentissages effectifs ne soient pas ignorés parce qu'ils n'ont pas de contexte d'activité désigné.
+**Style du calendrier :** thème du sélecteur de date.
+==== Réglages de l'analyseur d'historique (des traces) ====
 {{ :blocks:usestats:technique:reglages-usestats2-fr.png?nolink&950 |}}
-**Seuil (de détection des déconnexions) :** Ce temps détermine en secondes, le temps d'inactivité au dessus duquel l'analyseur va conclure à une interruption potentielle de la session de travail et simuler une déconnexion. Par défaut, ce temps est de 10 minutes (600 secondes). Ce temps doit être ajusté avec attention et est très dépendant de la stratégie de publication pédagogique dans Moodle. si vous découpez fortement le contenu en très petits grains qui nécessitent de nombreux rechargement de pages, vous pouvez alors le réduire, en diminuant le "biais" de mesure. Si au contraire, vous découpez grossièrement votre contenu pédagogique ou publiez des gros documents qui induisent des temps de travail non interactifs de longue durée, vous devrez l'augmenter, mais augmenterez aussi l'incertitude sur la mesure.
+**Seuil (de détection des déconnexions) :** ce délai, exprimé en **minutes** (60 par défaut), détermine le temps d'inactivité au-delà duquel l'analyseur conclut à une interruption de la session de travail et simule une déconnexion. Ce seuil doit être ajusté avec attention et dépend fortement de la stratégie de publication pédagogique. Si vous découpez le contenu en très petits grains qui nécessitent de nombreux rechargements de pages, vous pouvez le réduire, ce qui diminue le biais de mesure. Si au contraire vous découpez grossièrement votre contenu ou publiez de gros documents qui induisent de longs temps de travail non interactifs, vous devrez l'augmenter, au prix d'une incertitude plus grande sur la mesure.
-**Crédit temps supplémentaire sur le dernier ping :** Lorsqu'une déconnexion est simulée, l'analyseur de trace ne peut pas savoir combien de temps l'utilisateur a continué à travailler ou être présent sur la dernière page visitée. Sanctionner une fin de session apparente par un temps nul pourrait dans certains cas défavoriser le calcul de temps de l'étudiant. Ce paramètre permet d'accorder un crédit temps correctif sur ces événements. L'expérience montre qu'il ne faut pas accorder un crédit temps trop important, car les statistiques calculées pourraient paraitre très au dessus de la perception réelle du temps de travail. En général, on s'accorde sur quelques minutes.
+**Crédit exceptionnel de fin de session :** lorsqu'une déconnexion est simulée, l'analyseur ne peut pas savoir combien de temps l'utilisateur a continué à travailler sur la dernière page visitée. Sanctionner une fin de session apparente par un temps nul pourrait défavoriser l'étudiant. Ce paramètre, exprimé en **minutes** (15 par défaut), accorde un crédit correctif sur ces événements. L'expérience montre qu'il ne faut pas le fixer trop haut : les statistiques pourraient paraître très au-dessus de la perception réelle du temps de travail. En général, on retient quelques minutes.
-==== Réglage du tracking multidimensionnel ====
+**Une session par cours :** si activé, une nouvelle session commence chaque fois que la trace change de cours. Sinon, une session peut chevaucher plusieurs cours.
+**Filtre sur les inscriptions :** si actif (par défaut), les traces ne sont compilées qu'à partir de la date d'inscription active la plus ancienne, et au plus tôt à la date de démarrage du cours.
+**Date de dernière compilation :** en modifiant cette date, vous déclenchez le recalcul de toutes les valeurs à partir de cette date.
+**Compilation restreinte au cours :** lorsqu'un rapport porte sur un cours (ou un groupe de cours), seuls les logs de ce cours et ceux de niveau site sont chargés. Les résultats du cours sont identiques, mais les temps des autres cours ne sont pas calculés dans ce contexte.
+**Nombre maximum d'entrées de log pour l'affichage du bloc :** 50000 par défaut. Au-delà, un avertissement est affiché à la place du calcul, pour éviter les erreurs de mémoire pour les utilisateurs très actifs.
+**Modules ignorés et modules capturés :** le temps des modules ignorés est exclu du calcul. Les modules capturés (''learningtimecheck'' par défaut) ne sont pas comptabilisés pour eux-mêmes : leur durée est ajoutée à la première trace significative suivante. Les listes sont des noms techniques de modules séparés par des virgules, sans espaces. Voir [[:blocks:usestats:includeignoremodules|Exclusion, inclusion de modules]].
+==== Réglage du tracking multidimensionnel (PRO) ====
 {{ :blocks:usestats:technique:reglages-usestats3-fr.png?nolink&950 |}}
 //Image modifiée avec affichage de 2 zones de qualifieurs sur les 6//
-L'extraction multidimensionnelle est un dispositif optionnel destiné à faciliter l'extraction et l'exploitation des traces par des outils d'analyse de données tiers. Des outils externes de reporting permettent de générer des rapports d'autant plus utiles que les données sont qualifiées et peuvent être affichées de manière intelligibles par les exploitants. A cette fin, ce dispositif permet d'ajouter aux enregistrements d'historiques des "valeurs explicites", comme par exmple le titre du'ne catégorie, le nom d'un cours, le login de l'utilisateur, là où les traces standard de Moodle n'enregistrent que des identifiants internes (id numériques).
+L'extraction multidimensionnelle est un dispositif optionnel destiné à faciliter l'exploitation des traces par des outils d'analyse de données tiers. Les outils de reporting externes produisent des rapports d'autant plus utiles que les données sont qualifiées. Ce dispositif permet d'ajouter aux enregistrements d'historique des "valeurs explicites", par exemple le titre d'une catégorie, le nom d'un cours ou le login de l'utilisateur, là où les traces standard de Moodle n'enregistrent que des identifiants numériques internes.
-Attention, l'activation du tracking multidimensionnel ne doit être faite que pour répondre à une vrai nécessité d'analyse. La masse de données générées par la qualification des historiques peut être très importante et diminuer les performances générales de Moodle pour des sites à fréquentation très élevée.
+Attention : l'activation du tracking multidimensionnel ne doit être faite que pour répondre à un vrai besoin d'analyse. La masse de données générées par la qualification des historiques peut être très importante et dégrader les performances générales de Moodle sur les sites à très forte fréquentation.
+**Activation de la compilation du cube statistique :** si vous activez cette option, la tâche planifiée de Moodle qualifie tous les historiques entrants depuis son dernier passage. L'activation sur un site ayant déjà une forte antériorité peut conduire à une très longue période de rattrapage.
-**Activation du tracking multidimensionnel :** Si vous activez cette option, une tache programmée de Moodle va qualifier tous les historiques entrants depuis le dernier passage du cron. Notez que l'activation de cette fonction sur un site ayant déjà une forte antériorité d'exploitation peut conduire à une période très longue de rattrapage. (Voir RoadMap)
+**Alimentation des qualifieurs :** vous pouvez définir jusqu'à 6 qualifieurs sous forme de balises personnalisées (''customtag1'' à ''customtag6''), renseignées par vos propres requêtes. Pour chaque historique traité, chaque requête exprimée est exécutée et son résultat est stocké dans la table du cube.
-**Alimentation des qualifieurs :** vous pouvez définir ici jusqu'à 6 qualifieurs sous forme de balises personnalisées qui seront renseignés par vos propres requêtes. Pour chaque historique traité, chaque requête de qualifieur exprimée sera exécutée et son résultat sera stocké dans la table multidimensionnelle.
-Pour des raisons d'optimisation, les qualifieurs on été prédéfinis à une certaine longueur :
+Pour des raisons d'optimisation, la longueur des qualifieurs est prédéfinie :
    * 20 caractères pour les 3 premiers qualifieurs
    * 128 caractères pour les 3 derniers qualifieurs
-Pour être valide, la requête écrite ne doit retourner qu'une seule valeur unique par ligne. La requête peut contenir quelques emplacements de variables contextuelles qui seront remplacées avant l'exécution :
+Pour être valide, la requête ne doit retourner qu'une seule valeur. Elle peut contenir des emplacements de variables contextuelles, remplacés avant l'exécution :
-   * <nowiki><%%LOGID%%></nowiki> : L'identifiant numérique de l'historique
-   * <nowiki><%%USERID%%></nowiki> : L'identifiant d'utilisateur assigné à cet historique
-   * <nowiki><%%%%COURSEID%%></nowiki> : L'identifiant de cours contexte de cet historique
-   * <nowiki><%%CMID%%></nowiki> : L'éventuel identifiant de module d'activité si cet historique est dans un contexte de module.
+   * <nowiki><%%LOGID%%></nowiki> : l'identifiant numérique de l'historique
+   * <nowiki><%%USERID%%></nowiki> : l'identifiant de l'utilisateur de cet historique
+   * <nowiki><%%COURSEID%%></nowiki> : l'identifiant du cours contexte de cet historique
+   * <nowiki><%%CMID%%></nowiki> : l'éventuel identifiant du module d'activité si cet historique est dans un contexte de module
-**Date du dernier enregistrement compilé :** Le processus de qualification est différentiel : il ne calcule que les lignes nouvelles depuis son dernier passage. Lors de l'accès au formulaire de configuration, ce champ vous indiquera la date du dernier historique qualifié. vous pouvez alors altérer cette date pour demander à la tâche programmée de recommencer les calculs à la date voulue.
+**Date du dernier enregistrement compilé :** le processus de qualification est différentiel : il ne calcule que les lignes nouvelles depuis son dernier passage. Vous pouvez altérer la date de dernière compilation pour demander à la tâche planifiée de recommencer les calculs à la date voulue.
-==== Tracking actif de session ====
+==== Tracking actif de session (PRO) ====
-Cette fonctionnalité vise à fournir une alternative à la détection heuristique de fin de sessions, dont on sait qu'elle introduit nécessairement un biais d'analyse qui peut être plus ou moins corrigé par des méthodes non exactes.
+Cette fonctionnalité fournit une alternative à la détection heuristique des fins de session, qui introduit nécessairement un biais d'analyse que l'on ne peut corriger que de façon approximative.
-Le tracking actif va obliger la page de l'utilisateur d'envoyer un signal actif à Moodle tant qu'elle n'est pas refermée. La sécurisation des sessions par tracking "actif" ne présume pas de l'activité de l'utilisateur derrière son écran. De plus la version actuelle du tracking actif ne prend pas en compte des navigations parallèles du même utilisateur dans des fenêtres différentes.
+Le tracking actif oblige la page de l'utilisateur à envoyer un signal à Moodle tant qu'elle n'est pas refermée. La sécurisation par tracking actif ne présume pas de l'activité réelle de l'utilisateur devant son écran. De plus, la version actuelle du tracking actif ne prend pas en compte les navigations parallèles du même utilisateur dans des fenêtres différentes. Cette méthode doit donc être utilisée avec précaution, car elle peut mesurer des comportements locaux non pertinents (page laissée ouverte).
+Le signal n'est émis que si le thème appelle la fonction ''block_use_stats_setup_theme_notification()'' : voir le [[:blocks:usestats:install|guide d'installation]].
 {{ :blocks:usestats:technique:reglages-usestats4-fr.png?nolink&950 |}}
+**Activer le maintien de session :** désactivé par défaut.
-**Période d'émission du tracking actif :** Par défaut l'émission est préréglée à 10 minutes (600 secondes).
+**Période d'émission :** en secondes, 600 (10 minutes) par défaut. Choisissez la plus grande valeur qui maintienne la cohérence de votre suivi, en tenant compte du seuil de l'analyseur.
-**Émettre le maintien de session si **: Il s'agit de la règle pour la fourniture de l'émetteur. Tous les utilisateurs de Moodle ne sont pas nécessairement concernés par le tracing. Afin d'optimiser les performances de fonctionnement de la plate-forme, il est souhaitable de ne restreindre l'obligation de suivi qu'aux utilisateurs concernés. Ce réglage permet de définir une règle discriminante pour inclure ou exclure certains types d'utilisateurs du tracking :
+**Émettre le maintien de session si :** règle de désignation des utilisateurs concernés. Tous les utilisateurs ne sont pas nécessairement concernés par le suivi. Pour optimiser les performances de la plate-forme, il est souhaitable de restreindre le suivi aux utilisateurs concernés :
    * Activer pour tous les utilisateurs
    * Activer pour ceux qui respectent la règle
-   * Activer SAUF pour ceux qui respectent la règle
+   * Activer SAUF pour ceux qui respectent la règle (valeur par défaut)
-**Méthode :** La méthode pour l'application de la règle. vous pouvez établir une règle sur "capacité" (la règle est accomplie si la capacité est disponible sur le contexte système), ou sur la présence d'une valuer 'vraie' (non vide ou non nulle) d'un champ de profil.
+**Méthode :** méthode d'application de la règle. La règle peut porter sur une capacité (elle est accomplie si la capacité est disponible dans le contexte système) ou sur un champ de profil (elle est accomplie si le champ a une valeur non vide et non nulle).
-**Nom de l'item de contrôle :** La capacité, ou la désignation du champ de profil sur lequel la règle s'appuie.
+**Nom de l'item de contrôle :** la capacité ou le champ de profil sur lequel s'appuie la règle. Par défaut, la règle est "SAUF si ''moodle/site:config''", ce qui exclut les administrateurs du site.
 ----------
 <html><!-- nomoodle --></html>
-[[:blocks:usestats:Technique|Revenir à l'index du guide technique]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
+[[:blocks:usestats:technique|Revenir à l'index du guide technique]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
 <html><!-- /nomoodle --></html>