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 |