Tâches planifiées

ESUP-Stage embarque un planificateur de tâches récurrentes (batchs), piloté depuis l’écran « Paramétrage global > Tâches planifiées ». Chaque tâche est décrite en base (table CronTask) : expression cron, activation et date de dernière exécution.

Liste des tâches

Tâche Rôle Cron par défaut Active par défaut

UpdateSignature

Récupère automatiquement les dates de signature auprès de la solution de signature électronique (Docaposte, ESUP-Signature…​) et met à jour les conventions.

0 0 * * * ?
(toutes les heures)

Non

SynchroniserRegimesInscriptionApogee

Synchronise les régimes d’inscription depuis Apogée.

0 0 2 * * ?
(tous les jours à 02h00)

Oui

ArchiverConventions

Archive les conventions dont le stage est terminé depuis plus de N années, ainsi que les structures dont toutes les conventions sont archivées (voir Archivage et purge).

0 30 2 1 1 ?
(1er janvier à 02h30)

Non

PurgerConventions

Supprime définitivement les conventions archivées depuis plus de M années et les structures archivées non référencées (voir Archivage et purge).

0 30 3 1 1 ?
(1er janvier à 03h30)

Non

SupprimerContactsInutilises

Supprime les contacts qui ne sont plus référencés par aucune donnée (convention, avenant, offre, accord de partenariat, token d’évaluation).

0 0 4 1 * ?
(le 1er du mois à 04h00)

Non

SupprimerServicesInutilises

Supprime les services d’accueil sans contact et non référencés par une convention ou un avenant. À planifier après la suppression des contacts inutilisés.

0 30 4 1 * ?
(le 1er du mois à 04h30)

Non

Les tâches d'archivage, de purge et de suppression sont volontairement inactives par défaut : ces fonctionnalités sont optionnelles (et la purge comme les suppressions sont irréversibles). Leur activation doit être un choix conscient et volontaire de chaque établissement, après vérification de la configuration des délais et simulation lorsque c’est possible (voir Archivage et purge).

Fonctionnement

Expression cron

Les expressions utilisent le format cron de Spring à 6 champs : seconde minute heure jour-du-mois mois jour-de-semaine. Une expression invalide est signalée dans les logs et la tâche n’est pas planifiée, sans empêcher le démarrage de l’application ni la planification des autres tâches.

Activation / désactivation

L’activation d’une tâche et son expression cron se modifient depuis l’écran d’administration ; la planification est rechargée immédiatement, sans redémarrage.

Exécution manuelle

Chaque tâche peut être lancée immédiatement depuis l’écran. L’exécution est asynchrone : la main est rendue tout de suite et l’écran indique que la tâche est en cours.

Verrouillage

Une même tâche ne peut pas être exécutée deux fois en parallèle : si une exécution (planifiée ou manuelle) est déjà en cours, un nouveau lancement est refusé (l’exécution planifiée est ignorée, le lancement manuel renvoie une erreur « tâche déjà en cours »).

Suivi

La date de dernière exécution est enregistrée à la fin de chaque traitement (y compris en cas d’erreur). Le détail des traitements est tracé dans les logs applicatifs.