SystemUser（用户）实体消息和方法

 

发布日期： 2017年1月

适用于： Dynamics 365 (online),Dynamics 365 (on-premises),Dynamics CRM 2016,Dynamics CRM Online

系统用户是有权登录本地 Microsoft Dynamics 365 或 Microsoft Dynamics 365 (online) 的人员。 管理系统用户涉及到许多不同的活动。 其中包括添加系统用户、设置安全角色以及将系统用户放到报告层次结构中。 对这些功能中每种功能的访问都受到系统用户所具有的安全特权的保护。 这些特权基于系统用户的安全角色。 必须首先创建并保存系统用户配置文件，才能为系统用户分派安全角色或将用户与团队相关联。 此实体的架构名称为 SystemUser。若要查看您的组织的实体元数据，请安装浏览组织的元数据中描述的元数据浏览器解决方案。 您还可以在一个名为 EntityMetadata.xlsx 的 Excel 文件中查看非自定义组织的元数据，该文件包含在 SDK 下载的顶级文件夹中。

A Dynamics 365 系统用户帐户可以已启用或已禁用。Dynamics 365 仅允许拥有付费许可证的已启用系统用户登录应用程序。

可以将已启用系统用户的帐户设置为禁用以保留历史信息，例如已离开公司的销售员的帐户。 将系统用户帐户设置为禁用状态可以将该用户从工作流程中删除，例如在假期期间。 禁用系统用户后可用许可证计数会增加，这是因为禁用的系统用户不会占用付费许可证。

备注

若要在内部部署 Microsoft Dynamics 365 中创建系统用户实体的实例，系统用户必须首先存在于 Active Directory 中。

要在 Microsoft Dynamics 365 (online) 中创建“系统用户”实体的实例，该用户的 Microsoft 帐户 必须已经存在。 此外，无法通过编程方式向 Microsoft Dynamics 365 (online) 用户发送邀请。 必须通过 Web 应用程序发送用户邀请。

下表描述了此实体的消息，这些消息可与 IOrganizationService.Execute 方法结合使用。

消息	说明
AssociateRequest	在某条记录与参与某关系的一条或多条记录之间创建链接。也可以使用 IOrganizationService.Associate 方法。有关详细信息，请参阅8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords。 有关此实体的默认关系列表，请参阅 SystemUser 实体元数据。您可以在您组织的元数据中查找此信息。 请参阅前面的元数据浏览器信息。
CreateRequest	创建系统用户。 还可以调用 IOrganizationService.Create 方法。
DisassociateRequest	删除某条记录与参与某关系的一条或多条记录之间的链接。也可以使用 IOrganizationService.Disassociate 方法。有关详细信息，请参阅8597998f-764f-4c73-b63d-9f5e02c78061#ActionsOnEntityRecords。 有关此实体的默认关系列表，请参阅 SystemUser 实体元数据。您可以在您组织的元数据中查找此信息。 请参阅前面的元数据浏览器信息。
InitializeFromRequest	根据现有记录初始化一条新记录，条件是为这两个实体定义了属性映射。 有关详细信息，请参阅自定义实体和属性映射。
RetrieveDuplicatesRequest	检测并检索指定记录的重复记录，前提是启用了重复检测，并且已为此实体发布了重复检测规则。 有关详细信息，请参阅检测重复数据。
ReassignObjectsSystemUserRequest	将指定系统用户负责的所有实体重新分派给其他系统用户或团队。
RetrieveRequest	检索系统用户。 还可以调用 IOrganizationService.Retrieve 方法。
RemoveParentRequest	删除记录的上级。
RetrieveAllChildUsersSystemUserRequest	检索向指定系统用户进行报告的系统用户的集合。
RetrieveMultipleRequest	检索系统用户的集合。 还可以调用 IOrganizationService.RetrieveMultiple 方法。
RetrievePrincipalAttributePrivilegesRequest	检索用户或团队通过与 FieldSecurityProfile 实体的直接或间接（通过团队成员资格）关联而拥有的所有安全属性特权。
RetrieveTeamsSystemUserRequest	已弃用。 请使用 RetrieveMultipleRequest 类。 检索指定系统用户所属的团队的集合。
RetrieveUserPrivilegesRequest	检索系统用户（用户）通过其在指定业务部门中的角色而拥有的所有特权。
RetrieveUserSettingsSystemUserRequest	已弃用。 请使用 RetrieveMultipleRequest 类。 检索指定系统用户的系统用户设置。
SetBusinessSystemUserRequest	设置指定系统用户的业务部门。
SetParentSystemUserRequest	设置指定系统用户的上级（经理）。
SetStateRequest	设置系统用户的状态。 可能的状态在 SystemUser.Statecode 属性中定义。 如果您使用了早期的绑定类型，请使用 SystemUserState 枚举。 有关状态值的列表，请参阅 SystemUser 实体元数据。您可以在您组织的元数据中查找此信息。 请参阅前面的元数据浏览器信息。
UpdateRequest	更新系统用户。 还可以调用 IOrganizationService.Update 方法。
UpdateUserSettingsSystemUserRequest	已弃用。 请使用 UpdateRequest 类。 更新系统用户的系统用户设置。

另请参阅

用户和团队实体
实体特权
UserSettings 实体消息和方法

Microsoft Dynamics 365

© 2017 Microsoft。 保留所有权利。 版权