Ouverture d'une période

Documentation technique GRH — suivi d’ouverture de période / exercice (verrou RHOUV*, reprise phase A/B, droit TM_EXO, journal des événements).

Voir aussi la doc utilisateur.

1. Objectif

Sécuriser l’ouverture de période et d’exercice : un seul poste à la fois, reprise après coupure sans rejouer inutilement les étapes déjà OK, traçabilité dans le journal des événements.

2. Fichiers / unités

Copie de travail sous sources_modifiees/ouverture_periode/ — ne pas éditer directement les sources EIG.

Unité	Rôle
Mensuel.Periode.I_OuvertureSuivi	Enums, constantes timeout, interface suivi
Mensuel.Periode.U_OuvertureSuivi	Verrou, étapes, heartbeat, reprise
Mensuel.Periode.F_Ouverture	Orchestration PER/EXE, UI busy, reprise écran
d_GRHmain	Garde connexion (EN_COURS / INTERROMPU), droit après init
Menu.Fr_GRHMainMenu	Ouverture forcée reprise, act_exercices / TM_EXO
U_GRHNotificationDB	Heartbeat Notif_USER (session visible)
ddl/RHOUVPERIODE.sql	Tables Firebird + générateur

3. Tables

RHOUVPERIODE

Champ	Rôle
OUVID	PK (générateur RH_GENID_OUVPERIODE)
OUVSTATUT	0 EN_COURS · 1 INTERROMPU · 2 TERMINE · 3 ABANDONNE
OUVPERIODE	Index AAAAMM période cible
OUVUSER / OUVATTACH	Utilisateur / ConnectionID verrou
OUVHB	Dernier heartbeat
OUVETAPE / OUVMESSAGE	Étape courante / message

RHOUVETAPE : une ligne par étape (ETAPCODE = TOuvEtape, statut A_FAIRE / EN_COURS / OK / KO / IGNORE).

4. Constantes d’activation / timing

Constante	Unité	Défaut	Rôle
C_USE_OUVERTURE_SUIVI	I_OuvertureSuivi	True	Active / coupe tout le suivi (verrou, étapes, heartbeat, reprise)
C_OUV_HB_TIMEOUT_SEC	I_OuvertureSuivi	90	Délai sans heartbeat avant INTERROMPU
C_OUV_HB_INTERVAL_SEC	I_OuvertureSuivi	15	Fréquence du heartbeat suivi
C_USE_NOTIF_USER_HEARTBEAT_THREAD	U_GRHNotificationDB	True	True = heartbeat USERCONNECT sur thread dédié ; False = WM_TIMER historique

5. Pipeline

Controles users → DemarrerSuivi (verrou) → alertes DSN / P99 / CanChange* → PreBascule → Bascule → PostOuverture → Terminer

* En reprise : alertes DSN / P99 / « forcer le changement » sautées.

• ExecuterPreBascule — CHG_HOR (mois), TAUX_PAS, DSN, ARCH_*
• ExecuterBascule — CLOSE_PER → BASCULE (trx) → DATE / INFO_ASSO / DEBLOC
• ExecuterPostOuverture — ARCH_HISTO (EXE) → APRES_OUV → message → Terminer

Le verrou est posé avant les dialogues DSN / CanChange. Abandon d’un contrôle → AbandonnerSuiviSiActif.

6. Verrou & heartbeat

• EN_COURS + heartbeat < 90 s → autre session refusée (« Réessayez plus tard »).
• Process tué → heartbeat expire → INTERROMPU au prochain démarrage.
• Fin OK → Terminer → TERMINE + arrêt heartbeat (déverrouillage immédiat).
• Abandon / contrôles KO après démarrage → ABANDONNE.

7. Reprise phase A / B

Phase	Critère	Comportement
A	Période ouverte ≠ cible	Étapes pré-bascule déjà OK conservées. Reset seulement EN_COURS/KO.
B	Période ouverte = cible	Étapes ≤ bascule → IGNORE. Post-bascule → A_FAIRE. Ne pas re-basculer.

AssureInfoAssoGRH : en reprise, CanChangePeriode est sauté → recréer _InfoAssoGRH avant SaveToDB.

8. Droits

Menu : act_exercices.Enabled := CanOpen('TM_EXO')
Init : InitOpenOf('TM_EXO', FonctionOK(110,100) and DroitSurToutesSection)

• Après doInitDroitsUsers : si reprise demandée et pas CanOpen('TM_EXO') → refus.
• CheckExerciceExist / écran : même garde.

9. UI pendant traitement

• SetUIOuvertureBusy — désactive boutons / navigation.
• _INTRT — bloque Escape / fermeture (CanClose := False).

10. Erreurs & arrêt

Cas	Comportement
Exception pendant ouverture / reprise	StopperOuvertureSurException → message, PasserInterrompu, journal, Application.Terminate
Contrôle métier KO	AbandonnerSuiviSiActif — pas d’arrêt appli
Refus droit TM_EXO	Exception / message — pas de traitement

11. Journal des événements

Traces via _GetBigBrother.AddEventGlobal (libellé UI : journal des événements). Source typique : F_SaisieExercices / D_GRHMain.