...
Universal Controller supports the following RESTful-based web services for Variable operations, which are listed alphabetically on this page.
- Create a Global Variable
- Delete a Global Variable
- List Variables
- List Variables - Advanced
- Modify a Global Variable
- Read a Global Variable
- Set Variable63553556
- 63553556
- 63553556
- 63553556
- 63553556
- 63553556
- 63553556
Formatting specifications for each web service, including details about parameter requirements, are provided.
Anchor | ||||
---|---|---|---|---|
|
Create a Global Variable
Description | |
---|---|
URI | http://host_name/uc/resources/variable |
HTTP Method | POST |
Description | Creates a Global Variable. |
Example URI | http://localhost:8080/uc/resources/variable |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example Request | See Create a Global Variable: Example Request, below. |
Request Properties | See Global Variable Properties 63553556, below. |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Create a Global Variable: Example Request
XML Request | JSON Request | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Global Variable Properties
Property | UI Field Name | Description | Specifications | Required | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
description | Description | User-defined; description of this record. | N | |||||||||||||||
name | Name | Name used within the Controller to identify this Global Variable. | Contains a maximum of 40 alphanumerics. | Y | ||||||||||||||
opswiseGroups | Member of Business Services | Business Services that this record belongs to.
| N | |||||||||||||||
| n/a | Specification for whether or not the Create a Create a Global Variable 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 a record. | Persisted only if retainSysIds is set to true. | N | ||||||||||||||
value | Value | Value of this variable. | Maximum = 25000 characters. | N |
Anchor | ||||
---|---|---|---|---|
|
Delete a Global Variable
Description | |
---|---|
URI | http://host_name/uc/resources/variable |
HTTP Method | DELETE |
Description | Deletes a Global Variable. |
URI Parameters | See Delete a Global Variable: URI Parameters, below. |
Example URI | http://localhost:8080/uc/resources/variable?variableid=dadf6b84c0a8016500a01a10da5e2c15 |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Delete a Global Variable: URI Parameters
Parameter | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| ID used within the Controller to identify this Global Variable. | String; URI parameter. | Y (unless |
|
| Name used within the Controller to identify this Global Variable. | String; URI parameter. | Y (unless |
|
Anchor | ||||
---|---|---|---|---|
|
List Variables
Description | |
---|---|
URI | http://host_name/uc/resources/variable/list |
HTTP Method | POST |
Description | Retrieves information on variables matching specific search criteria. |
Example URI | http://localhost:8080/uc/resources/variable/list |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Request Properties | |
Example Response | |
Response Properties |
Anchor | ||||
---|---|---|---|---|
|
List Variables: XML and JSON Examples
Examples | XML | JSON | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Example Request |
|
| ||||||||||
Example Response |
|
|
Anchor | ||||
---|---|---|---|---|
|
List Variables: Request Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
scope | n/a | Type of variable to be returned in the Response. | Valid values (case insensitive):
Default is global. | N | ||||||
taskName | n/a | If | Y | |||||||
triggerName | n/a | If | Y | |||||||
variableName | n/a | If | Wildcards are supported. | N |
Anchor | ||||
---|---|---|---|---|
|
List Variables: Response Properties
Property | UI Field Name | Description | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
description | Description | Description of the variable. | ||||||||||||||||||
name | Name | Name of the variable. | ||||||||||||||||||
sysId | n/a | sys_id used within the Controller to identify this variable. | ||||||||||||||||||
taskId | n/a | ID of the task if the search was for a task-specific variable ( | ||||||||||||||||||
taskName | n/a | Name of the task if the search was for a task-specific variable ( | ||||||||||||||||||
triggerId | n/a | ID of the trigger if the search was for a trigger-specific variable ( | ||||||||||||||||||
triggerName | n/a | Name of the trigger if the search was for a trigger-specific variable ( | ||||||||||||||||||
type | n/a | Type of variable. | ||||||||||||||||||
value | Value | Value of the variable. | ||||||||||||||||||
version | Version | Version of the variable. | ||||||||||||||||||
| Value Options | Not for Global Variables.
| ||||||||||||||||||
| Allow Empty Option | Not for Global Variables.
| ||||||||||||||||||
| Allow Unlisted Option | Not for Global Variables.
|
Anchor | ||||
---|---|---|---|---|
|
List Variables - Advanced
List Variables - Advanced support filtering results using business services that the variables belongs to. It is only applicable for global and local scope variables.
...
Description | |
---|---|
URI | http://host_name/uc/resources/variable/listadv |
HTTP Method | GET |
Description | Retrieves variables details using specific query parameters. |
Example URI |
|
Authentication | HTTP Basic |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
URI Properties | |
Example Response |
Anchor | ||||
---|---|---|---|---|
|
List Variables - Advanced: URI Parameters
Parameter | Description | Specifications | Required | |
---|---|---|---|---|
| n/a | Business Services that this Variable belongs to. | String value of comma separated business service | N |
| n/a | Type of variable to be returned in the Response. | Valid values (case insensitive):
Default is global. | N |
| n/a | If scope is task; Name of task. | Y (if | |
| n/a | If scope is trigger; Name of the trigger. | Y (if | |
| n/a |
| Wildcards are supported. | N |
Anchor | ||||
---|---|---|---|---|
|
List Variables - Advanced: Example Response
XML Response | JSON Response | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Modify a Global Variable
Description | |
---|---|
URI | http://host_name/uc/resources/variable |
HTTP Method | PUT |
Description | Modifies the Global Variable specified by the |
Example URI | http://localhost:8080/uc/resources/variable |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example Request | See Modify a Global Variable: Example Request, below. |
Request Properties | |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Modify a Global Variable: Example Request
XML Request | JSON Request | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Read a Global Variable
Description | |
---|---|
URI | http://host_name/uc/resources/variable |
HTTP Method | GET |
Description | Retrieves information on a specific Global Variable. |
URI Parameters | See Read a Global Variable: URI Parameters, below. |
Example URI | http://localhost:8080/uc/resources/variable?variablename=demo_ops_global |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example Response | See Read a Global Variable: Example Response , below. |
Response Properties |
Anchor | ||||
---|---|---|---|---|
|
Read a Global Variable: URI Parameters
Name | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| Unique ID for this Global Variable. | Y |
| |
| Name used within the Controller to identify this Global Variable. | Maximum 40 alphanumerics. | Y |
|
Anchor | ||||
---|---|---|---|---|
|
Read a Global Variable: Example Response
XML Response | JSON Response | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Set Variable
Description | |
---|---|
URI | http://host_name/uc/resources/variable/ops-variable-set |
HTTP Method | POST |
Description | Sets the specified variable. |
Example URI | http://localhost:8080/uc/resources/variable/ops-variable-set |
Authentication | HTTP Basic |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | application/xml, application/json |
Example Request | |
Example Response | |
Properties |
Anchor | ||||
---|---|---|---|---|
|
Set Variable: Request Examples
XML Request | JSON Request | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Set Variable: Response Examples
XML Response | JSON Response | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Set Variable Properties
Property | UI Field Name | Description | Specifications | Required | ||||||
---|---|---|---|---|---|---|---|---|---|---|
create | n/a | Specification for whether or not to create a variable. | Boolean; Valid values: true/false. | N | ||||||
description | Description | Description of the variable. | N | |||||||
exportReleaseLevel | n/a | Universal Controller release that the record was exported from. | read only | N | ||||||
exportTable | n/a | Record table information. | read only | N | ||||||
name | Name | Name of the variable. | Y | |||||||
scope | n/a | Type of variable to be returned in the XML Response. | Valid values: global, task, trigger (case insensitive). Default is global. | N | ||||||
task | n/a | If | Y | |||||||
trigger | n/a | If | Y | |||||||
value | Value | Value of the variable. | Maximum = 25000 characters. | Y |
...