Les modèles de rapport

Le principe

Un modèle de rapport décrit quoi éditer et sous quelle forme. Vous créez un modèle d'un type donné, puis vous l'associez à un export qui le génère sur un périmètre filtré (un apprenant, une session, un groupe…).

Les types de modèles

• CSV — export tabulaire : global, par résultat, par activité.
• PDF — bilans : global, résultats, activités, commentaires, ou PDF personnalisé (mise en page libre).
• RTF — documents bureautiques : certificat/attestation, fiche de compte, statistiques de connexion/temps, déclaration fiscale 2483.

Créer un modèle personnalisé (PDF)

1. Ouvrir la gestion des modèles

   dans l'analyse / le reporting.

2. Créer un modèle

   choisissez le type (ex. PDF personnalisé).

3. Composer

   ajoutez des pages et des zones/sections, insérez des variables, définissez un fond de page.

4. Associer un export

   reliez le modèle à un export qui appliquera un filtre (session, groupe, apprenant).

5. Générer

   l'export produit le document (PDF, CSV ou RTF).

Les variables

Dans un modèle PDF personnalisé, une variable est un jeton encadré d'arobases que la plateforme remplace au moment de générer le document : @m_user_name@ devient le nom de l'apprenant.

Le nom se lit en trois morceaux : @ + famille + _ + objet + _ + donnée + @.

Les objets disponibles sont user, group, session, site, course (parcours), sco (activité), question, competency et global.

Les plus utilisées

Apprenant — @m_user_name@, @m_user_firstName@, @m_user_login@, @m_user_email@, @m_user_service@, @m_user_firstConnexionDate@, @m_user_lastConnexionDate@, @m_user_connexionTime@, @m_user_formationTime@, @m_user_connexionNb@

Parcours — @m_course_name@, @m_course_nature@, @m_course_objectifs@, @m_course_typicalLearningTimeDuration@ (durée prévue), @m_course_completionRate@, et en suivi @t_course_score@, @t_course_state@, @t_course_time@, @t_course_firstConnexionDate@, @t_course_lastConnexionDate@

Session — @m_session_name@, @m_session_startDate@, @m_session_endDate@, @m_session_registerNbAPP@, @m_session_participationRate@, @m_session_completionRate@, @m_session_avgScore@, @m_session_nbLearnerPassed@ / Failed / Incomplete / NotAttempted

Attestations — @m_course_validationDate@ et @m_course_validationExpiry@ donnent la date de validation et son échéance (validation + 2 ans - 1 jour). @m_course_scoValidationDate3@ donne la date de validation d'une activité précise de la formation : remplacez 3 par son numéro, c'est-à-dire sa position dans la formation, chapitres compris (un tiret si l'activité n'est pas validée). Préférez-les à leurs équivalents @t_course_…@ dans une attestation : elles retrouvent le suivi toutes seules, là où la variante suivi peut ressortir vide selon le contexte.

La liste complète — 247 variables — est proposée dans l'éditeur, classée par objet : cliquez dans une zone puis dépliez le sélecteur de variables.

Les boucles

Pour répéter un bloc (une ligne par parcours, par apprenant, par activité), encadrez-le de deux marqueurs :

@loop_course_start@
   @m_course_name@ — @t_course_score@
@loop_course_end@

Les boucles existent sur site, session, course, sco, group, user, question et competency, et s'imbriquent : une boucle apprenant à l'intérieur d'une boucle parcours produit le tableau croisé des deux.

Les graphiques

Une zone peut être de type graphique plutôt que texte. Elle contient alors une seule variable, par exemple @lsp_cSession@ (répartition des statuts sur la session) ou @mmasb_cCourse@ (score min / moyen / max par parcours). Radars de compétences, courbes de progression et histogrammes sont également disponibles.

Ces graphiques sont dessinés en vectoriel dans le PDF : ils restent nets à n'importe quel zoom et à l'impression, et n'embarquent aucune image. Les répartitions sortent en anneau (donut), les compétences en radar, les séries mensuelles en barres, et les couleurs sont celles de la palette vérifiée de la plateforme — la même qu'à l'écran.

> Ce qui a changé. Jusqu'ici ces graphiques étaient des images produites par une bibliothèque de 2010 : texte pixellisé à l'impression, couleurs hors charte, et camemberts en fausse perspective — une part vue de biais paraît plus petite qu'elle n'est. Vos modèles existants n'ont rien à changer : les mêmes variables produisent désormais le rendu vectoriel.

Pourquoi pas Chart.js, utilisé ailleurs dans la plateforme ? Parce que le PDF est fabriqué par le serveur, où il n'y a pas de navigateur : Chart.js a besoin d'un moteur JavaScript pour dessiner. Le tracé vectoriel donne le même vocabulaire visuel — donuts, radars — avec une qualité d'impression que Chart.js, qui produit une image, ne pourrait pas atteindre.

Deux entrées ont disparu du sélecteur : « barre de répartition d'état » (elle donnait le même résultat que la répartition en anneau) et « courbe score/tentative » (sans équivalent vectoriel). Les modèles qui les utilisaient continuent de fonctionner.

Pour une répartition, les modèles fournis emploient plutôt une barre empilée construite en HTML : un tableau dont les cellules ont une largeur et une couleur. C'est la forme recommandée pour un part-à-tout, et elle s'insère dans une zone de texte, sans zone graphique.

Le principe, si vous voulez la reproduire : les variables …Percent (@m_session_nbLearnerPassedPercent@) rendent « 36% », qu'on injecte directement dans la largeur de la cellule — width:@m_session_nbLearnerPassedPercent@. La légende écrit toujours le libellé à côté de la pastille de couleur : une photocopie, une impression en noir et blanc ou un lecteur daltonien doivent rester servis.

Les modèles prêts à l'emploi

Ils sont déjà installés. Les treize gabarits fournis par DGT Concept arrivent avec la plateforme et apparaissent dans *Analyser → Modèles* après une mise à jour — il n'y a rien à importer.

> Si vous aviez déjà importé puis retouché l'un d'eux, votre version est conservée : la mise à jour ne remplace rien et ne crée pas de doublon. Elle n'installe que les modèles dont le nom est absent.

L'import manuel reste disponible pour vos propres modèles : un modèle personnalisé s'exporte en .zip et se réimporte sur une autre instance depuis *Modèles → Importer un modèle*.

Les treize gabarits :

Ces modèles sont verrouillés

Les sept modèles fournis portent une pastille « Verrouillé » dans la liste. Ils s'utilisent normalement, mais ils ne se modifient ni ne se suppriment : ni le crayon ni la corbeille n'apparaissent sur leur ligne.

Ce n'est pas une restriction de droits, c'est une protection du document. Un certificat de réalisation remis à un financeur ou un bilan adressé à un OPCO ne doit pas pouvoir être déformé par erreur, sans moyen de revenir à l'original.

Pour l'adapter à votre charte, dupliquez-le : le bouton de duplication reste disponible. La copie vous appartient, n'est pas verrouillée, et s'édite librement — l'original reste à côté comme référence. C'est aussi ce qui vous permet de comparer les deux si votre version cesse de produire ce que vous attendiez.

Un modèle verrouillé s'exporte en .zip comme un autre, et il reste verrouillé après réimport sur une autre instance : le verrou voyage avec le document.

Le rapport KPI et sa grille

Ce modèle n'affiche pas seulement des taux : il les juge, selon la grille d'évaluation DGT Concept. « 68 % » ne dit rien à un comité de pilotage ; « 68 % — Bon » dit quelque chose.

Deux barèmes sont conditionnels, et c'est ce qui fait leur justesse :

• la complétude se juge selon que le parcours est *tutoré* (case « Formation dirigée ») — l'accompagnement humain change tout : Faible < 20 % sans tutorat, mais < 50 % avec ;
• la participation se juge selon que la formation est *obligatoire* (case « Formation obligatoire ») — une formation réglementaire à 55 % est un échec, une formation facultative au même taux un succès.

Concrètement, dans le même rapport, une formation à 49 % peut être notée Bon et une autre à 51 % notée Moyen : ce n'est pas une erreur, ce sont deux barèmes différents.

Le pied de page rappelle systématiquement les barèmes appliqués — un indicateur qu'on ne peut pas contester n'est pas un indicateur.

L'engagement (temps passé rapporté au temps prévu) affiche « — » quand la durée prévue n'est pas renseignée sur le parcours : sans elle, le taux n'aurait aucun sens, et un zéro se lirait à tort comme un désengagement total.

Sur le certificat, les mentions de l'organisme (raison sociale, n° de déclaration d'activité, signataire) sont à compléter — elles apparaissent entre crochets.

Le rapport global, et sa limite

Ce document est le seul à embrasser toute la plateforme : une page de synthèse, puis une page par session. Sur la page de synthèse, le nom de chaque session est un lien : cliquer dessus amène directement à son détail dans le même PDF.

Les espaces sans aucune session y figurent aussi, avec leurs compteurs à zéro. C'est voulu : un espace ouvert mais inutilisé ne se voit nulle part ailleurs. Son taux affiche « — » plutôt que 0 %, qui se lirait comme un échec alors qu'il n'y a simplement rien à mesurer.

> ⚠️ N'activez pas « un fichier par ensemble de pages » sur ce modèle. Chaque session partirait alors dans un PDF distinct, et les liens du sommaire ne mèneraient plus nulle part.

Trois documents qui demandent un mot d'explication

Formations les plus et les moins suivies. « Suivie » signifie réellement ouverte : une formation attribuée à trois cents personnes dont aucune ne l'a démarrée n'apparaît pas en tête de classement. C'est voulu, et c'est souvent l'information la plus utile du document. Une formation absente des deux tableaux n'a jamais été ouverte par un apprenant du périmètre.

Heures-stagiaires. Ce document couvre le volet pédagogique d'un bilan : effectifs, volumes horaires, nature des actions. Il ne couvre pas le volet financier — produits, charges, sous-traitance — et ne le peut pas : la plateforme ne détient aucune donnée comptable. Les heures relevées sont par ailleurs les heures réellement passées dans les contenus, pas les heures prévues au programme ; la durée prévue figure à côté pour que l'écart reste lisible.

Écarts de compétences par poste. La comparaison repose sur le référentiel des postes. Un apprenant sans poste rattaché n'a pas un écart nul : il n'a pas d'exigence à laquelle se comparer, et le document l'écrit ainsi plutôt que d'afficher un tableau vide qui se lirait « tout est couvert ».

Si vous en composez un vous-même

Deux contraintes du moteur, invisibles mais sans pardon :

• Une zone doit atteindre le bord droit de la page pour être rendue. La page est assemblée en lignes, et une ligne n'est versée que lorsqu'une zone atteint 200 mm depuis la gauche. Une zone plus étroite qui termine une ligne n'est jamais affichée — la page sort blanche, sans message d'erreur. Deux zones côte à côte fonctionnent, à condition que la seconde atteigne ce bord.
• Les marqueurs de boucle ne vont pas dans un tableau. L'éditeur les enveloppe dans un paragraphe, qu'un tableau ne peut pas contenir : le navigateur le remonte avant le tableau, les deux marqueurs se collent, et la boucle n'encadre plus rien. Pour un tableau répété, mettez l'en-tête dans un premier tableau, hors boucle, et la ligne de données dans un second tableau à l'intérieur de la boucle.

Les textes sont fournis en français dans toutes les langues : si vos apprenants consultent la plateforme dans une autre langue, traduisez les zones depuis l'éditeur en basculant la langue d'édition.

Gros volumes : les trois paliers

Un rapport « un document par apprenant » produit une page — parfois un fichier — par personne. Sur un filtre large, la génération se compte en centaines de pages et en minutes. Trois paliers protègent l'outil, réglables dans *Administration → Configuration* :

Le lien reçu par courriel est valable 7 jours par défaut (réglable). Passé ce délai le fichier est supprimé du serveur : il faut relancer la génération.

Trois précisions utiles :

• Le lien est personnel. Il faut être connecté, et connecté avec le compte qui a demandé le rapport. Un lien transféré ne donne accès à rien — un rapport contient des données nominatives d'apprenants.
• Une adresse électronique est nécessaire sur votre compte, sinon la mise en file est refusée avec un message : sans adresse, le rapport ne pourrait pas vous être remis.
• Les paliers ne s'appliquent qu'aux rapports par apprenant. Un export CSV de plusieurs milliers de lignes se produit en une seconde et n'est pas concerné.

> Côté serveur, la génération différée repose sur une tâche planifiée. Si les rapports restent indéfiniment « en cours de génération », c'est elle qu'il faut vérifier auprès de votre hébergeur.

Bon à savoir

• Les modèles peuvent porter des champs personnalisés dédiés.
• Un rapport peut être envoyé automatiquement par une automatisation (action « Envoyer un rapport »), par e-mail en pièce jointe/lien ou par dépôt sur un serveur.
• Pour un simple export de résultats sans mise en page, voir « Exporter les résultats en CSV ».