API Gestion Calendrier gérer Calendrier

Version ACE : 1.3

Package : fr.ACE.metier.bc4j.commun.common

GestionCalendriergererCalendrier

Schémas d’entrée et de sortie :

OUT

Cette API permet de créer un calendrier et ses périodes.

Il existe plusieurs types de calendrier :

« JOURNALIER » pour créer toutes les périodes journalières de l’année,
« HEBDO » pour créer les périodes hebdomadaires de l’année,
« MENSUEL » pour créer les périodes mensuelles de l’année,
« FERIE » pour créer les jours fériés de l’année,
« MANUEL » pour créer des périodes correspondant à certains jours de l’année. Ce mode doit être combiné avec le marquage mensuel des jours.

API imbriquées : GestionCalendriercreerCalendrierFerie - GestionCalendriercreerPeriode -

Contraintes et limites de fonctionnement (hors périmètre)

RAS.

Paramétrage (PPE)

RAS.

Processus, contrôles et règles de gestion

ETAPE	DESCRIPTION DU PROCESSUS
1	Si le calendrier n’existe pas dans la table CAL, on le crée a partir du champ « codcal » fourni en entrée de l’API.
2	On supprime toutes les périodes existantes pour ce calendrier dans la table CAP
3	Suivant le type de calendrier à gérer, on crée les périodes dans CAP. « JOURNALIER » è création des périodes pour chaque jour de l’année. « HEBDO » è création des périodes pour chaque semaine de l’année. « MENSUEL » è création des périodes pour chaque mois de l’année. « FERIE » è création des périodes pour les jours fériés de l’année. « MANUEL » è création des périodes pour les jours définis dans le marquage mensuel passé en entrée de l’API. Le marquage mensuel est représenté par une liste composée de : Numéro de mois (1 à 12), Chaîne de ‘0’ et de ‘1’ pour chaque jour du mois . Le caractère ‘0’ représente un jour à ne pas créer dans le calendrier. A l’inverse, le ‘1’ représente une période journalière à créer. Ex : « 000010010000… » signifie que l’on veut créer les jours 5 et 8 du mois.

Erreurs possibles

CAUSE	EFFET
Pour le calendrier @, il existe au moins 1 période (@) avec ANNEE=0	Exception « CAP_ANNEE1 »
Pour le calendrier @, il existe au moins 1 période (@) avec l'année renseignée	Exception « CAP_ANNEE2 »
Il y a incohérence entre l'année de la période à créer et datdeb et/ou datfin.	Exception « CAP_ANNEE3 »