PurgeAllPropertyHistory
Descrizione
Quando le proprietà registrate vengono aggiornate, i relativi dati vengono scritti in uno stream di valori associato all'oggetto. È possibile utilizzare il servizio PurgeAllPropertyHistory per eliminare i dati cronologici da tutte le proprietà registrate di un oggetto per un intervallo di tempo specificato.
Viene eliminata la cronologia delle proprietà dell'oggetto per cui viene chiamato il servizio. Per eliminare i dati per più oggetti, è necessario chiamare il servizio per i singoli oggetti.
Input
|
Nome parametro
|
Descrizione
|
Tipo di base
|
|
startDate
|
Data d'inizio, da intendersi inclusa, del periodo di cui devono essere eliminati i dati cronologici.
|
DATETIME
|
|
endDate
|
Data di fine, da intendersi inclusa, del periodo di cui devono essere eliminati i dati cronologici.
|
DATETIME
|
Output
Nessuno
Esempio
Nell'esempio riportato di seguito l'oggetto presenta due proprietà registrate, propertyA-Logged e propertyB-Logged, che sono state aggiornate più volte. È possibile eliminare insieme i dati cronologici di entrambe le proprietà utilizzando questo servizio.
I parametri di input possono essere trasmessi direttamente, come illustrato di seguito.
// 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 */
});
In alternativa, è possibile creare un'infotable:
// 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);