GetWOListByUpdated

Liste les identifiants des ordres de travail dont l’événement ou le champ de données portant un code donné a été enregistré au cours d’une période. Une intégration l’appelle à intervalles réguliers pour récupérer ce qui a changé dans TrakIT, par exemple chaque ordre de travail dont l’événement de sortie du parc a été enregistré depuis le dernier appel, puis lit chacun d’eux avec GetWO ou ne lit que les valeurs dont elle a besoin avec GetSeqData.

Comment se connecter et lire la réponse : Authentification, Réponses.

GET /api/v1/GetWOListByUpdated?Code=GATEOUT&FromDate=2026-10-27&ToDate=2026-10-27T23:59:59&WFID=12
Token: your-token

Paramètre	Obligatoire	Signification
Code	Oui	Le code d’un événement ou d’un champ de données, par exemple GATEOUT. Les majuscules n’ont pas d’importance. Show Codes dans l’onglet Events d’un ordre de travail affiche les codes.
FromDate	Oui	Le début de la période, en UTC : une date, yyyy-MM-dd, ou une date et une heure, yyyy-MM-ddTHH:mm:ss.
ToDate	Oui	La fin de la période, en UTC, sous la même forme. 365 jours au plus après FromDate.
WFID	Non	Seulement les ordres de travail de ce workflow : son identifiant, un nombre entier, tel qu’il figure dans la colonne ID de Définitions de workflows. La valeur par défaut, 0, correspond à tous les workflows.
JobType	Non	Seulement les ordres de travail dont le dossier a ce type de dossier, parmi d’autres : l’identifiant du type de dossier, un nombre entier. Le support TrakIT peut vous donner les identifiants. La valeur par défaut, 0, correspond à tous les types de dossier.

• Envoyez Code, FromDate et ToDate. Sans l’un d’eux, la requête n’atteint pas le point de terminaison, et TrakIT répond avec le statut HTTP 404 (voir Erreurs).
• Les deux bornes sont incluses. Une date sans heure correspond à minuit au début de ce jour : ToDate=2026-10-27 exclut donc ce qui a été enregistré plus tard le 27 octobre. Pour inclure toute cette journée, envoyez 2026-10-27T23:59:59 ou 2026-10-28.
• Écrivez l’heure avec le T, comme ci-dessus. TrakIT supprime les espaces des dates : 2026-10-27 23:59:59 est donc refusé. Voir Dates et heures.

Ce qui compte comme une modification

Un ordre de travail est listé lorsque la valeur de son événement ou de son champ de données portant ce code a été enregistrée pour la dernière fois au cours de la période : son heure Updated dans GetWO. Seul le dernier enregistrement compte : une valeur enregistrée pendant votre période puis de nouveau après n’est listée que dans la période ultérieure. Demandez des périodes consécutives, chacune commençant là où la précédente s’est terminée, et chaque ordre de travail dont la valeur est enregistrée est listé au moins une fois.

Les ordres de travail de tous les statuts sont listés, y compris ceux qui sont clôturés et annulés. Un ordre de travail dont le workflow n’a aucun événement ni champ de données portant ce code n’est jamais listé.

Règles

Règle	Info en cas d’échec
L’en-tête Token contient un jeton valide.	Token missing in header, Token invalid or expired, ou une autre réponse listée dans Jeton de connexion
L’utilisateur est un administrateur système avec un accès à l’API.	API User must be SysAdmin with API Access
Code n’est pas vide.	Code is required
FromDate n’est pas vide.	FromDate is required
ToDate n’est pas vide.	ToDate is required
FromDate est une date.	FromDate is not valid
ToDate est une date.	ToDate is not valid
ToDate n’est pas antérieure à FromDate.	ToDate must be later than FromDate
Les dates sont espacées de 365 jours au plus.	Days between FromDate and ToDate cannot exceed 365

Réponse

En cas de succès, RetInfo liste les identifiants des ordres de travail, par ordre croissant, chacun une seule fois, et RowsAffected en donne le nombre.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [48211, 48212, 48305],
  "RowsAffected": 3,
  "Scalar": null,
  "Identity": 0
}

Quand aucune valeur portant ce code n’a été enregistrée au cours de la période, la réponse a Code 0 et Info No data found.