Web Services - Les plannings modifiables pour une liste de personnes

Voir la version française.

Description

Chaque ressource correspond aux plannings modifiables d’un ensemble de personnes saisies en paramètres ou d'une liste de personnes (fichier en entrée) pour une journée de 24 heures.

URI	<url_de_base>/api/feed/plannings_mod
Catégorie	http://schemas.holydis.com/tsq/2010#planning_mod_personnes
Disponible en écriture	Non

Paramètres spécifiques

Paramètre	Description
idsPersonnes	Filtre les plannings en fonction des identifiants en base de personnes spécifiés (n'est pas compatible avec les paramètres datetime-min et datetime-max).
datetime-min	Filtre les plannings disponibles après la date spécifiée ou le même jour (n'est pas compatible avec le paramètre idsPersonnes).
datetime-max	Filtre les plannings disponibles avant la date spécifiée ou le même jour (n'est pas compatible avec le paramètre idsPersonnes).
planningValid	Filtre les plannings à ceux qui sont validés (true) ou non validés (false).

Eléments

Elément	Description
periode	Période couverte par les plannings. Cette période de 24h indique l'horodatage de début et de fin. Elle indique également l'heure de changement de jour associée au calendrier auquel la personne est affectée pour la date du planning. Si la personne n'a pas d'affectation de calendrier pour cette date, c'est l'heure de changement de jour du calendrier par défaut de la structure à laquelle la personne est affectée. Toutes les périodes pour lesquelles il existe un planning sont dans le fuseau horaire du calendrier de la personne sur la période.
planningPersonne+	Plannings des personnes sur une journée donnée. Il peut y avoir de 1 à plusieurs plannings.

Exemples de requêtes

Lecture

Lire tous les plannings modifiables pour les deux personnes dont l'identifiant en base est 16004 et 11105 pour une date donnée (le 13/02/2023)

GET /[URI_de_base]/api/feed/plannings_mod/2023-02-13?idsPersonnes=16004,111005

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Lire tous les plannings modifiables validés pour les deux personnes dont l'identifiant en base est 16000 et 16007 pour une date donnée (le 23/06/2022)

GET /[URI_de_base]/api/feed/plannings_mod/2022-06-23?planningValid=true&idsPersonnes=16000,16007

Lire tous les plannings modifiables en cours pour les deux personnes dont l'identifiant en base est 16000 et 16007 pour une date donnée (le 23/06/2022)

GET /[URI_de_base]/api/feed/plannings_mod/2022-06-23?planningValid=false&idsPersonnes=16000,16007

Lire les plannings modifiables pour une liste de personnes (fichier en entrée) pour une période donnée (du 01/06/2022 au 30/06/2022)

GET /[URI_de_base]/api/feed/plannings_mod?datetime-min=2022-06-01&datetime-max=2022-06-30

Lire les plannings modifiables validés pour une liste de personnes (fichier en entrée) pour une période donnée (du 01/06/2022 au 30/06/2022)

GET /[URI_de_base]/api/feed/plannings_mod?datetime-min=2022-06-01&datetime-max=2022-06-30&planningValid=true

Lire les plannings modifiables non validés pour une liste de personnes (fichier en entrée) pour une période donnée (du 01/06/2022 au 30/06/2022)

GET /[URI_de_base]/api/feed/plannings_mod?datetime-min=2022-06-01&datetime-max=2022-06-30&planningValid=false