Composer 中的 ThingWorx 模型定義 > 建模 > 物群組 > 物群組常見問題集
物群組常見問題集
問題
回答
我是否可以配置將執行時間權限委派給物群組？
不可以，因為「物群組」實體沒有「物件」實體所擁有的相同服務集。對於從現成物範本與物形式建立的自訂物件也是如此，對於自訂物範本與物形式尤為如此。
如何啟用物群組成員資格相關稽核記錄訊息？
必須在 platform-settings.json 檔案中啟用此功能。如需詳細資訊，請參閱稽核子系統訊息。
如何取得可在 ThingWorx 應用程式中管理或使用的「全部物件」清單？
有兩種方法可以檢視您有權檢視的所有物件實體：
• 在 Composer 中：從 Composer 的「建模」部份選取「物件」，即可檢視允許您檢視的所有物件。如果使用者擁有 Composer 的所需權限，以及檢視物件集合內物件的可見度權限，則不需要物群組。
• 透過 REST API：ThingWorx 提供適用於 REST、JavaScript 服務以及 Java 延伸功能邏輯的 API，用來從物件集合取得物件清單。呼叫該物件集合清單 API 之邏輯的使用者前後關聯可決定所使用的可見度權限，以及所傳回物件的清單。您可以使用 JavaScript 服務與 Java 延伸功能編寫 ThingWorx 應用程式。針對 REST API，資源 URI 為 /Thingworx/Things 端點。
使用者或使用者群組有權看到哪些物群組或物件？
服務的授權使用者可以依照下列方式進行確定：
1. 確定使用者或使用者群組屬於其成員的組織與/或組織單位。
2. 使用反覆方法 (例如 ThingWorx 服務指令集中的 for 迴圈) 逐一查看所有物件/物群組，並呼叫 GetVisibilityPermissions 或 GetVisibilityPermissionsAsJSON 服務，以查看是否有任何組織/組織單位包含在第一步所擷取的清單中。
* 
配置呼叫這些服務的權限時應小心，因為服務會檢查精確成員資格並傳回清單，而不考慮群組的可見度，因此它們是由授權 API 工作流程所使用。
啟用物群組可見度權限委派的效能影響是什麼？
啟用物群組可見度權限委派時，效能影響會因包括下列項目的數個部署組態而有所不同：
• 如果使用者是物件或物群組的管理員或擁有者，就不需要進一步檢查可見度權限委派功能。
• 對於請求使用者而言，可接受且有效的明確物件/物群組可見度權限不需要進一步檢查可見度權限委派功能。
• 物群組階層模型的版面配置 (深度、寬度、編號等) 會影響跨該階層參與者的可見度檢查演算法。
• 使之前可見度檢查失效的物群組成員資格變更 (模型變更) 率在上一點需要重新計算。
• 如果先前的可見度檢查資料不再可用，則存取特定物件/物群組可見度的速率可能需要重新計算。
* 
如果禁用可見度權限委派，則可見度檢查效能會與直接物件/物群組可見度檢查效能一致。
如何取得要在 ThingWorx 應用程式中使用之模型/物範本內所有物件的清單？
欲取得對您可見之所有物件的清單：
* 
Axeda 模型在 ThingWorx 中以物範本表示。
• 將服務呼叫 (透過 REST、JavaScript 服務、Java 延伸功能) 用於物範本與物形式的其中一個 QueryImplementingThings 服務：
◦ QueryImplementingThings
◦ QueryImplementingThingsWithData
◦ QueryImplementingThingsWithNamedData
◦ QueryImplementingThingsWithPropertyHistory
◦ QueryImplementingThingsWithNamedPropertyHistory
您可在不提供查詢參數的情況下使用下列服務：
• GetImplementingThings
• GetImplementingThingsWithData
如何為要在 ThingWorx 應用程式中使用之區域的物件建模？
區域是指可以使用模型標籤、內容值、物群組實體等來建模的地理區域或行政區。
物群組實體提供原生階層功能，可讓您將區域作為階層嵌套在區域內。您可以為特定使用者集提供對階層中物件與物群組的可見度。
1. 使用 REST API、ThingWorx 中的服務或透過物群組實體 UI 建立物群組。
2. 藉由提供其他實體模型資料 (例如名稱、描述與標籤)，來自訂物群組實體的詳細資訊。
3. 透過物群組成員 REST API 與/或服務，將任何物件或子區域物群組新增為物群組的成員。
如何列出區域的物件？
有幾種方法可供使用，具體取決於您實行區域及標記區域物件的方式。您可使用模型標籤 (未提供階層)、字串內容值 (未提供階層)，或物群組 (已提供階層)。
• 如果您使用模型標籤或字串內容值，則可使用各種搜尋資源服務，或者如果物範本/物形式為已知，您可以使用各種 QueryImplementingThings、QueryImplementingThingsWithData、QueryImplementingThingsWithNamedData、QueryImplementingThingsWithPropertyHistory、GetImplementingThingsWithData 等相關服務來取得符合搜尋條件的物件清單。
• 如果您將區域完全或部份實行為物群組，您可以找出特定區域的物群組，並呼叫會傳回不含查詢條件之物件清單的服務。
如何為要在 ThingWorx 應用程式中管理及/或使用的客戶物件建模？
您可以使用模型標籤、內容值或物群組實體來為客戶、公司、企業或部門建模。使用這些建模範例的物群組所提供的功能，可讓您將企業或其他類似的非地理結構作為階層來嵌套。您可以為特定使用者集提供對階層中物件與物群組的可見度。
1. 使用 REST API 與/或 ThingWorx 中的服務或透過物群組實體 UI 建立物群組。
2. 藉由提供其他實體模型資料 (例如名稱、描述與標籤)，來自訂物群組實體的詳細資訊。
3. 透過物群組成員 REST API，將任何物件或子區域物群組新增為物群組的成員，或使用服務以利用原生嵌套/階層功能。
如何列出客戶的物件？
有多種方法可供使用，具體取決於您實行客戶及標記客戶物件的方式。除了其他項目以外，您還可以使用模型標籤 (未提供階層)、字串內容值 (未提供階層)，或物群組 (已提供階層)。
• 如果您使用模型標籤或字串內容值，則可使用各種搜尋資源服務，或者如果物範本/物形式為已知，您可以使用例如 QueryImplementingThings、QueryImplementingThingsWithData、QueryImplementingThingsWithNamedData、QueryImplementingThingsWithPropertyHistory、GetImplementingThingsWithData 的各種服務來取得符合搜尋條件的物件清單。
• 如果您將客戶完全或部份實行為物群組，您可以找出作為客戶的物群組，並呼叫會傳回不含查詢條件之物件清單的服務。
如何為要在 ThingWorx 應用程式中管理及/或使用的系統物件建模？
有多種方法可供使用：
• 使用 THINGNAME 作為在物件上定義之內容的基礎類型。這可讓您顯示具有這些內容的物件是包含這些內容所參考之物件的容器物件。會將名稱為 THINGNAME 基礎類型內容值的物件視為包含的物件。您也可以設定這些內容的強類型，以允許特定包含的物件實行特定物形式或物範本。
• 對於當包含的物件僅由網路中的一個節點所包含這一情況，請定義/使用網路。如果物件由一個網路中的多個節點所包含，則請使用上一種情況。
• 如果前兩種方法不足以解決問題，您也可以使用物群組的一般功能來滿足應用程式邏輯或模型需求。
如何使用相同位置 (例如「我的家」或「我的公司」) 來為一組物件建模？
由於這些物件共用相同位置，因此您可以使用模型標籤、內容值、物群組或包含的物件來為群組建模。
如果您使用物群組將這些物件保存為成員，您也可以在物群組中嵌套物件，以將物件分類並收集到「我的家」或「我的公司」共置物件的子群組中。在此範例中，嵌套/子群組可以是建築物內的房間或地板。
如何將位置與區域相關聯？
針對內容定義使用 LOCATION 基礎類型 (緯度、經度與海拔資料)，或針對位置 (例如街道地址或其他座標系或地區設定格式) 建立您自己的位置中繼資料的資料負載。
如果實體模型或 ThingWorx 應用程式需要瞭解「指定區域所擁有或包含在其中」的位置資料，可以視應用程式執行時間效能需求而定，將該位置資料的授權儲存在資料表中。此資訊可以存在於物群組內的各階層層級，作為這些物群組的成員，或透過其他自訂/應用程式特定關聯 (例如模型標籤或資料標籤) 存在。
如何將位置與客戶相關聯？
針對內容定義使用 LOCATION 基礎類型 (緯度、經度與海拔資料)，或針對位置 (例如街道地址或其他座標系或地區設定格式) 建立您自己的位置中繼資料的資料負載。
如果實體模型或 ThingWorx 應用程式需要瞭解「指定客戶、公司、企業或部門所擁有或包含在其中」之任何格式的位置資料，可以視應用程式執行時間效能需求而定，將該位置資料的授權儲存在資料表中。此資訊可以存在於物群組內的各階層層級，作為這些物群組的成員，或透過其他自訂/應用程式特定關聯 (例如模型標籤或資料標籤) 存在。
如何將位置新增至一或多個物件？
ThingWorx 提供豐富的模型，可用來透過已從物件實例中設定、儲存及擷取其值的「物件」、「物範本」與「物形式」內容定義，將資料指派給物件。
如果您的物件屬於特定通用類型並共用通用物範本，或者您擁有不同類型的物件，但卻共用或者可以共用通用物形式，則可在該通用物範本與/或物形式上定義一次內容。
物範本或物形式中該內容定義的值在物件上設定。如果您為內容定義了 LOCATION、STRING 或其他基礎類型，則可在物件上設定該位置內容的值。該內容的值取決於其基礎類型或您要在應用程式中支援之資料的自訂格式，例如座標或街道地址。
如何將客戶新增至一或多個物件？
ThingWorx 提供豐富的模型，可用來透過已從物件實例中設定、儲存及擷取其值的「物件」、「物範本」與「物形式」內容定義，將資料指派給物件。
如果您的物件或資產屬於特定通用類型並共用通用物範本，或者您擁有不同類型的物件與資產，但卻共用或者可以共用通用物形式，則可在該通用物範本與/或物形式上定義一次內容。
物範本或物形式中該內容定義的值在物件上設定。如果您將內容定義為 STRING 或其他基礎類型，則可在物件或資產上設定該客戶、公司、企業或部門名稱內容 的值。該內容的值取決於其基礎類型或您要在應用程式中支援之資料的自訂格式，例如客戶、公司、企業或部門名稱。
如何視覺化物群組的子項？
在 Composer 中，開啟現有物群組。按一下「成員資格詳細資訊」標籤，找到下拉式方塊，然後選取「直接子項物件群組」。
欲檢視物群組子項的詳細資訊，請按一下「成員資格詳細資訊」標籤面板中的項目，然後選取「檢視」。從該檢視中，轉至「成員資格詳細資訊」，即可檢視該物群組的直接子項物群組。
如何視覺化物群組的父物群組？
在 Composer 中，開啟現有物群組。按一下「成員資格詳細資訊」標籤，找到下拉式方塊，然後選取「直接父項物件群組」。
欲檢視物群組子項的詳細資訊，請按一下「成員資格詳細資訊」標籤面板中的項目，然後選取「檢視」。從該檢視中，轉至「成員資格詳細資訊」，即可檢視該物群組的直接子項物群組。
我什麼時候該使用網路？什麼時候該使用物群組？
針對物件之間的引導連線關係，例如生產線中的機器，建議使用網路。而如果要按諸如範本類型、位置、客戶或區域這類的通用特徵分組物件，則建議使用物群組。
雖然網路與物群組都提供了為階層建模的能力，但還是應該考量它們之間的差異。
• 網路需要利用網路來跟隨任何指定節點的子項與父項。
• 網路不能包含另一個網路實體作為成員。
• 物群組可讓您擁有階層及導覽階層。因此，建議針對物群組使用建模區域、客戶與其他階層關係。
• 您可以在其他物群組中重新使用物群組作為子項，來建立多個階層的可重新使用子集分支。
這是否有幫助?