以程式設計的方式將內容新增至物件
AddPropertyDefinition 服務可以用來在物件、物範本或物形式上建立新的本機或遠端繫結內容。服務具有下列參數：
|
參數
|
基礎類型
|
描述
|
|---|---|---|
|
name
|
STRING
|
必填。要建立的內容的名稱。
|
|
type
|
BASETYPENAME
|
必填。内容的 ThingWorx 基礎類型。如需 ThingWorx 基礎類型的清單，請參閱物件內容中的「基礎類型」表格。
|
|
description
|
STRING
|
內容的描述。
|
|
category
|
STRING
|
用於分類內容的類別名稱。
|
|
dataShape
|
DATASHAPENAME
|
內容基礎類型為 INFOTABLE 時，可定義內容所使用的資料形式。
• 必須先有針對此參數指定的資料形式實體，而後服務才能執行。
• 此參數並非必須。但是，在未指定資料形式的情況下，無法透過 Composer (使用「設定」按鈕) 設定資料負載。
|
|
defaultValue
|
STRING
|
指定內容的預設值。
|
|
readOnly
|
BOOLEAN
|
如果內容為唯讀則為 true，否則為 false。
|
|
persistent
|
BOOLEAN
|
如果值在 ThingWorx 服務重新啟動後仍然持續存在則為 true (值儲存在持續性提供者中)，若值會在 ThingWorx 服務重新啟動後遭到清除則為 false。
|
|
logged
|
BOOLEAN
|
若為 true，內容會儲存在已配置的值串流中。
|
|
dataChangeType
|
STRING
|
定義構成內容值變更的項目，以便記錄/警示。「總是」、「從不」、「開啟」、「關閉」或「值」中的一個。
• 「總是」- 針對任何內容值變更觸發變更事件。
• 「從不」- 從不針對內容值變更觸發變更事件。
• 「開啟」- 對於大多數值，任何內容變更都會觸發資料變更事件。
• 「關閉」- 若新值計算結果為布林值 false，則會觸發資料變更事件。
• 「值」- 對於數字類型 (NUMBER、INTEGER、LONG 等等)，若舊內容值及新內容值之間的差超出 dataChangeThreshold 參數中指定的臨界值，即會觸發變更事件。
|
|
dataChangeThreshold
|
NUMBER
|
在觸發資料變更事件之前，數值內容應變更的最小數。
|
遠端內容
提供有其他遠端繫結內容的參數。系統會將其指定為 remoteBindingAspects 的陣列。
 |
除非已定義的內容被繫結至遠端內容，否則不需指定這些內容。
|
|
參數
|
基礎類型
|
描述
|
||
|---|---|---|---|---|
|
remote
|
BOOLEAN
|
如果內容繫結至遠端內容則為 true，否則為 false。(預設值是 false)
|
||
|
remotePropertyName
|
STRING
|
遠端物件上要繫結的內容的名稱。
|
||
|
cacheMethod
|
STRING
|
讀取繫結 Edge 内容值的方法：
• Read from server cache 禁止伺服器向 Edge 請求內容值。始終會從伺服器快取中檢索值。對快取值的任何更新取決於內容的 dataChangeType 和掃描率。若未在 Edge 上對内容進行內容設定，則伺服器可能永遠無法取得來自 Edge 的值，且只能傳回儲存在伺服器上的預設值。如果内容的 dataChangeType 為 ALWAYS 或 VALUE，則 cacheMethod 預設為此設定。
• Fetch from remote every read 從 Edge 中檢索每個請求的值。此選項不牽涉快取。如果内容的 dataChangeType 為 NEVER，則快取類型預設為此設定。
• Cached for specific time 可用於控制對 Edge 進行請求的頻率。第一次請求後，伺服器會存取 Edge 裝置上的內容以取得其值。除非定義的 cacheInterval 到期，否則不會對 Edge 提出另一個請求。請注意，Edge 裝置可能會在該期間內更新伺服器上的值 (透過推送)。
|
||
|
cacheInterval
|
NUMBER
|
當 cacheMethod 為 Cached for specific time 時，伺服器在將請求傳送至 Edge 以取得內容值之前用於快取內容值的秒數。系統總是在第一次請求時從 Edge 擷取值。
|
||
|
timeout
|
INTEGER
|
等候遠端物件回應的時間 (以秒計)。
|
||
|
pushType
|
STRING
|
定義從遠端裝置推送值的方式。設定為「總是」、「從不」、「開啟」、「關閉」或「值」，與上述 dataChangeType 的定義類似。
|
||
|
pushThreshold
|
NUMBER
|
定義在將資料變更推進至遠端裝置之前，數字類型內容必須超出的臨界值。
|