Newer Version Available

This content describes an older version of this product. View Latest

UserShare

Represents a sharing entry on a user record. This object is available in API version 26.0 and later.

This object is available through a pilot program. For more information on enabling this object for your organization, contact salesforce.com.

Note

Supported Calls

create(), delete(), describeSObjects(), query(), retrieve(), update(), upsert()

Special Access Rules

Customer Portal users can't access this object.

Fields

Field Details
IsActive
Type
boolean
Properties
Defaulted on create, Filter, Group, Sort
Description
Read-only. Indicates whether the User has access to log in (true) or not (false). You can modify a User's active status from the user interface or via the API.
RowCause
Type
picklist
Properties
Filter, Group, Restricted picklist, Sort
Description
Read-only. Reason that this sharing entry exists. Possible values include:
  • Manual Sharing—The User or Group has access to the user record because a User with “All” access manually shared the User with them.
  • Sharing Rule—The User or Group has access to the user record via a User sharing rule.
UserAccessLevel
Type
picklist
Properties
Create, Filter, Group, Restricted picklist, Sort, Update
Description
Level of access that the User or Group has to the specified user. The specified user is denoted by the UserId. The possible values are:
  • Read
  • Edit
This field must be set to an access level that is at least equal to the organization’s default UserAccessLevel.

UserAccessLevel can be updated only if RowCause is set to Manual Sharing.

UserId
Type
reference
Properties
Create, Filter, Group, Sort
Description
ID of the User being shared.
UserOrGroupId
Type
reference
Properties
Create, Filter, Group, Sort
Description
ID of the User or Group that has been given access to the User. This field can’t be updated.

Usage

This object allows you to determine which users and groups can view or edit User records owned by other users.