User (systemuser) Entity Capabilities
.gif "banner art") |
[Applies to: Microsoft Dynamics CRM 4.0]
Find the latest SDK documentation: CRM 2015 SDK
Managing users involves many different activities that include adding users, setting security roles, and placing users into a reporting hierarchy. Access to each of these features is protected by security privileges that the user has based on the user's security role. A user profile must first be created and saved before the user can be assigned security roles or associated with teams.
A Microsoft Dynamics CRM user account can be either Enabled or Disabled. Microsoft Dynamics CRM will allow only enabled users to log on to the application and each enabled user has a paid license. A user's account can be set to Disabled for keeping track of historical information, for example, for a salesperson who has left the company. Accounts can be set to Disabled to remove them from workflow processes, for example, if users are on vacation, or to remove them from the available license count. Disabled users do not count against paid licenses.
Note To create an instance of a systemuser entity in Microsoft Dynamics CRM, the user must first exist in Active Directory.
The class for this entity is systemuser. The following table describes the messages for users, to be used with the Execute method.
| Message | Description |
| Create | Use this message to create a system user.
The information that is needed to create the entity instance is specified in the TargetCreateSystemUser class. You can also call the Create method. |
| ReassignObjectsSystemUser | Use this message to reassign all entities owned by the specified user to another user. |
| Retrieve | Use this message to retrieve a system user.
The entity instance to retrieve is specified in the TargetRetrieveSystemUser class. You can also call the Retrieve method. |
| RetrieveAllChildUsersSystemUser | Use this message to retrieve the collection of users who report to the specified user. |
| RetrieveTeamsSystemUser | Use this message to retrieve the collection of teams of which the specified user is a member. |
| RetrieveUserSettingsSystemUser | Use this message to retrieve the user settings for the specified user. |
| SetBusinessSystemUser | Use this message to set the business unit for the specified user. |
| SetParentSystemUser | Use this message to set the parent (manager) for the specified user. |
| SetStateDynamicEntity | Use this message to set the state of a user using a DynamicEntity instance.
The possible states are defined in the SystemUserState enumeration. |
| SetStateSystemUser | Use this message to set the state of a user.
The possible states are defined in the SystemUserState enumeration. |
| Update | Use this message to update a system user.
The entity instance to update is specified in the TargetUpdateSystemUser class. You can also use the Update method. |
| UpdateUserSettingsSystemUser | Use this message to update the user settings for a system user. |
See Also
Concepts
Other Resources