Определение модели ThingWorx в Composer > Моделирование > Фрагменты кода > PurgePropertyHistory
PurgePropertyHistory
Описание
При обновлении зарегистрированного свойства данные записываются в поток значений, связанный с вещью. Можно использовать сервис PurgePropertyHistory для очистки исторических данных из одного зарегистрированного свойства для указанного диапазона времени.
История свойств вещи, в которой вызывается сервис, будет очищена, но история свойств других вещей очищена не будет. Если требуется очистить историю для нескольких вещей, необходимо вызвать сервис для каждой вещи.
По умолчанию эта очистка выполняется асинхронно.
Входные данные
Имя параметра
Описание
Базовый тип
propertyName
Имя свойства, для которого должны быть очищены исторические данные.
STRING
startDate
Дата начала, включающая указанную дату, начиная с которой должны быть очищены исторические данные.
DATETIME
endDate
Дата окончания, включающая указанную дату, до которой должны быть очищены исторические данные.
DATETIME
immediate
Если задано значение false, очистка выполняется асинхронно. Значение по умолчанию: false. Если задать значение true, очистка выполняется синхронно.
BOOLEAN
Выходные данные
Нет.
Пример
В следующем примере для вещи существует зарегистрированное свойство с именем propertyA-Logged, которое несколько раз обновлялось и собирало исторические данные.
Входные параметры могут передаваться, как показано ниже:
// Purging historical data between the given start and end dates
Things["TestThing"].PurgePropertyHistory({
propertyName: 'propertyA-Logged' /* STRING */,
startDate: '2024-05-12T16:58:28.000Z' /* DATETIME */,
endDate: 'Date.now()' /* DATETIME */,
immediate: true /* BOOLEAN {"defaultValue":false} */
});
Можно также создать таблицу данных.
// Params for purging historical data from the past year
var purgeHistoryParams = {
propertyName: 'propertyA-Logged' /* STRING */,
startDate: new Date(new Date().setFullYear(new Date().getFullYear() - 1)),
endDate: Date.now(),
immediate: true /* BOOLEAN */
};
Things["TestThing"].PurgePropertyHistory(purgeHistoryParams);
Было ли это полезно?