13 KiB
Suivi de l'assiduité
Ce module de ScoDoc remplace l'ancien module de suivi des absences de Scodoc. Il propose des fonctions plus étendues: absences, retards, justificatifs (et gestion des documents associés) avec une granularité fine, des outils de reporting et une API complète permettant d'interfacer des modules tiers.
Ce projet a été développé de 2022 à 2024, par Matthias Hartmann, apprenti de l'IUT de Lannion financé par l'Association ScoDoc.
Ce module est disponible à partir de ScoDoc version 9.6.
Vidéo de présentation du module d'assiduités
Fonctionnalités
Le module fournit:
- Gestion des absences/présences/retards
- Précision des saisies (périodes déterminées par une heure de début et une heure de fin au lieu de demi-journées)
- Gestion et sauvegarde de justificatifs (documents)
- Une API complète
- [EXPERIMENTAL] Raccordement à un emploi du temps (documentation)
Migration de l'ancien module
Afin de favoriser la transition de l'ancien module au nouveau, un script de migration a été développé: à l'installation de ScoDoc 9.6, les anciennes données d'absences et justificatifs sont traduites pour ce module.
Voir détails dans la documentation d'installation et sur la documentation des commandes de migration des absences.
Personnalisation du module
Le module possède deux types de configuration, une générale et une par département/semestre.
La configuration générale
Elle permet de configurer les horaires de saisie d'assiduités
!!! warning "Attention" La configuration bloque les saisies en dehors des horaires définis.
Route : /ScoDoc/config_assiduites
Début de la journée
: l'heure de début des cours (par défaut : 8h00)L'heure de midi
: l'heure pivot qui sépare la matinée de l'après-midi (par défaut : 13h00)Fin de la journée
: l'heure de fin des cours (par défaut : 18h00)Granularité
: La granularité de la saisie (par défaut : 15 min)
La configuration par département/semestre
Elle permet de configurer certaines actions liés à l'assiduité
Route : /ScoDoc/<Dept>/Scolarite/edit_preferences
Imposer la déclaration du module
: Forcer les utilisateurs de ScoDoc à renseigner le module à chaque saisie d'assiduités.Désactiver la saisie des présences
: Retire les boutons et les affichages liés aux présences.Jours non travaillés
: Défini les jours sur lesquels la saisie d'assiduités ne sera pas possible.Métrique de l'assiduité
: Défini l'unité de l'assiduité qui sera utilisé par les autres modules de ScoDoc.1/2 J.
: Demi-JournéeJ.
: JournéesH.
: Heures
Seuil d'alerte des absences
: Nombre d'absences limite avant alerte (utilisation de la métrique d'assiduité)
Gestion de l'assiduité
Saisir l'assiduité d'un groupe
Saisir par Jour
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/signal_assiduites_group?formsemestre_id=<formsemestre_id>&group_ids=<group_id,...>&day=<yyyy-mm-dd>
Page accessible depuis le tableau de bord d'un semestre (Saisir l'assiduité
).
Page accessible depuis le tableau de bord d'un module (Saisie Absences
).
Composition de la page
- Choix du/des groupe(s) et de la date
- Vous pouvez cliquer sur le calendrier pour changer plus facilement la date. Si la date n'est pas un jour travaillé la page sélectionnera automatiquement le prochain jour travaillé.
- Vous pouvez afficher plusieurs groupes en cliquant sur le nom du group affiché ( ici TP1(10) )
- Timeline / choix de la plage concernée (exemple : durée d'un cours)
- La zone bleu est un élément intéractif. Elle correspond à la plage concernée. Vous pouvez la déplacer en cliquant dessus puis en déplaçant la souris en gardant maintenu le clic. Vous pouvez également l'agrandir ou rétrécir en effectuant la même action mais depuis un des bords de la zone bleu. Le curseur changera pour vous indiquer que vous aller modifier la taille.
- Sinon vous pouvez directement changer les horaires à l'aide des sélecteurs à gauche de la timeline
- Vous pouvez aussi utiliser les boutons
Matin
etAprès-midi
pour placer rapidement la zone bleue.
- Choix du module (et affichage ou non des photos des étudiants)
- Vous pouvez changer de module en cliquant sur le sélecteur. Un message d'avertissement s'affichera si vous ne sélectionnez pas de module alors que la préférence
Imposer la déclaration du module
est active. - Vous pouvez afficher ou non les photos des étudiants en cochant la case
Afficher les photos
- Vous pouvez changer de module en cliquant sur le sélecteur. Un message d'avertissement s'affichera si vous ne sélectionnez pas de module alors que la préférence
- Lignes étudiants et saisie
Composition d'une ligne étudiante
- En premier il y a les informations de l'étudiant (nom, prenom, photo)
- ensuite il y a symbolisation des assiduités sur la journée.
- le petit carré affiche la dernière assiduité du jour précédent
- la ligne affiche l'assiduité de la journée. La taille des blocs est proportionnelle à la taille de l'assiduité saisie.
- La zone bleue correspond à la plage de saisie (Timeline)
- Enfin il y a les boutons de saisie. Dans l'ordre
- Présence
- Retard
- Absence
!!! warning "Attention" il est possible que la plage de saisie rentre en conflit avec la plage d'une assiduité. (Il est impossible d'avoir deux assiduités aux même moment. Cela produit donc un conflit.) Ce conflit est symbolisé par la mise en évidence de la ligne étudiante
![Conflit](screens/signal_assiduites_group-conflit.png)
Pour résoudre ce conflit il faudra effectuer au moins une de ces actions:
- Changer la plage de saisie
- Modifier l'assiduité qui rentre en conflit
- Supprimer l'assiduité qui rentre en conflit
- Ne pas saisir pour l'étudiant concerné
- Utiliser le résolveur de conflit (l’icône à droite de la ligne étudiante)
!!! info "Astuces" - Vous pouvez passer la souris sur les blocs d'assiduités / le petit carré pour avoir plus d'informations. - Vous pouvez cliquer sur un bloc pour changer la plage de saisie à la plage de l'assiduité. - Vous pouvez cliquer sur les ℹ️ pour ouvrir la page de modification d'une assiduité
Saisir par Semaine
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/signal_assiduites_hebdo?formsemestre_id=<formsemestre_id>&group_ids=<group_id,...>&week=<yyyy-Www : 2024-W25 >
Page accessible depuis le tableau de bord d'un semestre (Saisie hebdomadaire
).
Page accessible depuis le tableau de bord d'un module (Saisie Absences(Hebdo)
).
!!! warning "Attention" Les semaines sont restreintes au semestre en cours. Vous ne pourrez pas saisir en dehors du semestre.
Cliquer sur autre semaine
affichera un calendrier du semestre en cours. Vous pourrez ensuite choisir la semaine en cliquant sur le calendrier.
!!! info "Astuce" Vous pouvez changer les horaires en cliquant dessus. Par défaut ils correspondent à la configuration générale.
Saisir l'assiduité d'un étudiant
Ajouter une assiduité
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/ajout_assiduite_etud?etudid=<etudid>
Page accessible en cliquant sur Ajouter
dans la barre latérale.
!!! warning "Attention"
Les modules proposés sont lié au semestre courant. Si vous souhaitez saisir une assiduité pour un semestre passé, vous devez aller sur la page Bilan du semestre concerné puis cliquer sur signaler l'assiduité
dans la ligne de l'étudiant concerné.
Modifier / Voir une assiduité
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/edit_assiduite_etud/<assiduite_id>
Page accessible en cliquant sur ℹ️ dans les tableaux d'assiduités.
Ajouter un justificatif
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/ajout_justificatif_etud?etudid=<etudid>
Page accessible en cliquant sur Justifier
dans la barre latérale.
Un justificatif peut prendre un des états suivants :
- En attente de validation
- Non valide
- Modifié
- Valide
!!! warning "Attention"
Pour saisir les états Valide
, Modifié
, Non valide
il faut obligatoirement la permission JustifValidate
!!! warning "Attention"
Seul l'état Valide
permet de justifier une assiduité. Les autres états sont là pour faciliter le suivi du justificatif.
Il est possible d'importer des fichiers (exemple: une convocation au permis de conduire ) et de donner une description au justificatif.
!!! warning "Attention"
Les justificatifs pouvant contenir des informations sensibles, seuls ceux ayant la permission AbsJustifView
et celui qui a saisie l'information peuvent voir la description et les fichiers.
Modifier / Voir un justificatif
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/edit_justificatif_etud/<justif_id>
Page accessible en cliquant sur ℹ️ dans les tableaux de justificatifs.
!!! info "Astuce" Cliquer sur le nom d'un fichier permet de le télécharger
!!! warning "Attention"
Pour saisir les états Valide
, Modifié
, Non valide
il faut obligatoirement la permission JustifValidate
Voir l'assiduité d'un groupe
Bilan
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/visu_assi_group?date_debut=<yyyy-mm-dd>&date_fin=<yyyy-mm-dd>&group_ids=<group_id>
Page accessible depuis le tableau de bord d'un semestre.
La page est configurée par défaut pour afficher les comptes sur la durée du semestre. Mais il est possible de changer les dates puis de cliquer sur Changer
.
L'option Restreindre aux modules de ce semestre
permet de ne comptabiliser que les assiduités ayant un module spécifié.
(Le module Autre
ne sera pas comptabilisé)
Voir l'assiduité d'un étudiant
Liste/Bilan
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/bilan_etud?etudid=<etudid>
Page accessible en cliquant sur Liste/Bilan
dans la barre latérale.
Cette page permet :
- d'afficher les statistiques de l'assiduité d'un étudiant sur une période. (par défaut : l'année scolaire en cours)
- d'afficher la liste des assiduités et justificatifs enregistrés pour l'étudiant
- d'afficher si l'étudiant a trop d'absences (par rapport à la préférence
Seuil d'alerte des absences
)
Calendrier
Route : /ScoDoc/<DEPT>/Scolarite/Assiduites/calendrier_assi_etud?etudid=<etudid>
Page accessible en cliquant sur Calendrier
dans la barre latérale.
La page calendrier permet d'afficher un calendrier de l'année scolaire en cours et d'afficher l'assiduité de l'étudiant concerné. Il est possible de changer l'année en cours à l'aide du sélecteur en bas de page.
En haut de la page se trouve des éléments de configuration de l'affichage :
Afficher les présences
: permet d'afficher les présences (par défaut : Non)Afficher les retards
: permet d'afficher les retards (par défaut : Non)Mode demi-journée
: permet d'afficher l'assiduité par demi-journée (par défaut : Oui). Si non coché, l'assiduité sera montrée par journée
La zone avec les bordures oranges correspond à la semaine en cours.
!!! info "Astuces" Passer sa souris sur un jour affichera une bulle. Cette bulle montre les assiduités de la journée. Il est aussi possible de cliquer sur les assiduités de la bulle pour se rendre sur leur page d'édition.
!!! note "Voir aussi"
- [Migration des absences vers les assiduités](AssiduitesMigration.md)
- [API](ScoDoc9API.md) : API pour interfaçage avec d'autres applications
- [API et fichiers justificatifs](FichiersJustificatifs)
- [FAQ](FAQ.md)
- [Contacts](Contact.md)