Clés dynamiques et configuration métier¶
Page de référence, plus technique que les autres pages "Flux" — utile pour construire ou déboguer un modèle de message. Voir Flux — Modèles de message pour le contexte d'usage.
Sujets métier (topics) disponibles¶
Un modèle est toujours rattaché à l'un de ces sujets :
| Sujet | Usage |
|---|---|
| Tepitech | Résultat d'un examen Tepitech |
| solo stumper / duo stumper | Résultat d'un examen machine (solo ou duo) |
| Rapport sur module | Bilan de fin de module |
| Roadblocks | Bilan à mi-parcours |
| -42 | Signalement d'un cas de triche |
| Evaluation de stage | Demande d'évaluation envoyée au tuteur de stage |
| Alerte Présence | Suivi de présence en salle |
| Alerte Projet | Suivi d'avancement de projet |
| Alerte Absence | Alerte absence |
| Alerte Comportement | Alerte comportement |
| Information générale | Tout autre message (utilisé notamment par les mails libres enregistrés comme modèle) |
Variables réservées (remplies automatiquement)¶
Une variable insérée dans un modèle sous la forme {{...}} est soit réservée (calculée par le système, ne doit jamais être demandée à la personne qui envoie la campagne), soit libre (un champ que la personne doit remplir elle-même à chaque envoi).
Préfixes réservés :
student.* → informations sur l'étudiant (prénom, nom, classe...)
recipient.* → informations sur le destinataire du mail (le parent)
promo.* → informations sur la promotion
campus.* → informations sur le campus
row.* → une valeur de la ligne du fichier importé correspondant à l'étudiant
file.* / files.* → une valeur issue d'un fichier chargé pour la campagne (ex. files.grades.grade)
computed.* → une valeur calculée par le système (ex. computed.projectResultSummary, un résumé de résultat déjà mis en forme)
Toute variable qui ne commence pas par un de ces préfixes est considérée comme une variable libre : elle devient un champ de formulaire à remplir au moment de composer la campagne.
Types de champ pour une variable libre¶
| Type | Affichage à la saisie |
|---|---|
text |
Texte court sur une ligne |
textarea |
Texte long sur plusieurs lignes |
wysiwyg |
Éditeur de texte riche (mise en forme) |
number |
Nombre |
date |
Sélecteur de date |
select |
Liste de choix prédéfinis |
Fichiers attendus par un modèle¶
Un modèle peut déclarer un ou plusieurs fichiers attendus (ex. un fichier de notes ET un fichier de présences pour la même campagne). Pour chaque fichier, le modèle définit :
- les colonnes attendues (et lesquelles sont obligatoires) ;
- quelle colonne contient l'identifiant (login) de l'étudiant, et éventuellement son email ;
- des règles de couleur : un seuil numérique sur une colonne (ex. une note) qui détermine si la ligne s'affiche dans une couleur ou une autre lors de l'aperçu du fichier, pour repérer rapidement les cas à risque.
Exemple concret sur le sujet Tepitech — seuil de réussite selon la classe de l'étudiant :
| Classe | Note de réussite |
|---|---|
| TEK1 / TEK1 PSO | ≥ 600 |
| TEK2 | ≥ 700 |
| TEK3 | ≥ 750 |
Bornes dépendant de la classe¶
Certains champs libres, à remplir lors de la composition d'une campagne, proposent des choix qui dépendent de la classe des étudiants ciblés (ex. numéro de session) :
| Sujet | Classe | Nombre de sessions proposées |
|---|---|---|
| Tepitech | TEK1 / TEK1 PSO | 6 |
| Tepitech | TEK2 / TEK3 | 4 |
| Stumper (solo) | — | 10 |
| Stumper (duo) | — | 7 |
Ces bornes s'affichent uniquement quand la campagne cible un groupe avec une classe précise ; en ciblage par sélection d'étudiants (classes potentiellement mixtes), le choix n'est pas restreint à l'écran mais reste vérifié à l'envoi.
Configuration structurelle (campus / promotions / classes)¶
- Cycles de promotion : Bachelor, MSc Pro, Coding Academy.
- Classes : TEK1, TEK1 PSO, TEK2, TEK3, PreMSc, MScPro1, MScPro2, Coding Academy.
- Une promotion est identifiée de façon unique par la combinaison campus + cycle + année de fin. Il n'y a pas de bascule automatique d'une année sur l'autre : chaque nouvelle promotion (et le rattachement des étudiants à leur classe courante) est créée et mise à jour manuellement, il n'existe aucune tâche planifiée dans l'outil.
Historique et maintenance des données¶
Le projet contient des scripts de maintenance (nettoyage de l'historique des mails, correction de données...). Ce sont des opérations manuelles, lancées à la main par l'équipe technique quand nécessaire — aucune n'est automatisée ou planifiée.