詳細
|
|
---|---|
説明
|
クエリー基準によって指定されたプロパティの数を返します。
|
パラメータ
|
query
• QUERY ベースタイプ
• 使用可能な値については、「サポートされているクエリーフィルタタプルエレメント」を参照してください。
|
結果 (無効なクエリーパラメータ)
|
クエリーが無効であることを示すエラーメッセージ。
|
結果 (有効なクエリーパラメータ)
|
数値
|
|
これらのエレメントタイプでは大文字と小文字が区別されます。
|
フィールド名 (エレメントタイプ)
|
タイプ
|
値タイプ
|
説明
|
値の例
|
JSON の例
|
||
---|---|---|---|---|---|---|---|
entityNameMask
|
部分一致
|
STRING
|
• オプションのフィールド。entityNameMask は暗黙的なフィールドの名前です。
• その値のタイプは STRING である必要があります。これには値としてエンティティの名前が含まれ、property_vtq 内の、指定された value と部分一致するレコードだけを選択します。
|
• *
• Thing1
• *hing1*
|
{ "fieldName": "entityNameMask", "type": "LIKE", "value", "*" }
{ "fieldName": "entityNameMask", "type": "LIKE", "value", "Thing1" }
{ "fieldName": "entityNameMask", "type": "LIKE", "value", "*hing1*" }
|
||
entityTypeMask
|
部分一致
|
STRING
|
• オプションのフィールド。entityTypeMask は暗黙的なフィールドの名前です。
• その値のタイプは STRING である必要があります。これには値としてエンティティのタイプが含まれ、property_vtq 内の、指定された value と部分一致するレコードだけを選択します。
|
• *
• Thing
• *hin*
|
{ "fieldName": "entityTypeMask", "type": "LIKE", "value", "*" }
{ "fieldName": "entityTypeMask", "type": "LIKE", "value", "Thing" }
{ "fieldName": "entityTypeMask", "type": "LIKE", "value", "*Thin*" }
|
||
propertyNameMask
|
部分一致
|
STRING
|
• オプションのフィールド。propertyNameMask は暗黙的なフィールドの名前です。
• その値のタイプは STRING である必要があります。これには値としてプロパティの名前が含まれ、property_vtq 内の、指定された value と部分一致するレコードだけを選択します。
|
• *
• prop1
• *rop1*
• *erialNumber
• model*umbe*
|
{ "fieldName": "propertyNameMask", "type": "LIKE", "value", "*" }
{ "fieldName": "propertyNameMask", "type": "LIKE", "value", "prop1" }
{ "fieldName": "propertyNameMask", "type": "LIKE", "value", "*rop1*" }
{ "fieldName": "propertyNameMask", "type": "LIKE", "value", "*erialNumber" }
{ "fieldName": "propertyNameMask", "type": "LIKE", "value", "model*umbe" }
|
||
propertyBaseType
|
部分一致
|
STRING
|
• オプションのフィールド。propertyBasetype は暗黙的なフィールドの名前です。
• その値のタイプは STRING である必要があります。これには値として有効なベースタイプの名前が含まれ、property_vtq 内の、指定された値と部分一致するレコードだけを選択します。
• propertyIsIndexed が true の場合、propertyBaseType の値は、次のいずれかの有効なインデックシング可能なベースタイプのわかりやすい名前である必要があります。
◦ STRING
◦ NUMBER
◦ INTEGER
◦ LONG
◦ BOOLEAN
◦ DATETIME
◦ THINGNAME
◦ USERNAME
◦ GROUPNAME
◦ HYPERLINK
◦ MASHUPNAME
◦ MENUNAME
◦ DASHBOARDNAME
◦ TEXT
◦ GUID
◦ NOTIFICATIONCONTENTNAME
◦ NOTIFICATIONDEFINITIONNAME
◦ STYLETHEMENAME
◦ THINGGROUPNAME
• propertyIsIndexed が false の場合、次のいずれかを指定できます。
◦ PASSWORD
◦ INFOTABLE
◦ LOCATION
◦ IMAGE
◦ XML
◦ JSON
◦ QUERY
◦ HTML
◦ BLOB
◦ VEC2
◦ VEC3
◦ VEC4
◦ THINGCODE
|
• thingname
• thingNaMe
• THINGNAME
• THINGNamE
• String
• STRING
• BOOLean
• Boolean
• veC2
|
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "thingname" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "thingNaMe" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "THINGNAME" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "THINGNamE" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "String" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "STRING" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "BOOLean" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "Boolean" }
{ "fieldName": "propertyBaseType", "type": "LIKE", "value", "veC2" }
|
||
propertyIsIndexed
|
EQ
|
BOOLEAN
|
• オプションのフィールド。propertyIsIndexed は暗黙的なフィールドの名前です。
• その値のタイプは有効な BOOLEAN である必要があります。この値を使用して、property_vtq 内の、指定された value と等しいインデックス付きプロパティとインデックスなしプロパティをフィルタします。
• 有効な値は true および false です。
|
• true
• false
|
{ "fieldName": "propertyIsIndexed", "type": "EQ", "value", true}
{ "fieldName": "propertyIsIndexed", "type": "EQ", "value", false}
|
内容
|
説明
|
GetPropertyVTQCount クエリー JSON の例
|
---|---|---|
ThingWorx プラットフォームのランタイムで、インデックス付き ThingName 値が含まれているプロパティの数を特定します。
|
任意 (*) の Thing プロパティで Thing (Thing1) が指定されている回数を調べて、それがプラットフォーム内のカスタムアプリケーションモデル内で使用されている回数を特定します。これは QueryImplementingThingOptimized サービスへのクエリーパラメータ入力として提供される可能性があるプロパティ機能に対して、さらに最適化された "Where Used" クエリーとなる可能性があります。
{
"filters": { "fieldName": "*", "type": "LIKE", "value": "Thing1" } } |
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "ThingName" }, { "fieldName": "propertyIsIndexed", "type": "EQ", "value": true } ], "type": "AND" }, "type": "SELF" } |
ThingWorx プラットフォームのランタイムで、インデックシングされていない、STRING ベースタイプを持つ、モデル番号 B-X42 が含まれているプロパティの数 (つまり Thing の数) を特定します。
|
プラットフォームで新しい B-X42 バッテリタイプの Thing としてモデル化されているバッテリの数をモデル番号に基づいて調べます。
{
"filters": { "fieldName": "modelNumber", "type": "LIKE", "value": "B-X42" } } |
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "String" }, { "fieldName": "propertyIsIndexed", "type": "EQ", "value": false }, { "fieldName": "propertyNameMask", "type": "LIKE", "value": "B-X42" } ], "type": "AND" }, "type": "SELF" } |
ThingWorx プラットフォームのランタイムで、インデックシングされており、STRING ベースタイプを持つ、モデル番号 B-X* が含まれているプロパティの数 (つまり Thing の数) を特定します。
|
プラットフォームでモデル番号 (1、2、3、41、43 など) に関係なく、バッテリタイプの Thing としてモデル化されているバッテリの数を調べます。
{
"filters": { "fieldName": "modelNumber", "type": "LIKE", "value": "B-X*" } } |
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "String" }, { "fieldName": "propertyIsIndexed", "type": "EQ", "value": true }, { "fieldName": "propertyNameMask", "type": "LIKE", "value": "B-X*" } ], "type": "AND" }, "type": "SELF" } |
無効なクエリー
|
エラー結果の原因となる例
|
||
---|---|---|---|
フィルタタプルフィールドで OR フィルタコレクションが指定されている。
|
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "String" }, { "fieldName": "propertyIsIndexed", "type": "EQ", "value": true } ], "type": "OR" }, "type": "SELF" } |
||
フィールド名として 5 つのエレメントタイプのうちの 1 つが 2 回以上出現する。
|
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "String" }, { "fieldName": "propertyBaseType", "type": "LIKE", "value": "Long" } ], "type": "AND" }, "type": "SELF" } |
||
propertyBaseType の値が無効である。
|
{
"filters": { "filters": [ { "fieldName": "propertyBaseType", "type": "LIKE", "value": "InvalidType" }, { "fieldName": "propertyIsIndexed", "type": "EQ", "value": true } ], "type": "AND" }, "type": "SELF" } |
||
fieldName の値が無効である。
|
{
"filters": { "filters": [ { "fieldName": "invalidFieldName", "type": "LIKE", "value": "*" } ], "type": "AND" }, "type": "SELF" } |