forked from ScoDoc/DocScoDoc
87 lines
3.2 KiB
Markdown
87 lines
3.2 KiB
Markdown
# Migration des absences de ScoDoc 9.5 vers les assiduités 9.6
|
||
|
||
Lors du passage de ScoDoc 9.5 à 9.6, les anciennes données d'absences et
|
||
justificatifs sont traduites pour [le module assiduités](Assiduites.md).
|
||
|
||
## Script de Migration
|
||
|
||
Le script se nomme `migrate-abs-to-assiduites` et ne peut se lancer qu'en ligne
|
||
de commande:
|
||
|
||
```bash
|
||
su scodoc # au besoin
|
||
cd /opt/scodoc
|
||
source venv/bin/activate
|
||
|
||
flask migrate-abs-to-assiduites --help
|
||
```
|
||
|
||
Par défaut, la migration s'opérera sur l'ensemble des départements en utilisant
|
||
les préférences de ScoDoc.
|
||
|
||
Néanmoins le script possède 4 options pour modifier son comportement :
|
||
|
||
- `-d, --dept`
|
||
Permet de restreindre la migration à un département à l'aide de son acronyme.
|
||
Utilisation : `flask migrate-abs-to-assiduites -d <ACRONYME>`
|
||
- `-m, --morning`
|
||
Permet de définir l'heure de début des cours.
|
||
Utilisation : `flask migrate-abs-to-assiduites -m <hh:mm>`
|
||
exemple : `hh:mm` -> `08:30`
|
||
- `-n, --noon`
|
||
Permet de définir l'heure de fin du matin (= l'heure de début de l'après-midi).
|
||
Utilisation : `flask migrate-abs-to-assiduites -n <hh:mm>`
|
||
exemple : `hh:mm` -> `13:30`
|
||
- `-e, --evening`
|
||
Permet de définir l'heure de fin des cours.
|
||
Utilisation : `flask migrate-abs-to-assiduites -e <hh:mm>`
|
||
exemple : `hh:mm` -> `18:30`
|
||
|
||
Les options peuvent s’enchaîner : `flask migrate-abs-to-assiduites -d TEST -m 10:30 -n 14:50 -e 19:45`
|
||
|
||
Lors du lancement du script, une barre de progression apparaîtra. Celle si vous
|
||
indique l'avancée de la transformation des absences en assiduités.
|
||
|
||
Une fois arrivée à 100%, Un processus de validation et de justification des
|
||
assiduités se lancera. Celui-ci peut (suivant les configurations) prendre un
|
||
certain temps. Veuillez ne pas le stopper en cours de route.
|
||
|
||
Lorsque la migration sera finie, un fichier log de la migration sera généré pour
|
||
chaque département. Vous recevrez aussi des statistiques sur le nombre de
|
||
justificatif et d'assiduités générés.
|
||
|
||
## Script de Suppression
|
||
|
||
En cas de problème, ou si vous souhaitez purger la base de donnée, un script de
|
||
suppression des assiduités et des justificatifs est disponible.
|
||
|
||
Le script se nomme `downgrade-assiduites-module`.
|
||
|
||
Si vous lancer le script sans aucune option, il ne se passera rien.
|
||
|
||
Voici les options :
|
||
|
||
- `-d, --dept`
|
||
Permet de restreindre la suppression à un département à l'aide de son acronyme.
|
||
Utilisation : `flask downgrade-assiduites-module -d <ACRONYME>`
|
||
- `-a, --assiduites`
|
||
Provoque la suppression de toutes les assiduités
|
||
Utilisation : `flask downgrade-assiduites-module -a`
|
||
- `-j, --justificatifs`
|
||
Provoque la suppression de tous les justificatifs
|
||
Utilisation : `flask downgrade-assiduites-module -j`
|
||
|
||
Quelques exemples :
|
||
|
||
- Pour tout supprimer : `flask downgrade-assiduites-module -a -j`
|
||
- Pour supprimer un département : `flask downgrade-assiduites-module -d DEPT -a -j`
|
||
- Pour supprimer l'assiduité d'un département : `flask downgrade-assiduites-module -d DEPT -a`
|
||
- Pour supprimer les justificatifs d'un département : `flask downgrade-assiduites-module -d DEPT -j`
|
||
|
||
!!! note "Voir aussi"
|
||
|
||
- [Le module assiduités](Assiduites.md)
|
||
- [Mise à jour vers ScoDoc 9.6 / Debian 12](UpgradeToDeb12Sco96.md)
|
||
- [FAQ](FAQ.md)
|
||
- [Contacts](Contact.md)
|