ResourceRole

IMPORTANT  The SOAP API entered a limited enhancement phase in Q4 2020. Access to version 1.6 will be deactivated.

This query only entity describes Resources' associations to Department/ Role relationships, service desk queues, and service desk roles.. A resource must be assigned to at least one role. Resources are assigned to one or more roles through their department and can be assigned service desk roles. Resources can also be assigned to service desk queues.

NOTE  An assigned role is no longer required for queue associations.

A role is required when a resource is assigned to a ticket or task. The role rate dictates the base rate for work the resource performs on that task or ticket.

The role associations described by this entity each have their own entities: ResourceRoleDepartment, ResourceRoleQueue, and ResourceServiceDeskRole. These entities can be queried, created, and updated via the API.

Entity details

You can also retrieve this information with the Web Services API call The getEntityInfo() SOAP API call.

Entity Name: ResourceRole
Can Create:  
Can Update:  
Can Query:
Can Delete:  
Can Have UDFs:  

Conditions and requirements

  • On query, only Active ResourceRoles (Active = True) are returned.

Role definitions

Role ID Definition
110 Time sheet approval
112 Expense approval

Field definitions

The following table describes the standard Autotask field objects for this entity.

  • To retrieve more detailed information specific to a particular Autotask implementation, use the Web Services API call The getFieldInfo() SOAP API call.
  • For information on entity UDFs, use getUDFInfo().
  • For String datatypes, the number in parentheses ( ) indicates the maximum number of characters allowed.
  • LT indicates Local Term.

For more information about fields marked as picklists, review our Understanding picklists article.

Field Name Label Datatype Read Only Is Required Reference Name Picklist
Active Active boolean      
DepartmentID Department long   Department  
id ID long    
QueueID Queue long    
ResourceID Resource long Resource  
RoleID Role long Role