Bonnes pratiques

Fonctionnement des dates et heures


Format de date ISO-8601

IntentPlatform utilise des dates au format ISO-8601

Pour information :
Lorsqu'une date est postée au format : 2017-10-25T02:30:53Z →alors le Z signifie qu'il s'agit du fuseau horaire UTC
Comme indiqué dans la documentation spécialisée, il est aussi possible d'écrire la date sous la forme : 2017−10−25T02:30:53+01:00
→ ce qui implique un fuseau UTC + 1h00 (soit la France, à l'heure d'hiver)

Cela étant, puisque la grande majorité des utilisateurs IntentPlatform sont en France, nous avons mis en place un mécanisme permettant de lire un format du type 2017-10-25T02:30:53 comme étant une date basée sur le fuseau Central European Time : CET / Paris.

A propos de l'usage des champs date

Il y a 3 champs dates :
1) creationDate : date de réception du log d'intervention par IntentPlatform. Date générée par intentPlatform.
2) eventDate : date de l'occurence ou de description de l'événement métier (dans le cas d’une planification c’est la date à laquelle l'intervention est prévue).
3) logDate : date à laquelle l’événement métier a été enregistré sur l’application d’origine.

La logDate n'est pas la date d'envoi de la donnée sur intentPlatform

eventDate et logDate : planification d'une intervention

Le champ eventDate, vous permet d'indiquer la date et l'heure à laquelle vous prévoyez d'intervenir.
Le champ logDate, vous permet d'indiquer la date et l'heure à laquelle vous avez enregistré votre planification.

Donc par exemple, nous sommes le 19/11/2018 à 15h30, et vous planifiez une intervention le 22/11/2018 à 10h.
eventDate = 2018-11-22T10:00:00.000Z
logDate = 2018-11-19T15:30:00.000Z


Contacts liés à une intervention


Voir  Contact - Vcard  du chapitre API Assets.

1 élément de patrimoine par intervention


Un objet (intervention, quotation, reservation) ne peut concerner qu'un et unique élément asset.Si lors d'une intervention vous intervenez sur plusieurs équipements, il faudra créer un nouvel objet pour chaque équipement visité.