Web Services - Les demandes d'absence

View the English version.

Description

Chaque ressource est une demande d'absence effectuée par une personne sur une période. Il est uniquement possible d'écrire des demandes en cours.

URI	<uri_personne>/demandesAbsence
Catégorie	http://schemas.holydis.com/tsq/2010#demande_absence
Disponible en écriture	Oui

Eléments

Elément	Description	Ecriture
commentaireGest	Le commentaire du gestionnaire (en cas de circuit double).
commentaireResp	Le commentaire du responsable.
commentaireSalarie	Le commentaire du salarié.	X
dateCreation	La date de création de la demande.
dateModifGest	La date de modification de la demande par le gestionnaire (en cas de circuit double).
dateModifResp	La date de modification de la demande par le responsable.
etat	L'état de la demande (EN_ATTENTE, VALIDEE, REFUSEE).
gestionnaire	Le gestionnaire ayant modifié la demande (en cas de circuit double).
periode	La période de la demande d’absence.	X
plageHoraireAbsPartielle	La plage horaire de l’absence partielle.	X
responsable	Le responsable ayant modifié la demande.
typeAbsence	Le type de l’absence demandée.	X
timeZoneId	L’identifiant de fuseau horaire.	X
allJours	Indique si la demande nécessite de sélectionner tous les jours (indépendamment de la périodicité).	X
appliquePeriodicite	Indique si la demande est réalisée avec une périodicité (true) ou non (false).	X
joursAppliqués	Le jour concerné par la périodicité (LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE).	X

Exemples de requêtes

Lecture

Lire les demandes d'absence de la personne dont l’identifiant en base est 3050

GET /[URI_de_base]/api/feed/personnes/3050/demandesAbsence

Lire la demande d’absence complète en cours (le 11/01/2025) dont l’identifiant en base est 42003 pour la personne dont l’identifiant en base est 3050

GET /[URI_de_base]/api/feed/personnes/3050/demandesAbsence/42003

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d’absence complète acceptée (le 09/01/2025) dont l’identifiant en base est 42002 pour la personne dont l’identifiant en base est 3050

GET /[URI_de_base]/api/feed/personnes/3050/demandesAbsence/42002

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d’absence complète refusée (le 10/01/2025) dont l’identifiant en base est 42001 pour la personne dont l’identifiant en base est 3050

GET /[URI_de_base]/api/feed/personnes/3050/demandesAbsence/42001

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d’absence partielle (le 17/01/2025 de 09:00 à 12:00) en cours dont l’identifiant en base est 41003 pour la personne dont l’identifiant en base est 3048

GET /[URI_de_base]/api/feed/personnes/3048/demandesAbsence/41003

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d’absence complète (du 10/02/2025 au 12/02/2025) en cours dont l’identifiant en base est 41004 pour la personne dont l’identifiant en base est 3048

GET /[URI_de_base]/api/feed/personnes/3048/demandesAbsence/41004

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d’absence complète avec une périodicité (du 16/12/2024 au 05/01/2025, tous les mercredis) en cours dont l’identifiant en base est 41003 pour la personne dont l’identifiant en base est 3048

GET /[URI_de_base]/api/feed/personnes/3048/demandesAbsence/41003

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Ecriture

Ajouter une demande d’absence complète pour une journée (le 11/01/2025) (en cours) pour la personne dont l’identifiant en base est 3050

POST /[URI_de_base]/api/feed/personnes/3050/demandesAbsence

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d’absence partielle (le 17/01/2025 de 09:00 à 12:00) (en cours) pour la personne dont l’identifiant en base est 3050

POST /[URI_de_base]/api/feed/personnes/3050/demandesAbsence

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Ajouter une demande d’absence complète pour une période (du 10/02/2025 au 12/02/2025) (en cours) pour la personne dont l’identifiant en base est 3050

POST /[URI_de_base]/api/feed/personnes/3050/demandesAbsence

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d’absence complète avec une périodicité (du 16/12/2024 au 05/01/2025, tous les mercredis) (en cours) pour la personne dont l’identifiant en base est 3050

POST /[URI_de_base]/api/feed/personnes/3050/demandesAbsence

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Modifier la demande d’absence (en cours) dont l’identifiant est 42001 pour la personne dont l’identifiant en base est 3050

PUT /[URI_de_base]/api/feed/personnes/3050/demandesAbsence/42001

Supprimer la demande d’absence dont l’identifiant est 42001 pour la personne dont l’identifiant en base est 3050

DELETE /[URI_de_base]/api/feed/personnes/3050/demandesAbsence/42001

Messages d'erreur fonctionnels

• Erreur 400 La demande est seulement masquée car celle-ci n'a pas été masquée par le responsable (et le gestionnaire dans le cas d'une gestion double)
• Erreur 400 Le salarié [NOM PRENOM] ne peut pas supprimer cette demande d'absence
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande d'absence
• Erreur 400 La période n'est pas renseignée ou est invalide
• Erreur 400 Personne affectée à aucune structure sur la période demandée
• Erreur 400 Personne affectée à plusieurs structures sur la période demandée
• Erreur 400 La plage horaire renseignée est invalide
• Erreur 404 Introuvable : [COMPOSANT]