Panel | ||||
---|---|---|---|---|
|
...
Universal Controller supports the following RESTful-based web services for User operations, which are listed alphabetically on this page.
- 63553454
- 63553454
- 63553454
- 63553454
- 63553454
- 63553454
- 63553454
- 63553454Create a User
- Delete a User
- List Users
- Modify a User
- Read a User
- Create Personal Access Token
- List Personal Access Tokens
- Revoke Personal Access Token
Formatting specifications for each web service, including details about parameter requirements, are provided.
...
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method | |
Description | Creates a new User. |
Example URI | http://localhost:8080/uc/resources/user |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example | See Create, Modify, and Read a User: XML and JSON Examples: XML and JSON Examples, below. |
User Properties | See 63553454 User Properties, below. |
User Permission Properties | See 63553454 User Permission Properties, below. |
User Role Properties | See 63553454 User Role Properties, below. |
Example Response |
|
...
Create, Modify, and Read a User: XML and JSON Examples
The excludeRelated and retainSysIds properties are specified as attributes in the <user> element of XML web services.
XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method | DELETE |
Description | Deletes a User. |
URI Parameters | See 63553454 Delete a User URI Parameters, below. |
Example URI | |
Example Response |
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/user/list |
HTTP Method | GET |
Description | Retrieves information on all Users. |
Example URI | http://localhost:8080/uc/resources/user/list http://localhost:9090/uc/resources/user/list?showTokens=true |
Authentication | HTTP Basic |
Produces Content-Type | application/xml, application/json |
Example | |
User Properties | See 63553454 User Properties. |
User Permission Properties | |
User Role Properties |
List Users: URI Parameters
...
XML | JSON | |||||
---|---|---|---|---|---|---|
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method | PUT |
Description | Modifies the User specified by the sysId in the request. |
Example URI | http://localhost:8080/uc/resources/user |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example | |
User Properties | See 63553454 User Properties. |
User Permission Properties | |
User Role Properties | |
Example Response |
|
...
Description | |
---|---|
URI | http://host_name/uc/resources/user |
HTTP Method | GET |
Description | Retrieves information on a specific User. |
URI Parameters | See Read a User: URI Parameters, below. |
Example URI | |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
User Properties | See 63553454 User Properties. |
User Permission Properties | |
User Role Properties | |
Example Response |
|
...
Property | UI Field Name | Description | Specifications | Required | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
active | Active | Specification for whether or not the user is active. An active user can log in to the Controller. An inactive user cannot log in to the Controller, and the user will not appear in user lists. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||||
browserAccess | Web Browser Access | Specification for whether or not the user can log in to the user interface. | Valid Values:
Default is – System Default – (0). | N | ||||||||||||||||
businessPhone | Business Phone | Business phone number of this user. | N | |||||||||||||||||
commandLineAccess | Command Line Access | Specification for whether or not the user can log in to the Universal Controller Command Line Interface (CLI). | Valid values:
Default is – System Default – (0). | N | ||||||||||||||||
department | Department | Business department of this user. | N | |||||||||||||||||
email | Email address of this user. | N | ||||||||||||||||||
excludeRelated | n/a | For the Modify User web service; specification for whether or not to exclude related records (User Permissions, User Roles) from the update, even if they are provided in the request.
| Valid values: true/false (default is false). | N | ||||||||||||||||
firstName | First Name | First Name of this user. | N | |||||||||||||||||
| Allowed Impersonation Users | Specifies the users that can be impersonated by this user using the X-Impersonate-User HTTP header on Web Service requests. User impersonation requires the ops_user_impersonate role. Users with the ops_admin role can impersonate any user and do not need to specify Allowed Impersonation Users. Format:
JSON
| N | |||||||||||||||||
lastName | Last Name | Last Name of this user. | N | |||||||||||||||||
lockedOut | Locked out | Specification for whether or not the user is locked out of the Controller. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||||
loginMethod | Login Methods | Login method(s) that the user can authenticate with. | Valid Values:
| N | ||||||||||||||||
manager | Manager | Business manager of this user. | Manager user ID | N | ||||||||||||||||
middleName | Middle Name | Middle Name of this user. | N | |||||||||||||||||
mobilePhone | Mobile Phone | Mobile phone number of this user. | N | |||||||||||||||||
passwordNeedsReset | Password Requires Reset | Specification for whether or not the user will be prompted to reset the password at next login. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||||
retainSysIds | n/a | Specification for whether or not the Create a User web service will persist the sysId property.
| Valid values: true/false (default is true). | N | ||||||||||||||||
sysId | n/a | System ID field in the database for this record. | Persisted only if retainSysIds is set to true. | N | ||||||||||||||||
timeZone | Time Zone | Time zone of this user. | When this user logs in, all scheduling times will be shown in the user's time zone, unless the trigger specifies a different time zone. | N | ||||||||||||||||
title | Title | Business title of this user. | N | |||||||||||||||||
tokens | Personal Access Tokens | List of personal access tokens. If Format:
JSON
| N | |||||||||||||||||
| n/a | Specifies whether the tokens will be displayed in the response. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||||
userName | User ID | Log in ID for this user. | Y | |||||||||||||||||
userPassword | Password | Password of this user. | Used only by the Create a User and Modify a User web services. | Y | ||||||||||||||||
webServiceAccess | Web Service Access | Specification for whether or not the user can log in to the Universal Controller RESTful Web Services API. | Valid values:
Default is – System Default – (0). | N |
...
Property | UI Field Name | Description | Specifications | Required | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
allGroups | Member of Any Business Service or Unassigned | Specification for whether or not this permission applies both to records that belong to any Business Service and to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
commands | Commands | Commands that are associated with each permission. | Valid values: see #Command Permissions, below. | N | ||||||||||||||
defaultGroup | Unassigned to Business Service | Specification for whether or not this permission applies to records that do not belong to any Business Service. | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
nameWildcard | Name | Specification to apply this permission to records whose name matches the string specified here. | Wildcards (*'s) can be used. | Y | ||||||||||||||
opCreate | Create | Allows the user to create records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opDelete | Delete | Allows the user to delete records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opExecute | Execute | Allows the user to execute records of the specified | Boolean. Valid Values: true/false. Default is false.
If the Strict Connection Execute Constraints Universal Controller system property is true:
| N | ||||||||||||||
opRead | Read | Allows the user to read records of the specified | Boolean. Valid Values: true/false. Default is false.
| N | ||||||||||||||
opUpdate | Update | Allows the user to update records of the specified | Boolean. Valid Values: true/false. Default is false. | N | ||||||||||||||
opswiseGroups | Member of Business Services | Applies this permission to records that are members of the selected Business Service(s).
| N | |||||||||||||||
permissionType | Type | Type of permission for this user. | Valid values:
| Y | ||||||||||||||
sysId | n/a | System ID field in the database for a record. | Persisted only if retainSysIds is set to true. | N |
...
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request | ||||||||||||
Example Response |
|
|
...
List Personal Access Tokens: Query Parameters
The following request parameters can be used to filter the results of this service.
Property | UI Field Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|---|
userid | N/A | UUID of the user | UUID of the user | N | username |
username | N/A | User Name | String value of User name | N | userid |
...
XML | JSON | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
...