角色 (安全性角色) 實體訊息和方法

 

發行︰ 2017年1月

適用於： Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

角色代表安全性權限群組。 使用者會擁有授與其 Microsoft Dynamics 365 存取權的指派角色。 此實體的結構描述名稱為 Role。若要檢視組織的實體中繼資料，請安裝瀏覽組織的中繼資料中敘述的中繼資料瀏覽器解決方案。 您也可以下載 SDK 後開啟其頂層資料夾內所附名為 EntityMetadata.xlsx 的 Excel 檔案，從中檢視未經自訂組織的中繼資料。

下表說明此實體的訊息，可用於 IOrganizationService.Execute 方法。

訊息	描述
AddPrivilegesRoleRequest	新增一組現有權限至現有的角色。
AssociateRequest	在記錄與一個或多個參與關聯的其他記錄之間建立連結。您也可以使用 IOrganizationService.Associate 方法。如需詳細資訊，請參閱8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords。如需此實體的預設關聯清單，請參閱 Role 實體中繼資料。您可以在組織的中繼資料中找到這項資訊。 請參閱先前的中繼資料瀏覽器資訊。
CreateRequest	建立角色。 您也可以呼叫 IOrganizationService.Create 方法。
DeleteRequest	刪除角色。 您也可以呼叫 IOrganizationService.Delete 方法。
DisassociateRequest	移除記錄與一個或多個參與關聯之其他記錄間的連結。您也可以使用 IOrganizationService.Disassociate 方法。如需詳細資訊，請參閱8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords。如需此實體的預設關聯清單，請參閱 Role 實體中繼資料。您可以在組織的中繼資料中找到這項資訊。 請參閱先前的中繼資料瀏覽器資訊。
InitializeFromRequest	從現有記錄初始化新的記錄，前提是已定義兩個實體的屬性對應。 如需詳細資訊，請參閱自訂實體和屬性對應。
RemovePrivilegeRoleRequest	移除角色的權限
ReplacePrivilegesRoleRequest	取代現有角色的權限集合。 如此可以有效刪除所有角色的現有權限，並新增指定權限。
RetrieveDuplicatesRequest	偵測及擷取指定之記錄的重複記錄，前提是重複資料偵測已啟用，而且有實體的已發行重複資料偵測規則。 如需詳細資訊，請參閱偵測重複資料。
RetrieveRequest	擷取角色。 您也可以呼叫 IOrganizationService.Retrieve 方法。
RetrieveMultipleRequest	擷取角色的集合。 您也可以呼叫 IOrganizationService.RetrieveMultiple 方法。
RetrieveRolePrivilegesRoleRequest	擷取指派給指定的角色使用權限。
UpdateRequest	更新角色。 您也可以呼叫 IOrganizationService.Update 方法。

另請參閱

角色型安全性如何用於控制 Microsoft Dynamics 365 實體的存取
權限與角色實體
Privilege 實體訊息和方法
依實體排列的權限

Microsoft Dynamics 365

© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權