This documentation is archived and is not being maintained.

User (systemuser) Entity Capabilities

Forefront
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.

MessageDescription
CreateUse 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.

ReassignObjectsSystemUserUse this message to reassign all entities owned by the specified user to another user.
RetrieveUse 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.

RetrieveAllChildUsersSystemUserUse this message to retrieve the collection of users who report to the specified user.
RetrieveTeamsSystemUserUse this message to retrieve the collection of teams of which the specified user is a member.
RetrieveUserSettingsSystemUserUse this message to retrieve the user settings for the specified user.
SetBusinessSystemUserUse this message to set the business unit for the specified user.
SetParentSystemUserUse this message to set the parent (manager) for the specified user.
SetStateDynamicEntityUse this message to set the state of a user using a DynamicEntity instance.

The possible states are defined in the SystemUserState enumeration.

SetStateSystemUserUse this message to set the state of a user.

The possible states are defined in the SystemUserState enumeration.

UpdateUse 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.

UpdateUserSettingsSystemUserUse this message to update the user settings for a system user.

See Also

Concepts

Other Resources


© 2010 Microsoft Corporation. All rights reserved.


Show: