Create Role
createRole
Given a RoleDetails object and optional company ID, this web service creates a user role on the Services Portal.
void createRole(String companyId, RoleDetails role) throws WSException
- companyId: (optional) A string of maximum length 10 that specifies the unique company identifier. If no company is specified, the company of the authorized user will be used.
- role: A RoleDetails object with the details for creating the user role.
Required elements:
- name
Optional elements:
- description
- capability - id - An array containing all capability IDs that should be associated with the role
Note: If either the 'Can use QTRACS' or 'Can use Trailer Tracks' capability is associated with the role, then the 'Can use GeoServices' capability will also be associated with the role.
Ignored elements:
- capability - applicationId
- capability - description
- capability - group
- capability - position
Authorization Requirements
The credentials supplied with this method call (as specified in the accompanying WS-Security header) must be authorized to the following application(s) and their associated role-based permissions.
Required Application Licenses
- Remote Integration
Required User Permissions
- Can maintain roles
Customer integrators are authorized to their own company's data only.
Sample XML Request
Only the SOAP body is shown. To see a sample SOAP Envelope and Header, click here.
|
Sample XML Response
|
Exceptions
001 Unknown Error.
003 Company not authorized for integration.
004 User not authorized.
005 Invalid company id.
006 Invalid role name.
007 Invalid role description.
008 Invalid capability id.