QueryImplementingThingsWithData

Composer 中的 ThingWorx 模型定義 > 建模 > 程式碼片段 > QueryImplementingThingsWithData

描述

您可以使用此服務來查詢實行對其執行服務之物範本或物形式的物件。結果是資料負載，其中包含實行物範本或物形式的物件，以及對其執行查詢之物範本或物形式的有效內容值。

輸入

參數名稱	描述	基礎類型
maxItems	要在結果集中傳回的最大項目數。預設值為 500。此參數會在套用其他所有篩選器之後套用。	NUMBER
tags	與此項目的來源相關聯的模型標籤。	TAGS
nameMask	實行物範本或物形式之實體的名稱模式。	STRING
query	用來篩選資料的查詢條件。只能為對其執行服務之物範本或物形式的有效內容編寫篩選器。如需詳細資訊，請參閱查詢服務的查詢參數。	QUERY

輸出

參數名稱	描述	基礎類型
result	傳回資料負載，其中包含實行物範本或物形式的物件清單，以及物範本或物形式的有效內容值。	INFOTABLE

範例

在下列範例中，TestStream 具有包含 Property1、Property2 與 Property3 欄位的資料形式。

實體	ShapeProp1	ShapeProp2	ShapeProp3
ThingShape1	已定義	NA	NA
ThingShape2	NA	NA	NA
ThingShape2	NA	NA	已定義

實體	父範本	Prop1	Prop2	Prop3	Prop4	已實行的形式	有效內容
Template1		已定義	NA	NA	NA	ThingShape1	Prop1, ShapeProp1
Template2	Template1	繼承自 Template1	已定義	NA	NA	ThingShape2	Prop1, Prop2, ShapeProp1, ShapeProp2
Template3	Template2	繼承自 Template2	繼承自 Template2	已定義	NA		Prop1, Prop2, Prop3, ShapePropy1, ShapeProp2
Template4	Template2	繼承自 Template2	繼承自 Template2	NA	已定義	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 呼叫會傳回資料負載，其中包含頭像、描述、homeMashup、isSystemObject、名稱、標籤、在對其執行查詢之物範本中定義的所有內容，以及符合輸入參數之物件的直接父範本。

在下列查詢中，資料負載中會傳回物件的頭像、描述、homeMashup、isSystemObject、名稱、標籤、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*\" }}"

});

在下列查詢中，資料負載中會傳回物件的頭像、描述、homeMashup、isSystemObject、名稱、標籤、ShapeProp1 與 Prop1。

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

});

這是否有幫助?