PurgeSelectedPropertyHistory
Descripción
Cuando se actualizan las propiedades registradas, sus datos se escriben en un flujo de valor que está asociado a la cosa. Se puede utilizar el servicio PurgeSelectedPropertyHistory para depurar los datos históricos de una lista especificada de 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 históricos de varias cosas, se debe llamar al servicio de cada cosa.
Esta depuración se ejecuta de forma síncrona.
Entrada
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 última fecha, incluida la fecha especificada, para la que se deben depurar los datos históricos.
DATETIME
propertiesToPurge
Nombres de las propiedades para las que se deben depurar los datos. Los nombres de las propiedades se transfieren a una infotable. La definición de datos esperada para la infotable es PropertyList.
INFOTABLE
Salida
Ninguno.
Ejemplo
En el siguiente ejemplo, TestThing tiene tres propiedades registradas: propertyA-Logged, propertyB-Logged y propertyC-Logged. Estas propiedades se han actualizado múltiples veces y han recopilado datos históricos. El siguiente fragmento se puede utilizar para depurar el historial de un subconjunto especificado de las propiedades registradas de la cosa:
// Creating an infotable using the required datashape for specifying the names of properties to purge
var propertiesToPurge = Resources["InfoTableFunctions"].CreateInfoTableFromDataShape( {
infoTableName : "InfoTable",
dataShapeName : "PropertyList"
});

// Adding the names of properties to the infotable created above
propertiesToPurge.AddRow({ propertyName: "propertyA-Logged" });
propertiesToPurge.AddRow({ propertyName: "propertyB-Logged" });
// Purging history
Things["TestThing"].PurgeSelectedPropertyHistory({
propertiesToPurge: propertiesToPurge, /* INFOTABLE */
startDate: 0, /* DATETIME */
endDate: dateAddYears((new Date()),1000) /* DATETIME */
});
¿Fue esto útil?