QueryImplementingThingsWithData

Composer での ThingWorx モデルの定義 > モデル化 > コードスニペット > QueryImplementingThingsWithData

説明

このサービスは、サービス実行対象の Thing Template または Thing Shape を実装している Thing をクエリーするときに使用できます。結果は、Thing Template または Thing Shape を実装している Thing と、クエリーが実行された Thing Template または Thing Shape の有効なプロパティ値が含まれているインフォテーブルです。

入力

パラメータ名	説明	ベースタイプ
maxItems	結果セットで返すアイテムの最大数。デフォルト値は 500 です。このパラメータは、その他すべてのフィルタが適用された後で適用されます。	NUMBER
tags	このエントリのソースに関連付けられているモデルタグ。	TAGS
nameMask	Thing Template または Thing Shape を実装しているエンティティの名前パターン。	STRING
query	データのフィルタに使用するクエリー基準。フィルタは、サービスの実行対象の Thing Template または Thing Shape の有効なプロパティに対してのみ記述できます。詳細については、クエリーサービス用クエリーパラメータを参照してください。	QUERY

出力

パラメータ名	説明	ベースタイプ
result	Thing Template または Thing Shape を実装している Thing のリストと、Thing Template または Thing Shape の有効なプロパティ値が含まれているインフォテーブルを返します。	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	SVal3-2
Thing4	Template4	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm2"}	Val4-1	Val4-2		Val4-4	SVal4-1	SVal3-2	SVal4-4

次の例は、サポートされているパラメータを使用した、実装している Thing とデータのクエリーを示しています。この API 呼び出しは、avatar、description、homeMashup、isSystemObject、name、tags、クエリーの実行対象の Thing Template で定義されているすべてのプロパティ、および入力パラメータと一致する Thing の直接の親テンプレートが含まれているインフォテーブルを返します。

次のクエリーでは、avatar、description、homeMashup、isSystemObject、name、tags、Prop1、Prop2、Prop4、ShapeProp1、ShapeProp2、ShapeProp4、および Thing の直接の親テンプレートがインフォテーブルに返されます。

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

次のクエリーでは、Thing の 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*\" }}"
    
});

QueryImplementingThingsWithDataV2

説明

入力

パラメータ名	説明	ベースタイプ
maxItems	結果セットで返すアイテムの最大数。デフォルト値は 500 です。このパラメータは、その他すべてのフィルタが適用された後で適用されます。	NUMBER
tags	このエントリのソースに関連付けられているモデルタグ。	TAGS
nameMask	Thing Template または Thing Shape を実装しているエンティティの名前パターン。	STRING
query	データのフィルタに使用するクエリー基準。フィルタは、サービスの実行対象の Thing Template または Thing Shape の有効なプロパティに対してのみ記述できます。詳細については、クエリーサービス用クエリーパラメータを参照してください。	QUERY

出力

パラメータ名	説明	ベースタイプ
result	Thing Template または Thing Shape を実装している Thing のリストと、Thing Template または Thing Shape の有効なプロパティ値が含まれているインフォテーブルを返します。	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	SVal3-2
Thing4	Template4	{vocabulary: "MT1", vocabularyTerm: "MT1-MTerm2"}	Val4-1	Val4-2		Val4-4	SVal4-1	SVal3-2	SVal4-4

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

次のクエリーでは、Thing の avatar、description、homeMashup、isSystemObject、name、tags、Prop1、および ShapeProp1 がインフォテーブルに返されます。

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

これは役に立ちましたか?