使用服务访问值流数据
可通过事物或事物模板使用下列值流服务。必须通过使用值流的事物来访问数据。
您可以使用提供的服务,以多种方式来检索值流条目。例如,您可以通过某个特定的已记录属性 (QueryBooleanPropertyHistory、QueryDateTimePropertyHistory)、一组已记录属性 (QueryNamedPropertyHistory) 或全部已记录属性 (QueryPropertyHistory) 来检索条目。
检索多个属性时,ThingWorx 将运行一种特殊的算法,以确保能够同步完整的表,且不返回空值。例如,如果某个属性比另一个属性记录得更为频繁,且同时检索到了这两个属性,则 ThingWorx 将填入空白中。
除非显式创建数据的事物清除了数据,或者值流被删除,否则值流数据不会删除。如果删除了原始事物或属性,数据将保持不变。
|
当切换某个值流的持久化方案提供工具 (例如,从 ThingworxPersistenceProvider 切换到 PostgreSQL 或 InfluxDB) 时,任何实现值流的事物都必须调用 RestartThing 服务以检索写入到新的持久化方案提供工具的条目。如果没有重新启动事物,则可以将条目写入数据库;但是,只有重新启动了事物后,才会检索到条目。
|
|
从 DSE 值流中筛选值流数据时,不包括结束日期。例如,查询条目并将结束日期设置为最后一个条目的准确时间戳时,则结果中不会包括最后一个条目。
|
值流服务
• GetLoggedProperties
返回标记用于值流日志记录的事物属性列表。
• GetNumericLoggedProperties
返回适用于指定数字基本类型的属性列表。
• GetPropertyLogging
确定是否正在记录属性。
• GetValueStream
返回分配给事物的值流名称。
• PurgePropertyHistory
删除指定日期范围内属性的全部值流条目。
• QueryBooleanPropertyHistory
查询事物的日期范围内指定布尔型属性值的值流条目。
• QueryDateTimePropertyHistory
查询事物的指定日期时间属性值的值流条目。
• QueryImagePropertyHistory
查询事物的指定图像属性值的值流条目。
• QueryInfoTablePropertyHistory
查询事物的日期范围内指定信息表属性值的值流条目。
• QueryIntegerPropertyHistory
查询事物的指定整数属性值的值流条目。
• QueryLocationPropertyHistory
查询指定时间范围内事物的指定位置属性值的值流条目。
• QueryNamedPropertyHistory
查询指定的已记录属性值的值流条目,以及筛选器和排序条件,并标准化数据集以显示给定时间范围内的结果。
• QueryNumberPropertyHistory
查询已记录属性值的值流,以及筛选器和排序条件,并标准化数据集以显示给定时间范围内的结果。
查询指定时间范围内事物的每个已记录属性值的值流。
• QueryStringPropertyHistory
查询指定时间范围内事物的指定字符串属性值的值流。
• SetPropertyLogging
打开或关闭指定属性的日志记录。
• SetValueStream
设置事物的值流。