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