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 には Property1Property2、および Property3 フィールドから成るデータシェイプがあります。
エンティティ
ShapeProp1
ShapeProp2
ShapeProp3
ThingShape1
定義済み
該当なし
該当なし
ThingShape2
該当なし
該当なし
該当なし
ThingShape2
該当なし
該当なし
定義済み
エンティティ
親テンプレート
Prop1
Prop2
Prop3
Prop4
実装されたシェイプ
有効なプロパティ
Template1
定義済み
該当なし
該当なし
該当なし
ThingShape1
Prop1ShapeProp1
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、homeMashupisSystemObject、name、tags、クエリーの実行対象の Thing Template で定義されているすべてのプロパティ、および入力パラメータと一致する Thing の直接の親テンプレートが含まれているインフォテーブルを返します。
次のクエリーでは、avatar、description、homeMashupisSystemObject、name、tags、Prop1Prop2Prop4ShapeProp1ShapeProp2ShapeProp4、および 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、homeMashupisSystemObject、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*\" }}"

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