サービスを使用した値ストリームデータへのアクセス

Composer での ThingWorx モデルの定義 > データストレージ > 値ストリーム > サービスを使用した値ストリームデータへのアクセス

Thing または Thing Template から以下の値ストリームサービスを使用できます。値ストリームを使用する Thing からデータにアクセスする必要があります。

提供されているサービスを使用して、さまざまな方法で値ストリームエントリを取得できます。たとえば、特定のログプロパティ (QueryBooleanPropertyHistory、QueryDateTimePropertyHistory)、ログプロパティのセット (QueryNamedPropertyHistory)、またはすべてのログプロパティ (QueryPropertyHistory) によってエントリを取得できます。

複数のプロパティを取得する場合、ThingWorx は Null を含まない同期化された完全なテーブルが返されるように特別なアルゴリズムを実行します。たとえば、あるプロパティが別のプロパティよりも頻繁に記録されている場合、両方のプロパティが一度に取得されたときには ThingWorx によって空白が埋められます。

データの作成元の Thing がデータを明示的にパージするか値ストリームが削除された場合を除き、値ストリームデータは削除されません。データ作成元の Thing またはプロパティが削除されても、データはそのまま残ります。

値ストリームの永続化プロバイダを (ThingworxPersistenceProvider から PostgreSQL または InfluxDB などに) 切り替える場合、値ストリームを実装するすべての Thing が RestartThing サービスを呼び出して、新しい永続化プロバイダに書き込まれたエントリを取得する必要があります。Thing が再起動されない場合でもエントリはデータベースに書き込まれますが、Thing が再起動されるまで取得されません。

値ストリームサービス

サービス	説明
AddBooleanValueStreamEntry	Thing の値ストリームにブールタイプのプロパティの値を追加します。
AddDateTimeValueStreamEntry	Thing の値ストリームに日時タイプのプロパティの値を追加します。
AddImageValueStreamEntry	Thing の値ストリームにイメージタイプのプロパティの値を追加します。
AddInfoTableValueStreamEntry	Thing の値ストリームにインフォテーブルタイプのプロパティの値を追加します。
AddIntegerValueStreamEntry	Thing の値ストリームに整数タイプのプロパティの値を追加します。
AddLocationValueStreamEntry	Thing の値ストリームに場所タイプのプロパティ値を追加します。
AddLongValueStreamEntry	Thing の値ストリームに長整数プロパティ値を追加します。
AddNumberValueStreamEntry	Thing の値ストリームに数値タイプのプロパティの値を追加します。
AddStringValueStreamEntry	Thing の値ストリームに文字列タイプのプロパティの値を追加します。
AddThingCodeValueStreamEntry	Thing の値ストリームに Thing Code タイプのプロパティの値を追加します。
AddVec2ValueStreamEntry	指定された vec2 (2 つの数値のコレクション。たとえば、2D 座標 x および y) プロパティの値を Thing の値ストリームに追加します。
AddVec3ValueStreamEntry	指定された vec3 (3 つの数値のコレクション。たとえば、3D 座標 x、y、および z) プロパティの値を Thing の値ストリームに追加します。
AddVec4ValueStreamEntry	指定された vec4 (4 つの数値のコレクション。たとえば、4D 座標 x、y、z、および w) プロパティの値を Thing の値ストリームに追加します。
GetLoggedProperties	値ストリームに記録するようマークされた Thing のプロパティのリストを返します。
GetNumericLoggedProperties	指定した数値ベースタイプのプロパティのリストを返します。
GetPropertyLogging	QueryBooleanPropertyHistory
GetValueStream	Thing に割り当てられている値ストリームの名前を返します。
PurgePropertyHistory	指定された日付範囲内にあるプロパティのすべての値ストリームエントリを削除します。
QueryBooleanPropertyHistory	値ストリームエントリに対して、指定されたブールタイプ Thing プロパティの指定された日付範囲内にある値をクエリーします。
QueryDateTimePropertyHistory	値ストリームエントリに対して、指定された日時タイプ Thing プロパティの値をクエリーします。
QueryImagePropertyHistory	値ストリームエントリに対して、指定されたイメージタイプ Thing プロパティの値をクエリーします。
QueryInfoTablePropertyHistory	値ストリームエントリに対して、指定されたインフォテーブルタイプ Thing プロパティの指定された日付範囲内にある値をクエリーします。
QueryIntegerPropertyHistory	値ストリームエントリに対して、指定された整数タイプ Thing プロパティの値をクエリーします。
QueryLocationPropertyHistory	値ストリームエントリに対して、指定された場所タイプ Thing プロパティの指定された時刻範囲内にある値をクエリーします。
QueryLongPropertyHistory	値ストリームエントリに対して、指定された長整数タイプ Thing プロパティの値をクエリーします。
QueryNamedPropertyHistory	値ストリームエントリに対して、フィルタと並べ替えの基準とともに、指定されたログプロパティの値をクエリーし、データセットを正規化して、指定された時刻範囲内にある結果を表示します。
QueryNumberPropertyHistory	値ストリームに対して、指定された数値タイプ Thing プロパティの指定された時刻範囲内にある値をクエリーします。
QueryPropertyHistory	値ストリームに対して、フィルタと並べ替えの基準とともに、ログプロパティの値をクエリーし、データセットを正規化して、指定された時刻範囲内にある結果を表示します。
QueryStringPropertyHistory	値ストリームに対して、指定された文字列タイプ Thing プロパティの指定された時刻範囲内にある値をクエリーします。
QueryThingCodePropertyHistory	値ストリームエントリに対して、指定された thingcode (ドメイン ID とインスタンス ID を含む Thing の数値表現) タイプ Thing プロパティの値をクエリーします。
QueryVec2PropertyHistory	値ストリームエントリに対して、指定された vec2 (2 つの数値のコレクション。たとえば、2D 座標 x および y) Thing プロパティの値をクエリーします。
QueryVec3PropertyHistory	値ストリームエントリに対して、指定された vec3 (3 つの数値のコレクション。たとえば、3D 座標 x、y、および z) Thing プロパティの値をクエリーします。
QueryVec4PropertyHistory	値ストリームエントリに対して、指定された vec4 (4 つの数値のコレクション。たとえば、4D 座標 x、y、z、および w) Thing プロパティの値をクエリーします。
SetPropertyLogging	指定されたプロパティのログをオンまたはオフに切り替えます。
SetValueStream	Thing の値ストリームを設定します。

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