自訂資訊內容與存取 > 管理情境與設備的權限 > 用於授予、傳播及檢視權限的服務
用於授予、傳播及檢視權限的服務
以下各節詳細說明了情境管理員物件 (PTC.SCA.SCO.DefaultContextManager) 上提供的針對情境和設備 授予權限、 傳播權限以及 檢視權限設定的服務。
用於授予權限的服務
提供此類服務的目的是為了向使用者或使用者群組授予權限。使用這些服務來授與權限時，會產生下列結果︰
• 授與 Read 會將讀取 (Read) 權限設為 true，並將寫入(Write) 權限設為 false。
• 授予 Write 會將讀取 (Read) 與寫入 (Write) 權限設為 true。
• 授予 None 會將讀取 (Read) 與寫入 (Write) 權限設為 false。
此類服務中的權限類型值 (Read、Write 和 None) 與實體類型值 (Context 與 Equipment) 區分大小寫。
下列服務用於為使用者或使用者群組授予權限︰
服務
描述
GrantUserGroupPermissionsOnEntities
為指定使用者群組授予指定實體的指定權限 (Read、Write 或 None)。您可以針對相同的服務執行指定情境與設備實體。新增實體到 entities 資料負載，須提供下列資訊：
• Name - 情境或設備物件在 ThingWorx Composer 中顯示的名稱。
• Type - 輸入實體類型，Context 或 Equipment。
GrantUserPermissionsOnEntities
為指定使用者授予指定實體的指定權限 (Read、Write 或 None)。您可以針對相同的服務執行指定情境與設備實體。新增實體到 entities 資料負載，須提供下列資訊：
• Name - 情境或設備物件在 ThingWorx Composer 中顯示的名稱。
• Type - 輸入實體類型，Context 或 Equipment。
GrantPermissionsOnEntities
之前所列服務所使用的公用程式服務。不適用於獨立使用。
用於傳播權限的服務
下列服務可用於授予特定實體（設備）的權限，並將該權限傳播到某個情境的設備結構中的所有子項目。
此類服務中的權限類型值 (Read、Write 與 None) 區分大小寫。
服務
描述
PropagateUserGroupPermissionsOnEntities
為指定使用者群組授予指定情境中實體 (設備) 的指定權限 (Read、Write 或 None)。
• 如果 entityName 參數保留為空白，則會向指定使用者群組授予指定情境中所有設備的指定權限。
• 如果已為 entityName 參數指定實體，則會向指定使用者群組授予指定情境中該實體的指定權限，然後傳播到設備結構中該指定實體的所有子項目。
PropagateUserPermissionsOnEntities
為指定使用者授予指定情境中實體 (設備) 的指定權限(Read、Write 或 None)。
• 如果 entityName 參數保留為空白，則會向指定使用者授予指定情境中所有設備的指定權限。
• 如果已為 entityName 參數指定實體，則會向指定使用者授予指定情境中該實體的指定權限，然後傳播到設備結構中該指定實體的所有子項目。
PropagatePermissionsOnEntities
之前所列服務所使用的公用程式服務。不適用於獨立使用。
用於檢視權限設定的服務
下列服務可用於檢視目前的權限設定。
此類服務中的權限類型值 (Read、Write 與 None) 區分大小寫。
服務
描述
GetContextPermissionByUser
傳回指定使用者擁有權限的情境清單，包括權限類型 (Read 或 Write)。
GetContextPermissionByUserGroup
傳回指定使用者群組擁有權限的情境清單，包括權限類型 (Read 或 Write)。
GetContextsByUserAndPermission
傳回指定使用者擁有指定權限的情境清單 (Read 或 Write)，包括每個情境的詳細資訊。
GetEntityPermissionsByUserGroupOnContext
傳回指定使用者群組擁有權限的指定情境中的實體 (設備) 清單，包括各實體的權限類型 (Read 或 Write)。
GetEntityPermissionsByUserOnContext
傳回指定使用者擁有權限的指定情境中所有實體 (設備) 的清單，包括權限類型 (Read 或 Write)。
GetPermissionsByContext
針對指定的情境，傳回情境中所有實體 (設備) 的清單；對於每個實體，資料負載會顯示每個使用者與使用者群組對實體所擁有的權限 (Read、Write 或 None)。
GetContextPermission 和 GetEntityPermissionsOnContext
之前所列服務所使用的公用程式服務。不適用於獨立使用。