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.

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

Paramètres spécifiques

Paramètre	Description
datetime-min	Filtre les demandes disponibles après la date spécifiée ou le même jour.
datetime-max	Filtre les demandes disponibles avant la date spécifiée ou le même jour.

Eléments

Elément	Description
commentaireGest	Le commentaire du gestionnaire (en cas de circuit double).
commentaireResp	Le commentaire du responsable.
commentaireSalarie	Le commentaire du salarié.
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.
plageHoraireAbsPartielle	La plage horaire de l’absence partielle.
responsable	Le responsable ayant modifié la demande.
typeAbsence	Le type de l’absence demandée.
timeZoneId	L’identifiant de fuseau horaire.
allJours	Indique si la demande est réalisée pour toute la période ou avec une périodicité.
appliquePeriodicite	La périodicité.
joursAppliqués	Les jours concernés par la périodicité.

Exemples de requêtes

Lecture

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

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

Lire la demande d’absence dont l’identifiant en base est 313006 pour la personne dont l’identifiant en base est 84001

GET /[URI_de_base]/api/feed/personnes/84001/demandesAbsence/313006

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Ecriture

Ajouter une demande d’absence pour la personne dont l’identifiant en base est 84001 -> L'état reste à en cours, même si je mets validée.

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

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée -> erreur 500

Modifier la demande d’absence dont l’identifiant est 314000 pour la personne dont l’identifiant en base est 313007 -> Je n'arrive pas à modifier une demande. Message Code Erreur 400 La demande d’absence ne peut pas être enregistrée. Vous avez déjà une demande d’absence acceptée ou en cours de traitement pour cette journée. Veuillez contacter votre responsable

PUT /[URI_de_base]/api/feed/personnes/84001/demandesAbsence/314000

Supprimer la demande d’absence dont l’identifiant est 314000 pour la personne dont l’identifiant en base est 313007

DELETE /[URI_de_base]/api/feed/personnes/84001/demandesAbsence/314000

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]