UserTerritory

Represents a User who has been assigned to a Territory. For more information, see the “Territory Management Overview” topic in the Salesforce.com online help.

Supported Calls

create(), delete(), query(), retrieve(), getDeleted(), getUpdated(), describeSObjects()

Special Access Rules

Only available if territory management has been enabled for your organization.
Customer Portal users cannot access this object.

Fields

Field	Field Type	Field Properties	Description
IsActive	boolean	Defaulted on create Filter	Indicates whether the user is active in the given territory (`true`), or inactive in the given territory (`false`): Users who are active in a territory are explicitly assigned to the territory and can have open opportunities, closed opportunities, or no opportunities associated with that territory. Users who are inactive in a territory are not explicitly assigned to the territory, but own an open or closed opportunity that is associated with the territory. For example, a user may have been transferred out of a territory, but still own opportunities in his or her old territory. Until a user is deleted from a territory (not simply removed from the territory), the record will not be returned in a `getDeleted()` call.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the record has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
TerritoryId	reference	Create Filter	ID of the Territory to which the user has been assigned. For information on IDs, see ID Field Type.
UserId	reference	Create Filter	ID of the user.

Usage

If a user is inactive in a territory, and the opportunities they own that are associated with the territory are all closed, then the user is not returned.