PurgeAllPropertyHistory
Описание
При обновлении зарегистрированных свойств их данные записываются в поток значений, связанный с вещью. Можно использовать сервис PurgeAllPropertyHistory для очистки исторических данных из всех зарегистрированных свойств вещи за указанный диапазон времени.
История свойств вещи, в которой вызывается сервис, будет очищена. Если требуется очистить данные для нескольких вещей, необходимо вызвать сервис для каждой вещи.
Входные данные
|
Имя параметра
|
Описание
|
Базовый тип
|
|
startDate
|
Дата начала, включающая указанную дату, начиная с которой должны быть очищены исторические данные.
|
DATETIME
|
|
endDate
|
Дата окончания, включающая указанную дату, до которой должны быть очищены исторические данные.
|
DATETIME
|
Выходные данные
Нет.
Пример
В следующем примере у вещи имеются два зарегистрированных свойства, propertyA-Logged и propertyB-Logged, которые были изменены несколько раз. Исторические данные обоих свойств можно очистить совместно с помощью этого сервиса.
Входные параметры могут передаваться, как показано ниже:
// 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 */
});
Можно также создать таблицу данных:
// 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);