PurgeAllPropertyHistory
Description
Lorsque les propriétés journalisées sont mises à jour, leurs données sont écrites dans un flux de valeurs associé à l'objet. Vous pouvez utiliser le service PurgeAllPropertyHistory pour purger les données historiques de toutes les propriétés journalisées d'un objet pour une plage temporelle spécifiée.
L'historique des propriétés de l'objet sur lequel le service est appelé sera purgé. Si vous souhaitez purger les données de plusieurs objets, vous devez appeler le service sur chacun d'eux.
Entrées
|
Nom de paramètre
|
Description
|
Type de base
|
|
startDate
|
Date de début à partir de laquelle les données historiques doivent être purgées (la date spécifiée est incluse).
|
DATETIME
|
|
endDate
|
Date de fin jusqu'à laquelle les données historiques doivent être purgées (la date spécifiée est incluse).
|
DATETIME
|
Sortie
Aucun.
Exemple
Dans l'exemple suivant, l'objet possède deux propriétés journalisées, propertyA-Logged et propertyB-Logged, qui ont été mises à jour plusieurs fois. Les données historiques des deux propriétés peuvent être purgées ensemble à l'aide de ce service.
Les paramètres d'entrée peuvent être transmis en ligne comme indiqué ci-dessous :
// Purging historical data of all logged properties between the given start and end dates
Things["TestThing"].PurgeAllPropertyHistory({
startDate: '2024-05-12T16:58:28.000Z' /* DATETIME */,
endDate: Date.now() /* DATETIME */
});
Vous pouvez également construire une table d'informations :
// Params for purging historical data from the past year
var purgeAllPropertyHistoryParams = {
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now()
};
Things["TestThing"].PurgeAllPropertyHistory(purgeAllPropertyHistoryParams);