Web Services - La charge quotidienne d'une tâche

View the English version.

Description

Chaque tâche se compose d'un ensemble de charges quotidiennes.

URI	<uri_tache>/besoins
Catégorie	http://schemas.holydis.com/tsq/2010#besoin
Disponible en écriture	Oui

Paramètres spécifiques

Paramètre	Description
datetime-min	Filtre les valeurs de charge qui concernent des périodes après la date spécifiée ou le même jour.
datetime-max	Filtre les valeurs de charge qui concernent des périodes avant la date spécifiée ou le même jour.

Eléments

Elément	Description	En écriture
tranchesHoraires+	Les tranches horaires de la charge. Il peut y avoir d’une à plusieurs tranches horaires.	Obligatoire
dateCreation	La date de création de la charge.
jour	Le jour associé à la charge.	Obligatoire
modeSaisieCharge	Le mode de saisie de la charge.
etat	La provenance de la charge.Les valeurs peuvent être les suivantes : 0 : Saisie manuellement 1 : Importée 2 : Copiée 3 : Calculée 4 : Issue d'une programmation de modèle
timeZoneId	L’identifiant de fuseau horaire. Exemple : Europe/Paris. Pour lire les données en fonction du fuseau horaire de Europe/Lisbonne, il faut ajouter en en-tête de la requête le paramètre User-TimeZoneId avec comme valeur l’identifiant du fuseau de Lisbonne, en l’occurrence Europe/Lisbonne. En l’absence du paramètre en en-tête, les données sont renvoyées brutes (dans le fuseau horaire de la ressource).	L'écriture se fait toujours dans le fuseau horaire de la ressource.

Notes

La modification d'une charge quotidienne s'effectue sur les tranches horaires renseignées dans l'entry. La mise à jour d'une charge quotidienne peut donc être partielle.

Exemples de requêtes

Lecture

Lire tous les charges quotidiennes de la tâche dont l’identifiant en base est 11000

GET /[URI_de_base]/api/feed/taches/11000/besoins

Lire les charges quotidiennes de la tâche dont l’identifiant en base est 11000 sur une période donnée (du 20/06/2022 au 26/06/2022)

GET /[URI_de_base]/api/feed/taches/11000/besoins?datetime-min=2022-06-20&datetime-max=2022-06-26

Lire la charge quotidienne de la tâche dont l’identifiant en base est 11000 sur un jour donné (le 20/06/2022)

GET /[URI_de_base]/api/feed/taches/11000/besoins/2022-06-20

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Ecriture

Ajouter une charge quotidienne pour une tâche dont l’identifiant en base est 11000

POST /[URI_de_base]/api/feed/taches/11000/besoins

Exemple de résultat XML de la requête

Exemple de résultat JSON de la requête

Modifier la charge quotidienne pour une tâche dont l’identifiant en base est 11000 sur un jour donné (le 01/08/2022)

PUT /[URI_de_base]/api/feed/taches/11000/besoins/2022-08-01

Supprimer la charge quotidienne d’une tâche dont l’identifiant en base est 11000 sur un jour donné (le 01/08/2022)

DELETE /[URI_de_base]/api/feed/taches/11000/besoins/2022-08-01