Доступ к данным потоков значений с помощью сервисов
Через вещь или шаблон вещи можно получить доступ к следующим сервисам потоков значений. Доступ к данным должен осуществляться через вещь, которая использует поток значений.
Записи потоков значений можно загружать различными способами, используя предоставляемые сервисы. Например, для загрузки записей можно использовать определенное зарегистрированное свойство (QueryBooleanPropertyHistory, QueryDateTimePropertyHistory), набор зарегистрированных свойств (QueryNamedPropertyHistory) или все зарегистрированные свойства (QueryPropertyHistory).
В случае загрузки нескольких свойств ThingWorx выполняет особый алгоритм, чтобы обеспечить возврат полной таблицы, которая синхронизирована без значений null. Например, если одно свойство регистрируется чаще другого, ThingWorx заполняет пробелы при одновременной загрузке обоих свойств.
Данные потоков значений не удаляются за исключением тех случаев, когда данные явным образом очищаются создавшей их вещью или удаляется соответствующий поток значений. В случае удаления исходной вещи или свойства данные сохраняются.
 |
При переключении поставщика хранилища данных потока значений (например, с ThingworxPersistenceProvider на PostgreSQL или InfluxDB) любая вещь, реализующая поток значений, должна вызывать сервис RestartThing для загрузки записей, записанных в новом поставщике хранилища данных. Если вещи не перезапускались, записи могут быть записаны в базу данных, однако они не будут загружены до перезапуска вещи.
|
Сервисы потоков значений
|
Сервис
|
Описание
|
|---|---|
|
AddBooleanValueStreamEntry
|
Добавляет значение логического свойства в поток значений для вещи.
|
|
AddDateTimeValueStreamEntry
|
Добавляет значение свойства даты и времени в поток значений для вещи.
|
|
AddImageValueStreamEntry
|
Добавляет значение свойства изображения в поток значений для вещи.
|
|
AddInfoTableValueStreamEntry
|
Добавляет значение свойства таблицы данных в поток значений для вещи.
|
|
AddIntegerValueStreamEntry
|
Добавляет значение целочисленного свойства в поток значений для вещи.
|
|
AddLocationValueStreamEntry
|
Добавляет значение свойства расположения в поток значений для вещи.
|
|
AddLongValueStreamEntry
|
Добавляет значение свойства длинного целочисленного значения в поток значений для вещи.
|
|
AddNumberValueStreamEntry
|
Добавляет значение числового свойства в поток значений для вещи.
|
|
AddStringValueStreamEntry
|
Добавляет значение строкового свойства в поток значений для вещи.
|
|
AddThingCodeValueStreamEntry
|
Добавляет значение свойства кода вещи в поток значений для вещи.
|
|
AddVec2ValueStreamEntry
|
Добавляет значение свойства указанного vec2 (набор из двух чисел, например 2D-координаты x и y) в поток значений для вещи.
|
|
AddVec3ValueStreamEntry
|
Добавляет значение свойства указанного vec3 (набор из трех чисел, например 3D-координаты x, y и z) в поток значений для вещи.
|
|
AddVec4ValueStreamEntry
|
Добавляет значение свойства указанного vec4 (набор из четырех чисел, например 4D-координаты x, y, z и w) в поток значений для вещи.
|
|
GetLoggedProperties
|
Возвращает список свойств вещи, помеченных для регистрации потока значений.
|
|
GetNumericLoggedProperties
|
Возвращает список свойств для указанного числового базового типа.
|
|
GetPropertyLogging
|
QueryBooleanPropertyHistory
|
|
GetValueStream
|
Возвращает наименование потока значений, назначенного вещи.
|
|
PurgePropertyHistory
|
Удаляет все записи потока значений для свойства в указанном диапазоне дат.
|
|
QueryBooleanPropertyHistory
|
Запрашивает записи потока значений для значений указанного логического свойства в диапазоне дат для вещи.
|
|
QueryDateTimePropertyHistory
|
Запрашивает записи потока значений для значений указанного свойства даты и времени вещи.
|
|
QueryImagePropertyHistory
|
Запрашивает записи потока значений для значений указанного свойства изображения вещи.
|
|
QueryInfoTablePropertyHistory
|
Запрашивает записи потока значений для значений указанного свойства таблицы данных в диапазоне дат для вещи.
|
|
QueryIntegerPropertyHistory
|
Запрашивает записи потока значений для значений указанного целочисленного свойства вещи.
|
|
QueryLocationPropertyHistory
|
Запрашивает записи потока значений для значений указанного свойства расположения вещи в указанном диапазоне времени.
|
|
QueryLongPropertyHistory
|
Запрашивает записи потока значений для значений указанного длинного целочисленного свойства вещи.
|
|
QueryNamedPropertyHistory
|
Запрашивает записи потока значений для указанного значения зарегистрированного свойства вместе с критериями фильтрации и сортировки и нормализует набор данных для отображения результатов в заданном диапазоне времени.
|
|
QueryNumberPropertyHistory
|
Запрашивает поток значений для значений указанного числового свойства вещи в указанном диапазоне времени.
|
|
Запрашивает поток значений для значений зарегистрированных свойств вместе с критериями фильтрации и сортировки и нормализует набор данных для отображения результатов в заданном диапазоне времени.
|
|
|
QueryStringPropertyHistory
|
Запрашивает поток значений для значений указанного строкового свойства вещи в указанном диапазоне времени.
|
|
QueryThingCodePropertyHistory
|
Запрашивает записи потока значений для значений указанного кода вещи (числовое представление вещи, содержащей ИД домена и ИД экземпляра вещи).
|
|
QueryVec2PropertyHistory
|
Запрашивает записи потока значений для указанного vec2 (набор из двух чисел, например 2D-координаты x и y) для вещи.
|
|
QueryVec3PropertyHistory
|
Запрашивает записи потока значений для указанного vec3 (набор из трех чисел, например 3D-координаты x, y и z) для вещи.
|
|
QueryVec4PropertyHistory
|
Запрашивает записи потока значений для указанного vec4 (набор из четырех чисел, например 4D-координаты x, y, z и w) для вещи.
|
|
SetPropertyLogging
|
Включает или выключает регистрацию для указанного свойства.
|
|
SetValueStream
|
Задает поток значений для вещи.
|