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