PurgeAllPropertyHistory
Descripción
Cuando se actualizan las propiedades registradas, sus datos se escriben en un flujo de valor que está asociado a la cosa. El servicio PurgeAllPropertyHistory se puede utilizar para depurar los datos históricos de todas las propiedades registradas de una cosa para un rango de tiempo especificado.
Se depurará el historial de propiedades de la cosa en la que se llama al servicio. Si desea depurar los datos de varias cosas, se debe llamar al servicio de cada cosa.
Entradas
|
Nombre del parámetro
|
Descripción
|
Tipo base
|
|
startDate
|
La fecha de inicio, incluida la fecha especificada, a partir de la cual deben depurarse los datos históricos.
|
DATETIME
|
|
endDate
|
La fecha de fin, incluida la fecha especificada, hasta la cual deben depurarse los datos históricos.
|
DATETIME
|
Salida
Ninguno.
Ejemplo
En el siguiente ejemplo, la cosa tiene dos propiedades registradas, propertyA-Logged y propertyB-Logged, que se han actualizado múltiples veces. Los datos históricos de ambas propiedades se pueden depurar conjuntamente con este servicio.
Los parámetros de entrada se pueden pasar en línea, como se muestra a continuación:
// 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 */
});
O bien, se puede crear una 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);