QueryImplementingThingsWithData

Composer 中的 ThingWorx 模型定义 > 建模 > 代码片段 > QueryImplementingThingsWithData

说明

使用此服务，可以查询实现作为服务运行基础的事物模板或事物形态的事物。结果为信息表，其中包含实现事物模板或事物形态的事物，以及运行查询所在的事物模板或事物形态的有效属性值。

输入

参数名称	说明	基本类型
maxItems	在结果集中返回的最大项数。默认值为 500。此参数仅在应用了所有其他筛选器后才会应用。	NUMBER
tags	与此条目的源关联的模型标记。	TAGS
nameMask	实现事物模板或事物形态的实体的名称模式。	STRING
query	用于筛选数据的查询条件。只能为作为服务运行基础的事物模板或事物形态的有效属性编写筛选器。有关详细信息，请参阅查询服务的查询参数。	QUERY

输出

参数名称	说明	基本类型
result	将返回一个信息表，其中包含实现事物模板或事物形态的事物列表，以及事物模板或事物形态的有效属性值。	INFOTABLE

示例

在以下示例中，TestStream 有一个包含 Property1、Property2 和 Property3 字段的数据形状。

实体	ShapeProp1	ShapeProp2	ShapeProp3
ThingShape1	已定义	不适用	不适用
ThingShape2	不适用	不适用	不适用
ThingShape2	不适用	不适用	已定义

实体	父模板	Prop1	Prop2	Prop3	Prop4	实现的形态	有效属性
Template1		已定义	不适用	不适用	不适用	ThingShape1	Prop1、ShapeProp1
Template2	Template1	继承自 Template1	已定义	不适用	不适用	ThingShape2	Prop1 Prop2 ShapeProp1 ShapeProp2
Template3	Template2	继承自 Template2	继承自 Template2	已定义	不适用		Prop1 Prop2 Prop3 ShapePropy1 ShapeProp2
Template4	Template2	继承自 Template2	继承自 Template2	不适用	已定义	ThingShape4	Prop1 Prop2 Prop4 ShapeProp1 ShapeProp2 ShapeProp4

实体	实现	模型标记	Prop1	Prop2	Prop3	Prop4	ShapeProp1	ShapeProp2	ShapeProp4
Thing1	Template1	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}	Val1-1				SVal1-1
Thing2	Template2	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}	Val2-1	Val2-2			SVal2-1	SVal2-2
Thing3	Template3	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm1"}	Val3-1	Val3-2	Val3-3		SVal3-1	SVa3l-2
Thing4	Template4	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm2"}	Val4-1	Val4-2		Val4-4	SVal4-1	SVal3-2	SVal4-4

以下示例使用受支持的参数查询带有数据的实现事物。此 API 调用会返回一个信息表，其中包含 avatar、description、homeMashup、isSystemObject、name、tags，在查询运行所在事物模板中定义的所有属性，以及与输入参数匹配的事物的直接父模板。

在以下查询中，信息表中会返回事物的 avatar、description、homeMashup、isSystemObject、name、tags、Prop1、Prop2、Prop4、ShapeProp1、ShapeProp2、ShapeProp4 以及直接父模板。

result = ThingTemplates["Template4"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"Prop1\", \"value\": \"Val2*\" }}"

});

在以下查询中，信息表中会返回事物的 avatar、description、homeMashup、isSystemObject、name、tags、Prop1 和 ShapeProp1。

result = ThingShapes["ThingShape1"].QueryImplementingThingsWithData({
maxItems: 50 /* NUMBER {"defaultValue":500} */,
nameMask: "T*" /* STRING */,
tags: "MT1:MT1-MTerm1",
query: "{\"filters\":{\"type\": \"LIKE\", \"fieldName\": \"ShapeProp1\", \"value\": \"SVal*\" }}"

});

这对您有帮助吗?