Différences

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

--- report:trainingsessions:columnlist [2026/01/13 08:19] – créée - modification externe 127.0.0.1
+++ report:trainingsessions:columnlist [2026/10/17 00:47] (Version actuelle) – admin
@@ Ligne 3: / Ligne 3: @@
 =====Liste des colonnes de sortie=====
-Dans la liste ci-dessous, le suffixe détermine la prise en charge du format de ma donnée :
+Les colonnes du rapport résumé (écran //Résumé par participant//, exports Excel, CSV et PDF des rapports de synthèse) sont définies dans l'option //Colonnes de sortie dans le rapport résumé// des réglages du plugin. Elles peuvent être remplacées pour un cours donné par le champ personnalisé de cours //report_trainingsessions_summarycolumns//.
-^ Suffixe ^ Format de données ^
+==== Écrire la liste ====
+Une colonne par ligne, sous la forme ''clé,format''. Le suffixe détermine le format de la donnée dans les sorties Excel :
+^ Suffixe ^ Format de données ^
 | ,n | Numérique |
 | ,a | Format Texte |
@@ Ligne 11: / Ligne 15: @@
 | ,d | Format durée |
+   * Une ligne commençant par ''#'' est ignorée : c'est la façon de désactiver une colonne sans la supprimer.
+   * Les colonnes sont produites dans l'ordre de la liste.
+   * Les lignes vides sont ignorées.
+   * Dans le champ personnalisé d'un cours, la valeur ''**default**'' (ou un champ vide) revient à la liste globale.
-| id,n | identifiant|
+==== Colonnes disponibles ====
-| idnumber,a | identifiant numérique |
-| activitytime,d | temps dans activité|
-| coursetime,d | temps dans le cours|
-| uploadtime,d | mise à jour|
-| elapsedoutofstructure,d | identifiant numérique |
-| elapsed,d | prénom |
-| extelapsed,d | nom  |
-| extotherelapsed,d | identifiant|
-| items,n | identifiant numérique |
-| hits,n | prénom |
-| exthits,n | nom  |
+La dernière colonne indique si la colonne est active dans la liste livrée par défaut.
+=== Identité et profil ===
+^ Clé ^ Format ^ Contenu ^ Par défaut ^
+| ''id'' | n | identifiant Moodle de l'utilisateur | oui |
+| ''idnumber'' | a | numéro d'identification | oui |
+| ''firstname'' | a | prénom | oui |
+| ''lastname'' | a | nom | oui |
+| ''email'' | a | adresse de courriel | oui |
+| ''institution'' | a | établissement | non |
+| ''department'' | a | département | non |
+| ''groups'' | a | groupes de l'utilisateur dans le cours | non |
+=== Dates d'accès et d'inscription ===
-    * id,n
+^ Clé ^ Format ^ Contenu ^ Par défaut ^
-    * idnumber,a
+| ''lastlogin'' | t | dernière connexion à la plate-forme | non |
-    * firstname,a
+| ''firstaccess'' | t | premier accès à la plate-forme | non |
-    * lastname,a
+| ''lastcourseaccess'' | t | dernier accès au cours | oui |
-    * email,a
+| ''enrolstartdate'' | t | début de l'inscription au cours | non |
-    * institution,a
+| ''enrolenddate'' | t | fin de l'inscription au cours | non |
-    * department,a
-    * groups,a
-    * lastlogin,t
-    * firstaccess,t
-    * lastcourseaccess,t
-    * activitytime,d
-    * othertime,d
-    * coursetime,d
-    * uploadtime,d
-    * elapsedoutofstructure,d
-    * elapsed,d
-    * extelapsed,d
-    * extotherelapsed,d
-    * items,n
-    * hits,n
-    * exthits,n
-    * extotherhits,n
-    * visiteditems,n
-    * elapsedlastweek,d
-    * extelapsedlastweek,d
-    * extotherelapsedlastweek,d
-    * hitslastweek,n
-    * exthitslastweek,n;
-    * enrolstartdate,t
-    * enrolenddate,t
-    * workingsessions,n
+Les dates d'inscription retenues sont celles de la dernière période d'inscription active, la plus large, qui commence avant la fin de la période du rapport. Les périodes futures et antérieures sont écartées.
+=== Temps ===
+Les temps sont des durées (format ''d''). Les notions de temps du cours, de temps affecté à aucun cours et de temps complémentaires sont expliquées dans le [[:report:trainingsessions:technique|guide technique]].
+^ Clé ^ Format ^ Contenu ^ Par défaut ^
+| ''activitytime'' | d | temps passé dans les activités du cours (alias ''activityelapsed'') | oui |
+| ''coursetime'' | d | temps passé dans le cours en dehors des activités : accueil du cours, rapports, blocs (alias ''courseelapsed'') | non |
+| ''othertime'' | d | temps affecté à aucun cours (cours 0) : écrans de connexion et de déconnexion (alias ''otherelapsed'') | non |
+| ''elapsed'' | d | temps total dans le cours | oui |
+| ''elapsedoutofstructure'' | d | temps total dans le cours, augmenté du temps affecté à aucun cours | oui |
+| ''extelapsed'' | d | temps étendu : temps total dans le cours, plus le temps affecté à aucun cours, plus le temps de la page d'accueil du site | non |
+| ''extotherelapsed'' | d | temps complémentaires : temps affecté à aucun cours, plus le temps de la page d'accueil du site | oui |
+| ''elapsedlastweek'' | d | temps total dans le cours sur la dernière semaine de la période | non |
+| ''extelapsedlastweek'' | d | temps étendu sur la dernière semaine de la période | non |
+| ''extotherelapsedlastweek'' | d | temps complémentaires sur la dernière semaine de la période | non |
+| ''uploadtime'' | d | temps de dépôt de fichiers. Cette colonne n'est alimentée que si Use Stats fournit un agrégat de dépôt, ce que la version actuelle de Use Stats ne fait pas : la valeur reste à 0. | non |
+=== Éléments et sessions ===
+^ Clé ^ Format ^ Contenu ^ Par défaut ^
+| ''items'' | n | nombre d'éléments de la structure du cours | non |
+| ''visiteditems'' | n | nombre d'éléments visités | non |
+| ''workingsessions'' | n | nombre de sessions de travail liées au cours (alias ''sessions'') | oui |
+=== Événements (hits) ===
+Ces colonnes comptent des événements de trace plutôt que des durées. **Elles ne sont renseignées que pour les administrateurs du site.**
+^ Clé ^ Format ^ Contenu ^ Par défaut ^
+| ''hits'' | n | événements du cours et événements hors cours | non |
+| ''exthits'' | n | événements dans le cours, hors cours et sur la page d'accueil du site | non |
+| ''extotherhits'' | n | événements hors cours et sur la page d'accueil du site | non |
+| ''hitslastweek'' | n | événements dans le cours sur la dernière semaine | non |
+| ''exthitslastweek'' | n | événements étendus sur la dernière semaine | non |
+==== Autres clés utilisables ====
+Ces clés ne figurent pas dans la liste livrée par défaut, mais peuvent y être ajoutées :
+   * ''city'' (a) : ville de l'utilisateur ;
+   * ''firstcourseaccess'' (t) : premier accès au cours ;
+   * ''firstip'' (a) : adresse IP du premier accès au cours ;
+   * ''profile_field_//nomcourt//'' : valeur d'un champ de profil personnalisé, par exemple ''profile_field_service,a'' ;
+   * ''extrauserinfo1'' et ''extrauserinfo2'' (a) : champs de profil désignés dans les réglages du plugin, option //Information utilisateur additionnelle// (méthode ancienne, préférez ''profile_field_'') ;
+   * Avec le module [[:mod:learningtimecheck|Learning Time Check]], lorsque le cours a un suivi de contrat pédagogique : ''ltcprogressinitems'' et ''ltcprogressinmandatoryitems'' (pourcentage d'avancement sur tous les éléments, ou sur les seuls éléments obligatoires), ''ltcitems'' et ''ltcdone'' (éléments et éléments réalisés), ''ltcmandatoryitems'' et ''ltcmandatorydone'' (idem sur les éléments obligatoires).
+==== Liste livrée par défaut ====
+<code>
+id,n
+idnumber,a
+firstname,a
+lastname,a
+email,a
+#institution,a
+#department,a
+#groups,a
+#lastlogin,t
+#firstaccess,t
+lastcourseaccess,t
+activitytime,d
+#othertime,d
+#coursetime,d
+#uploadtime,d
+elapsedoutofstructure,d
+elapsed,d
+#extelapsed,d
+extotherelapsed,d
+#items,n
+#hits,n
+#exthits,n
+#extotherhits,n
+#visiteditems,n
+#elapsedlastweek,d
+#extelapsedlastweek,d
+#extotherelapsedlastweek,d
+#hitslastweek,n
+#exthitslastweek,n
+#enrolstartdate,t
+#enrolenddate,t
+workingsessions,n
+</code>
 <html><!-- nomoodle --></html>
@@ Ligne 69: / Ligne 136: @@
  [[:report:trainingsessions:technique|Index de la section technique composant]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
 <html><!-- /nomoodle --></html>