使用服務存取值串流資料
可透過物件或物範本使用下列值串流服務。必須透過使用值串流的物件存取資料。
您可利用所提供的服務以多種方式擷取值串流項目。例如，可透過特定的已記錄內容 (QueryBooleanPropertyHistory, ;QueryDateTimePropertyHistory)、一組已記錄內容 (QueryNamedPropertyHistory) 或所有已記錄內容 (QueryPropertyHistory) 擷取項目。
擷取多筆內容時，ThingWorx 會執行特殊演算法，來確保傳回的是同步但無空值的完整表格。例如，如果某個內容的記錄頻率比另一個內容高，則同時擷取這兩筆內容時，ThingWorx 就會填寫空白部份。
除非建立資料的物件明確清除該筆資料，或是值串流遭到刪除，否則系統不會刪除值串流資料。若原始物件或內容遭到刪除，資料仍保持不變。
 |
轉換值串流的持續性提供者 (例如，從 ThingworxPersistenceProvider 轉換為 PostgreSQL 或 InfluxDB) 時，實行值串流的任何物件都必須呼叫 RestartThing 服務，才能擷取已寫入至新持續性提供者的項目。若未重新啟動物件，項目可能會被寫入至資料庫；不過，在重新啟動物件之前，系統不會擷取這些項目。
|
值串流服務
|
服務
|
描述
|
|---|---|
|
AddBooleanValueStreamEntry
|
將布林內容值新增至物件的值串流。
|
|
AddDateTimeValueStreamEntry
|
將日期與時間內容值新增至物件的值串流。
|
|
AddImageValueStreamEntry
|
將圖像內容值新增至物件的值串流。
|
|
AddInfoTableValueStreamEntry
|
將資料負載內容值新增至物件的值串流。
|
|
AddIntegerValueStreamEntry
|
將整數內容值新增至物件的值串流。
|
|
AddLocationValueStreamEntry
|
將位置內容值新增至物件的值串流。
|
|
AddLongValueStreamEntry
|
將長整型值內容值新增至物件的值串流。
|
|
AddNumberValueStreamEntry
|
將數字內容值新增至物件的值串流。
|
|
AddStringValueStreamEntry
|
將字串內容值新增至物件的值串流。
|
|
AddThingCodeValueStreamEntry
|
將物件代碼內容值新增至物件的值串流。
|
|
AddVec2ValueStreamEntry
|
為物件值串流新增指定的 VEC2 (兩個數字的集合。例如， 2D 座標 x 與 y) 內容值。
|
|
AddVec3ValueStreamEntry
|
為物件值串流新增指定的 VEC3 (三個數字的集合。例如，3D 座標 x、y 與 z) 內容值。
|
|
AddVec4ValueStreamEntry
|
為物件值串流新增指定的 VEC4 (四個數字的集合。例如，4D 座標 x、y、z 與 w) 內容值。
|
|
GetLoggedProperties
|
傳回有值串流記錄標記的物件內容清單。
|
|
GetNumericLoggedProperties
|
傳回指定數字基礎類型的內容清單。
|
|
GetPropertyLogging
|
QueryBooleanPropertyHistory
|
|
GetValueStream
|
傳回指派給物件的值串流名稱。
|
|
PurgePropertyHistory
|
刪除指定日期範圍內某內容的所有值串流項目。
|
|
QueryBooleanPropertyHistory
|
查詢某日期範圍內物件指定布林內容值的值串流項目。
|
|
QueryDateTimePropertyHistory
|
查詢物件指定日期時間內容值的值串流項目。
|
|
QueryImagePropertyHistory
|
查詢物件指定圖像內容值的值串流項目。
|
|
QueryInfoTablePropertyHistory
|
查詢某日期範圍內物件指定資料負載內容值的值串流項目。
|
|
QueryIntegerPropertyHistory
|
查詢物件指定整數內容值的值串流項目。
|
|
QueryLocationPropertyHistory
|
查詢指定時間範圍內物件指定位置內容值的值串流項目。
|
|
QueryLongPropertyHistory
|
查詢物件指定長整型內容值的值串流項目。
|
|
QueryNamedPropertyHistory
|
查詢指定的已記錄內容值的值串流項目，以及篩選器與排序條件，並標準化資料集以顯示指定時間範圍的結果。
|
|
QueryNumberPropertyHistory
|
查詢指定時間範圍內物件數字內容值的值串流項目。
|
|
查詢已記錄內容值的值串流，以及篩選器與排序條件，並標準化資料集以顯示指定時間範圍的結果。
|
|
|
QueryStringPropertyHistory
|
查詢指定時間範圍內物件指定字串內容值的值串流。
|
|
QueryThingCodePropertyHistory
|
查詢物件之指定物件代碼 (包含網域 ID 與實例 ID 之物件的數值表示) 內容值的值串流項目。
|
|
QueryVec2PropertyHistory
|
查詢物件之指定 VEC2 (兩個數字的集合。例如，物件的 2D 座標 x 與 y) 內容值的值串流項目。
|
|
QueryVec3PropertyHistory
|
查詢物件之指定 VEC3 (三個數字的集合。例如，物件的 3D 座標 x、y 與 z) 內容值的值串流項目。
|
|
QueryVec4PropertyHistory
|
查詢物件之指定 VEC4 (四個數字的集合。例如，物件的 4D 座標 x、y、z 與 w) 內容值的值串流項目。
|
|
SetPropertyLogging
|
開啟或關閉指定內容的記錄功能。
|
|
SetValueStream
|
設定物件的值串流。
|