Description
Chaque compteur est constitué d'une collection de valeurs, chacune correspondant à une valeur unique d'un compteur de reporting. Pour les valeurs hebdomadaires d'un compteur de reporting, il est nécessaire d'utiliser un autre Web Service.
URI | <uri_compteurs>/valeurs |
---|---|
Catégorie | http://schemas.holydis.com/tsq/2010#valeur_compteur_personne |
Disponible en écriture |
Oui |
Eléments
Elément | Description | En écriture |
---|---|---|
title |
La mention "Valeur pour [prénom et nom de la personne concerné]". | |
dateImport | La date de l'import. | Par défaut, c'est la date du jour. |
dateValeur | La date de la valeur. | Obligatoire |
valeur | En écriture, la valeur (XXXXXYY) renseignée pour un compteur est entière. Elle est interprétée comme un nombre d'heures, un entier ou un réel selon la nature du compteur :
|
Obligatoire |
personne | La personne concernée. | Obligatoire |
Exemples de requêtes
Lecture
Lire la valeur du compteur dont l’identifiant en base est 31000
GET /[URI_de_base]/api/feed/compteurs/31000/valeurs
Lire la valeur du compteur dont l’identifiant en base est 31000 pour la personne dont l’identifiant en base est 16007
GET /[URI_de_base]/api/feed/compteurs/31000/valeurs/16007
Exemple de résultat XML de la requête
Exemple de résultat JSON de la requête
Ecriture
Ajouter une valeur pour le compteur dont l’identifiant en base est 32000
POST /[URI_de_base]/api/feed/compteurs/32000/valeurs
Exemple de résultat XML de la requête
Exemple de résultat JSON de la requête
Modifier la valeur du compteur dont l’identifiant en base est 32000 pour la personne dont l’identifiant en base est 16008
PUT /[URI_de_base]/api/feed/compteurs/32000/valeurs/16008
Supprimer la valeur du compteur dont l’identifiant en base est 32000 pour la personne dont l’identifiant en base est 16008
DELETE /[URI_de_base]/api/feed/compteurs/32000/valeurs/16008
Messages d'erreur fonctionnels
- Erreur 400 La personne [NOM PRENOM] dispose déja d'une valeur pour le compteur [COMPTEUR]
- Erreur 400 L'entry doit contenir une référence à une personne existante
- Erreur 400 La personne [NOM PRENOM] n'a pas de valeur pour le compteur [COMPTEUR]
- Erreur 400 Le compteur à alimenter doit être externe
- Erreur 400 La valeur [VALEUR] est incorrecte. Le compteur est de type "Heure" donc le nombre correspondant aux deux derniers chiffres de la valeur ne doit pas être supérieur ou égal à 60
- Erreur 400 Une valeur doit être saisie pour le compteur
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.