Différences

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

--- report:trainingsessions:techniques:settings [2026/01/13 08:19] – créée - modification externe 127.0.0.1
+++ report:trainingsessions:techniques:settings [2026/10/17 09:20] (Version actuelle) – admin
@@ Ligne 2: / Ligne 2: @@
 =====Rapport sur les temps de formation (TrainingSessions) : Guide technique : les settings=====
+Les réglages du composant se trouvent dans l'administration du site. Les réglages de calcul des temps (seuil d'inactivité, crédit de dernier ping, une session par cours, modules ignorés...) ne sont pas portés par ce composant : ils sont ceux du bloc [[:blocks:usestats:technique|Use Stats]].
 ====Chemin d'accès====
-  * Chemin : Administration du site/Plugins/Rapports/Sessions de formation
+  * Chemin : Administration du site / Rapports / Sessions de formation
 ====Sessions====
@@ Ligne 11: / Ligne 12: @@
 {{ :report:trainingsessions:techniques:rapport-03.jpg?nolink |}}
-**Colonnes de sortie par défaut :**
+Les options de cette partie règlent le contenu général des rapports.
-  * **id,n :** Identifiant
+  * **Encodage CSV** : encodage des fichiers CSV produits (UTF-8 par défaut, ou ISO pour les anciennes versions d'Excel).
-  * **idnumber,a :** Numéro d'identification externe
+  * **Destinataire** et **Titre du rapport de session** : destinataire par défaut des rapports différés, et titre imprimé sur la première page du rapport de session individuel.
-  * **firstname,a :** Prénom
+  * **Afficher le numéro d'identification**, **Afficher les secondes**, **Afficher le lieu de la formation**, **Afficher le total de session** : options d'affichage dans les rapports.
-  * **lastname,a :** Nom
+  * **Masquer les modules sans temps** (oui par défaut) : les modules sans aucune activité ne sont pas listés.
-  * **email,a :** Email
+  * **Date de début par défaut** : date de départ de la période d'un rapport - début du cours (par défaut), création du compte, ou date d'inscription de l'utilisateur.
-  * **lastcourseaccess,t :** Dernier accès au cours
+  * **Exclure les inscriptions / utilisateurs suspendus** : écarte du rapport les inscriptions ou utilisateurs suspendus (non par défaut).
-  * **activitytime,d :** Temps passé dans les activités
+  * **Afficher l'achèvement** (oui par défaut) : ajoute l'état d'achèvement dans les rapports individuels.
-  * **elapsedoutofstructure,d :** Temps passé dans des écrans assimilables au cours, mais hors structure du cours lui-même.
+  * **Informations utilisateur additionnelles** : deux champs de profil à ajouter aux rapports. Pour les nouveaux paramétrages, préférez les clés ''profile_field_//nomcourt//'' dans la liste des colonnes.
-  * **elapsed,d :** Temps passé dans le cours
+  * **Suppression des anciens rapports** : âge (en jours) au-delà duquel les rapports générés par les tâches différées sont supprimés. La valeur 0 (par défaut) conserve les fichiers indéfiniment : rien n'est supprimé. La suppression est effectuée chaque nuit par la tâche planifiée //Suppression des anciens rapports//.
-  * **extotherelapsed,d :** Temps passé dans la session de cours non imputé au cours hors cours (Course ID=0 ou ID=1)
-  *  ** exelapsed,d :** Temps passé dans le cours + les extother elapsed (temps de la session de travail au sens large)
-  * **workingsessions,n :** Nombre de sessions de travail - 2 possibles : log je travaille je delog OU chaque sortie du cours pour entrer dans un autre suivant les settings centraux du composant Usestats (Une session par cours : block_use_stats | onesessionpercourse).
-**Autres colonnes possibles :**
+**Colonnes de sortie du rapport résumé :**
-   * **institution,a :** Champ Institution du profil apprenant
+Le réglage //Colonnes de sortie dans le rapport résumé// contient une colonne par ligne, sous la forme ''clé,format''. Les colonnes actives par défaut sont : identifiant, numéro d'identification, prénom, nom, email, dernier accès au cours, temps passé dans les activités, temps hors structure du cours, temps passé dans le cours, temps complémentaires, nombre de sessions de travail.
-   * **department,a :** Champ Département du profil apprenant
-   * **groups,a :** Liste des groupes (uniquement sur un rapport de cours unique)
+Pour la définition de chaque colonne, les formats ''n'', ''a'', ''t'' et ''d'', la façon de désactiver une colonne avec ''#'' et la personnalisation par cours, voir la page [[:report:trainingsessions:columnlist|Liste des colonnes de sortie]].
-   * **lastlogin,t :** Date de dernière connexion à la plate-forme
-   * **firstaccess,t :** Date de premier accès à la plate-forme
-   * **othertime,d :** Temps passé dans d'autres cours durant la session
-   * **coursetime,d :**
-   * **uploadtime,d :** Temps imputable à des actions de téléchargement et remises de documents
-   * **extelapsed,d :** Temps passé dans le cours ET dans les espaces centraux
-   * **items,n :** Nombre d'items pédagogiques (activités et ressources)
-   * **hits,n :** Nombre de requêtes (actions) dans le cours
-   * **exthits,n :** Nombre de requêtes étendu aux espaces centraux
-   * **extotherhits,n :** Nombre de requêtes dans des espaces non imputables aux cours
-   * **visiteditems,n :** Nombre d'items pédagogiques (activités ou ressources accédés au moins une fois)
-   * **elapsedlastweek,d :** Temps passé dans le cours dans le semaine précédente
-   * **extelapsedlastweek,d :** Temps étendu passé dans la semaine précédente
-   * **extotherelapsedlastweek,d :** Temps non imputable au cours passé dans la semaine précédente
-   * **hitslastweek,n :** Nombre total de requêtes (actions) de la semaine précédente
-   * **exthitslastweek,n :** Nombre total de requêtes (actions) étendues de la semaine précédente
-   * **enrolstartdate,t :** Date d'inscription. Dans le cas d'un rapport multicours, la première date d'inscription.
-   * **enrolenddate,t :** Date de fin d'inscription. Dans le cas d'un rapport multicours, la dernière date de clôture d'inscription.
 ====Notes====
 {{ :report:trainingsessions:techniques:rapport-04.jpg?nolink |}}
+Cette partie règle le calcul et l'export des notes dans les rapports (onglet //Notes//).
+  * **Mode de calcul des notes de temps** et **Mode de calcul des notes de bonus** : modes proposés par défaut dans le formulaire des réglages de notes d'un cours.
+  * **Source du temps pour les notes** : source de temps utilisée par défaut pour la note de temps.
+  * **Forcer les valeurs discrètes** (oui par défaut) : arrondit les notes à des valeurs entières.
+  * **Format de note pour Excel** : nombre de décimales dans les exports Excel (entier, une ou deux décimales).
+  * **Locale d'export Excel** : permet de forcer la locale lors d'un export Excel si la version d'Excel n'est pas dans la langue d'usage de Moodle. Laisser vide pour utiliser la locale par défaut de Moodle.
 ====Couleurs====
-Cette partie vous permet de renseigner les couleurs qui apparaitront sur vos rapports au format PDF
+Cette partie vous permet de renseigner les couleurs qui apparaîtront sur vos rapports au format PDF. Sept couleurs sont réglables :
-  * Couleur du fond 1 et couleur du texte 1 : Couleurs de fond et du texte en-tête de colonne (bleu foncé et blanc pour le texte dans l'exemple en bas de page)
+  * **Couleur du texte** : couleur du texte général du document (noir par défaut).
-  * Couleur du fond 2 et couleur du texte 2 : Couleurs de fond et du texte des lignes des détails (gris dans l'exemple en bas de page)
+  * **Couleur du fond 1 et couleur du texte 1** : couleurs de fond et de texte de l'en-tête de colonnes (bleu-vert et blanc par défaut ; bleu foncé et blanc dans l'exemple en bas de page).
-  *   * Couleur du fond 3 et couleur du texte 3 : Couleurs de fond et du texte ligne des cumuls des sections (bleu clair dans l'exemple en bas de page)
+  * **Couleur du fond 2 et couleur du texte 2** : couleurs de fond et de texte des lignes de détail (gris dans l'exemple en bas de page).
+  * **Couleur du fond 3 et couleur du texte 3** : couleurs de fond et de texte des lignes de cumul des sections (rouge brique et blanc par défaut ; bleu clair dans l'exemple en bas de page).
 {{ :report:trainingsessions:techniques:rapport-05.jpg?nolink |}}
@@ Ligne 66: / Ligne 55: @@
 ====Mise en page====
-/Si vous cochez la case "Afficher les événements" (defaut : non) , sera affiché le nombre d'événements (hits)  affiché dans les rapports au format CSV
+**Colonnes d'événements et d'éléments :** les cases //Afficher les événements (hits)//, //Afficher les sessions//, //Afficher les sections seulement//, //Afficher le premier accès aux éléments//, //Afficher le dernier accès aux éléments// et //Afficher les rapports rapides mensuels// sont toutes décochées par défaut. L'affichage des événements (hits) n'est renseigné que pour les administrateurs du site.
-/Cette partie vous permet de renseigner les couleurs qui apparaîtront sur vos rapports au format PDF
+**Éléments graphiques des rapports PDF :**
-  * Image pour en tête du rapport
+  * Image pour l'en-tête du rapport (880 px de large, jusqu'à 150 px de haut)
-  * Image pour en-tête des pages intermédiaires si plusieurs page
+  * Image pour l'en-tête des pages suivantes, si le rapport compte plusieurs pages (880 px de large, jusqu'à 150 px de haut). En l'absence d'image, l'image de première en-tête est utilisée.
-  * Image pour pied de page
+  * Image pour le pied de page (880 px de large, jusqu'à 100 px de haut)
-  * Décalage vertical absolu : offset vertical de début du document pour la génération PDF (70 mm par défaut)
+  * **Décalage vertical absolu** : position verticale de début du contenu du document PDF, en mm (70 par défaut, dépend de la taille de l'en-tête)
-  * Hauteur de page PDF : Hauteur à laquelle le saut de page est généré (225 mm par defaut, dépend de la taille du pied de page .
+  * **Hauteur de page PDF** : hauteur à laquelle le saut de page est généré, en mm (225 par défaut, dépend de la taille du pied de page)
 {{ :report:trainingsessions:techniques:rapport-06.jpg?nolink |}}
 ====Couplage====
-**Couplage LTC :** Si vous activez cette option, ce sont les temps du contrat pédagogique indiqués sur les activités et ressources dans le composant Avancement et temps pédagogiques (LTC) qui s'afficheront sur les rapports, au bénéfice de l'usager :
+**Couplage LTC (PRO) :** si vous activez cette option, ce sont les temps du contrat pédagogique indiqués sur les activités et ressources dans le composant [[:mod:learningtimecheck|Avancement et temps pédagogiques (LTC)]] qui s'afficheront sur les rapports, au bénéfice de l'usager :
-  * le temps du LTC si le temps passé par l'usager est moins long que le temps marqué via le LTC
+  * le temps du LTC si le temps passé par l'usager est moins long que le temps marqué via le LTC ;
-  * le temps mésuré par la session si le temps passé par l'usager est plus long que le temps marqué via le LTC
+  * le temps mesuré par la session si le temps passé par l'usager est plus long que le temps marqué via le LTC.
-====Fonctions additionnelles Excel====
+Le réglage //Écrêtage des temps de session// précise ce que devient le temps mesuré lorsqu'il dépasse celui du LTC : avec //Marquer//, la valeur mesurée est conservée et signalée ; avec //Écrêter//, elle est limitée au temps du LTC.
-Affiche par defaut dans les rapports au format excel :
+====Fonctions additionnelles Excel (PRO)====
-  * Formule XLS de Moyenne : la moyenne
+Ces deux formules sont ajoutées par défaut à la fin des rapports au format Excel :
-  * Formule XLS de Sommation : la somme
+  * **Formule XLS de moyenne** (par défaut ''=AVERAGE({col}{minrow}:{col}{maxrow})'')
+  * **Formule XLS de sommation** (par défaut ''=SUM({col}{minrow}:{col}{maxrow})'')
+Les marqueurs ''{col}'', ''{minrow}'' et ''{maxrow}'' sont remplacés par la colonne et les lignes de début et de fin de la plage calculée. Les noms de fonctions sont ceux d'Excel en anglais (''AVERAGE'', ''SUM'').
 ====Fonctions spéciales de rapport multicours (PRO)====
@@ Ligne 99: / Ligne 91: @@
 Cette zone de texte permet de décrire des ensembles de cours pour lesquels un rapport agrégé (rapport de Programme pédagogique) sera disponible, à partir de chaque rapport des cours qui le composent.
-Un "groupe de cours" ou "Programme pédagogique" est décrit dans une ligne, par les ids Moodle des cours qui le composent. Un seul programme par ligne.
+Un "groupe de cours" ou "Programme pédagogique" est décrit dans une ligne, par les ids Moodle des cours qui le composent, séparés par des virgules (exemple : ''12,15,18''). Un seul programme par ligne. L'ordre des ids est l'ordre d'affichage des cours dans le rapport.
-Un cours ne pourra appartenir qu'à un seul programme. S'il apparaît dans plusieurs lignes, le premier programme où il apparaît sera considéré, lorsque vous naviguerez dans le rapport de sessions de ce cours.
+Un cours ne peut appartenir qu'à un seul programme. S'il apparaît dans plusieurs lignes, c'est le premier programme où il apparaît qui est retenu lorsque vous naviguez dans le rapport de sessions de ce cours. Les ids invalides, nuls ou en double sont ignorés.
-====Exemple de sortie PDF de rapport ====
+Dans un rapport multicours, les dates d'inscription sont agrégées : la première date d'inscription et la dernière date de clôture.
+====Extensions (rapports dédiés)====
+Les sous-plugins de type //Rapports dédiés// (''tscustom'') disposent de leur propre catégorie de réglages, sous celle du composant.
+====Exemple de sortie PDF de rapport====
 {{ :report:trainingsessions:techniques:rapport-pdf.jpg?nolink&500 |}}
@@ Ligne 113: / Ligne 111: @@
   * [[:blocks:usestats:technique|Aller au block UseStats pour voir les options de configuration des rapports]]
@@ Ligne 120: / Ligne 118: @@
 [[report:trainingsessions:technique|Retour guide technique du composant]]  - [[:report:trainingsessions|Index général du composant]] - [[:Plugins|Revenir à l'index des plugins]] - [[:start|Revenir au catalogue]]
 <html><!-- /nomoodle --></html>