映像實體延伸功能
 |
此延伸功能僅可與 ThingWorx 8.5.x 版本搭配使用。此功能是 ThingWorx 平台 9.0.0 中的一部份。
|
|
|
您可在下列位置找到「映像實體」延伸功能：
support.ptc.com 的「下載軟體」>「訂購或下載軟體更新」> ThingWorx Foundation >「8.5 發行版本」>「ThingWorx 映像實體延伸功能」>「最新日期代碼」下。
|
關於映像實體
• 映像實體是記憶體中因錯誤而無法建立的實體表示。
• 映像實體只會存留到下一次 ThingWorx 重新啟動之前。
• 不會將失敗的實體提交至資料庫。
• 一般而言，映像實體是在以程式方式呼叫 Create<Entity> 服務的服務中，因錯誤處理例外而產生的結果 (CreateUser、CreateThing 等)。
• 如果在自訂 ThingWorx 服務執行期間擲出例外，所建立的任何實體都不會提交至資料庫。
• 當存在映像實體時，無法建立相同類型 (物件、使用者、群組等) 與相同名稱的實體。
• 在 Composer 中，無法使用 Spotlight 搜尋來搜尋映像實體。
• 只能透過使用特定 ThingWorx 服務來尋找映像實體。
• 除非利用少數幾個特定 ThingWorx 服務，否則無法透過 Composer 與映像實體進行互動。
• 重新啟動 ThingWorx 時，會從記憶體中移除映像實體。
使用映像實體延伸功能
• 此延伸功能會建立名為 GhostEntitiesResource 的新資源實例。
• 新資源會提供 GetGhostEntities 服務，其會採用單一布林參數 (deleteGhosts)。
◦ 如果 deleteGhosts 參數為 false，服務將會尋找並列出目前存在於記憶體中的映像實體。
◦ 如果 deleteGhosts 參數為 true，服務將會尋找並刪除目前存在於記憶體中的所有映像實體。
▪ 由 GetGhostEntities 傳回的資料負載 (true) 應為空白，表示已刪除所有映像實體。