Web Services - Les demandes d'aménagement de planning

View the English version.

Description

Chaque ressource est une demande d'aménagement de planning effectuée par une personne sur un jour. Il est uniquement possible d'écrire des demandes en cours, sauf dans le cas où la carte Chronotime Workplace est activée, dans ce cas la demande est automatiquement acceptée.

URI	<uri_personne>/demandesPlanning
Catégorie	http://schemas.holydis.com/tsq/2010#demande_planning
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 : VALIDEE, REFUSEE, EN_ATTENTE, ANNULEE_PAR_RESPONSABLE, ANNULEE_PAR_SALARIE, OBSOLETE
responsable	Le responsable ayant modifié la demande.
gestionnaire	Le gestionnaire ayant modifié la demande (en cas de circuit double).
coupure?	La présence d'une coupure (true) ou non (false).	X
heureDebutJournee	L'heure de début de journée. Il est possible de spécifier si c'est avant l'heure saisie, à l'heure exacte saisie ou après l'heure saisie.	X
heureFinJournee	L'heure de fin de journée. Il est possible de spécifier si c'est avant l'heure saisie, à l'heure exacte saisie ou après l'heure saisie.	X
heureDebutCoupure	L'heure de début de coupure.	X
heureFinCoupure	L'heure de fin de coupure.	X
dureeCoupureMin	La durée de coupure minimum.	X
dureeCoupureMax	La durée de coupure maximum.	X
codeExterne	Le code externe de la demande (si elle provient d'un outil tiers).	X
origine	L'origine de la demande si elle est externe.	X
teletravail	La réalisation de la journée en télétravail (true) ou sur site (false).	X
journeeIndispo?	L'indisponibilité sur une journée complète (true) ou sur une plage de la journée (false).	X
plageHoraireIndispo	La plage horaire d'indisponibilité si journeeIndispo est à false.	X
modeleHoraire	Le modèle horaire affecté.	X
tache	La tâche pour laquelle le salarié souhaite être volontaire.	X
timeZoneId	L’identifiant de fuseau horaire.	X
jour	Le jour de la demande lorsque la demande porte sur un seul jour.	X
periode	La période de la demande lorsque la demande porte sur une période de plus d'un jour.	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
periodiciteFrequence	La fréquence de la périodicité.	X
periodiciteId	Le type de périodicité (1 pour mensuelle, 2 pour hebdomadaire, 3 pour quotidienne).	X
joursAppliques	Le jour concerné par la périodicité (LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE).	X

Exemples de requêtes

Lecture

Lire les demandes d'aménagement de planning de la personne dont l’identifiant en base est 16002

GET /[URI_de_base]/api/feed/personnes/16002/demandesPlanning

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (un jour sans coupure) dont l’identifiant est 343000 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343000

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (un jour avec une coupure de 12:00 à 13:00) dont l’identifiant est 343001 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343001

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (un jour avec une durée de coupure minimum de 01:30 et une durée de coupure maximum de 02:00) dont l’identifiant est 365004 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/365004

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (un jour sur site) dont l’identifiant est 343002 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343002

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (un jour en télétravail) dont l’identifiant est 343003 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343003

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (commencer à 09:00) dont l’identifiant est 343004 pour la personne dont l’identifiant en base est 16002

GET /[URI_de_base]/api/feed/personnes/16002/demandesPlanning/343004

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (commencer avant 09:00) dont l’identifiant est 420002 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/420002

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (commencer après 09:00) dont l’identifiant est 420000 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/420000

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (finir à 17:00) dont l’identifiant est 343005 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343005

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (finir avant 17:00) dont l’identifiant est 420003 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/420003

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (finir après 17:00) dont l’identifiant est 420004 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/420004

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (indisponible sur une journée entière) dont l’identifiant est 343006 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343006

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (indisponible de 12:00 à 14:00) dont l’identifiant est 343007 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343007

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (modèle horaire quotidien sur une journée) dont l’identifiant est 363007 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/363007

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête 

Lire la demande d'aménagement de planning (modèle horaire hebdomadaire sur une période) dont l’identifiant est 365000 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/365000

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête 

Lire la demande d'aménagement de planning (volontaire sur une journée) dont l’identifiant est 366001 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/366001

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête 

Lire la demande d'aménagement de planning (volontaire sur une tâche) dont l’identifiant est 366004 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/366004

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête 

Lire la demande d'aménagement de planning (jour sans coupure sur une période) dont l’identifiant est 343011 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343011

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire la demande d'aménagement de planning (jour en télétravail sur une période avec une périodicité) dont l’identifiant est 343012 pour la personne dont l’identifiant en base est 16000

GET /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/343012

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Ecriture

Ajouter une demande d'aménagement de planning (commencer à 09:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (commencer avant 08:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (commencer après 08:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (finir à 17:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (finir avant 15:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (finir après 15:00 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (indisponible sur une journée entière avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (volontaire sur une journée entière avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (volontaire sur une tâche) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de résultat XML en entrée

Ajouter une demande d'aménagement de planning (un jour avec une durée de coupure minimum de 01:45 et une durée de coupure maximum de 02:30 avec un code externe) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Ajouter une demande d'aménagement de planning (indisponible sur une journée entière avec un code externe sur une période avec une périodicité) pour la personne dont l’identifiant en base est 16000

POST /[URI_de_base]/api/feed/personnes/16000/demandesPlanning

Exemple de fichier XML en entrée

Exemple de fichier JSON en entrée

Modifier la demande d'aménagement de planning dont l’identifiant est 122002 pour la personne dont l’identifiant en base est 16000

PUT /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/122002

Nouveauté Modifier la demande d'aménagement de planning dont l’identifiant externe est IDEXT01 pour que son état passe au statut Annulée par le salarié

POST /[URI_de_base]/api/feed/annulationDemandePlanning/IDEXT01

Supprimer la demande d'aménagement de planning dont l’identifiant est 122002 pour la personne dont l’identifiant en base est 16000

DELETE /[URI_de_base]/api/feed/personnes/16000/demandesPlanning/122002

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 de planning
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande de planning
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande sur le début de journée
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande sur la fin de journée
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande sur le début et la fin de coupure
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire une demande sur les indisponibilités
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire de demande sur les modéles horaires
• Erreur 400 Le salarié [NOM PRENOM] n'a pas le droit de faire de demande d'aménagement de travail sur site ou en télétravail
• Erreur 400 Injection de demande de planning impossible sur le jour [DATE] pour la personne [NOM PRENOM]. Le salarié est hors structure ce jour
• Erreur 400 Injection de demande de planning impossible sur le jour [DATE] pour la personne [NOM PRENOM]. Le salarié est hors contrat ce jour
• Erreur 400 Injection de demande de planning impossible sur le jour [DATE] pour la personne [NOM PRENOM]. Ce jour est férié fermé
• Erreur 400 Injection de demande de planning impossible sur le jour [DATE] pour la personne [NOM PRENOM]. Ce jour est fermé
• Erreur 400 Le modèle horaire [MODELE] ne peut être associé au salarié [NOM PRENOM]
• Erreur 400 Le modèle horaire [MODELE] doit avoir un calendrier identique à celui du salarié [NOM PRENOM]
• Erreur 400 Le modèle horaire [MODELE] doit être quotidien
• Erreur 400 Il faut définir un jour ou une période valide pour la demande
• Erreur 404 Introuvable : [COMPOSANT]