/
Business Service Web Services

Business Service Web Services

Owned by Stonebranch (Deactivated)
Last updated: Nov 11, 2024 by Alec Berger

Overview

Universal Controller supports the following RESTful-based web services for Business Service operations, which are listed alphabetically on this page.

Formatting specifications for each web service, including details about property requirements, are provided.

Create a Business Service


Description

URI

http://host_name/uc/resources/businessservice

HTTP Method

POST

Description

Creates a Business Service.

Example URI

http://localhost:8080/uc/resources/businessservice

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Create a Business Service: Example Request, below.

Business Service Properties

See Business Service Properties, below.

Example Response

  • Status 200 /OK
    Successfully created the Business Service with sysId {sysId}.

Create a Business Service: Example Request

XML Request

JSON Request

 XML Request
 <businessService retainSysIds="true">
	<description>1</description>
	<name>test</name>
	<sysId>e3a0d7b81f904c8fa4ae55cde6d58665</sysId>
</businessService>
 JSON Request
{
  "description": 1,
  "name": "test",
  "retainSysIds": true,
  "sysId": "e3a0d7b81f904c8fa4ae55cde6d58665"
}

Business Service: Properties

Property

UI Field Name

Description

Specifications

Required

description

Description

User-defined; description of this record.


N

exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read onlyN

exportTable

n/aRecord table information.read onlyN

name

Name

Name used within the Controller to identify this Business Service.

Maximum 40 alphanumerics.

Y

retainSysIds

n/a

Specification for whether or not the Create a Business Service web service will persist the sysId property.

  • If retainSysIds="true" and sysId is included in the request/response, sysId will be persisted to the database.
  • If retainSysIds="false" and sysId is included in the request/response, sysId will be ignored; it will be autogenerated by the Controller.

Note

In XML web services, retainSysIds is specified as an attribute in the <businessService> element.

Valid values: true/false (default is true).

N

sysId

n/a

System ID field in the database for this Business Service record.

Persisted only if retainSysIds is set to true.

N

Delete a Business Service


Description

URI

http://host_name/uc/resources/businessservice

HTTP Method

DELETE

Description

Deletes a Business Service.

URI Parameters

See Delete a Business Service: URI Parameters, below.

Example URI

http://localhost:8080/uc/resources/businessservice?busserviceid=77171434c0a801c9016d5b2b5d17ddee

Example Response

  • Status 200 /OK
    Business Service deleted successfully.
  • Status 400 /Bad Request
    Mutual exclusion violation. Cannot specify busservicename and bussserviceid at the same time.
  • Status 404 /Not Found
    A business service with {name/id} "test" does not exist.

Delete a Business Service: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

busserviceid

ID used within the Controller to identify this Business Service.

String; URI parameter.

Y
(unless busservicename
is specified)

busservicename

busservicename

Name used within the Controller to identify this Business Service.

String; URI parameter.

Y
(unless busserviceid
is specified)

busserviceid

List Business Services


Description

URI

http://host_name/uc/resources/businessservice/list

HTTP Method

GET

Description

Retrieves information on all Business Services.

Example URI

http://localhost:8080/uc/resources/businessservice/list

Authentication

HTTP Basic

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See List Business Services: Example Response, below.

Response Properties

See Business Service Properties.

List Business Services: Example Response

XML Request

JSON Request

 XML Request
<businessServices>
	<businessService exportReleaseLevel="7.2.0.0" exportTable="ops_generic group" version="1"> <description /> <name>bus service 1</name> <sysId>639d90bf8b61479191f46b1e524ac916</sysId> </businessService> <businessService exportReleaseLevel="7.2.0.0" exportTable="ops_generic group" version="4"> <description/> <name>bus service 2</name> <sysId>0ff4a7bafa0441a9b1a57b6451344ab6</sysId> </businessService> <businessService exportReleaseLevel="7.2.0.0" exportTable="ops_generic group"" version="1"> <description/> <name>bus service 3</name> <sysId>2822fa2848de438c97167bfa1d7a633c</sysId> </businessService> <businessService exportReleaseLevel="7.2.0.0" exportTable="ops_generic group" version="1"> <description/> <name>bus service 4</name> <sysId>ff4b77d628ae4bc78c78f383bf1265b0</sysId> </businessService> </businessServices>

 JSON Request
[
  {
  "description": null,
  "exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_generic_group",
"name": "bus service 1", "sysId": "639d90bf8b61479191f46b1e524ac916", "version": 1 }, { "description" " null,
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_generic_group",
"name": "bus service 2", "sysId": "0ff4a7bafa0441a9b1a57b6451344ab6", "version": 4 }, { "description": null,
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_generic_group",
"name": "bus service 3", "sysId": "2822fa2848de438c97167bfa1d7a633c", "version": 1 }, { "description": null,
"exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_generic_group",
"name": "bus service 4", "sysId": "ff4b77d628ae4bc78c78f383bf1265b0", "version": 1 } ]

Modify a Business Service


Description

URI

http://host_name/uc/resources/businessservice

HTTP Method

PUT

Description

Modifies the Business Service specified by the sysId.

Example URI

http://localhost:8080/uc/resources/businessservice

Consumes Content-Type

application/xml, application/json

Produces Content-Type

n/a

Example Request

See Modify a Business Service: Example Request, below.

Business Service Properties

See Business Service Properties.

Example Response

  • Status 200 /OK
    Successfully updated the business service with sysId <sysId> to version <version>.

Modify a Business Service: Example Request

XML Request

JSON Request

 XML Request
 <businessService>
	<description>1</description>
	<name>test</name>
	<sysId>e3a0d7b81f904c8fa4ae55cde6d58665</sysId>
</businessService>
 JSON Request
{
  "description": 1,
  "name": "test",
  "sysId": "e3a0d7b81f904c8fa4ae55cde6d58665"
}

Read a Business Service

URI

http://host_name/uc/resources/businessservice

HTTP Method

GET

Description

Retrieves information on a specific Business Service.

URI Parameters

See Read a Business Service: URI Parameters, below.

Example URI

Consumes Content-Type

n/a

Produces Content-Type

application/xml, application/json

Example Response

See Read a Business Service: Example Response, below.

Business Service Properties

See Business Service Properties.

Read a Business Service: URI Parameters

Parameter

Description

Specifications

Required

Mutually Exclusive With

busserviceid

ID used within the Controller to identify this Business Service.

String; URI parameter.

Y
(unless busservicename
is specified)

busservicename

busservicename

Name used within the Controller to identify this Business Service.

String; URI parameter.

Y
(unless busserviceid
is specified)

busserviceid

Read a Business Service: Example Response

The retainSysIds and version properties are specified as attributes in XML.

The exportReleaseLevel and exportTable properties are specified as attributes in XML.

XML Response

JSON Response

 XML Response
<businessService exportReleaseLevel="7.2.0.0" exportTable="ops_generic group" retainSysIds="true"version="1"> <description>1</description> <name>test</name> <sysId>e3a0d7b81f904c8fa4ae55cde6d58665</sysId> </businessService>
 JSON Response
{
  "description": 1,
  "exportReleaseLevel": "7.2.0.0",
"exportTable": "ops_generic_group",
"name": "test", "retainSysIds": true, "sysId": "e3a0d7b81f904c8fa4ae55cde6d58665", "version": 1 }

Related content

Credential Web Services
Credential Web Services
Universal Controller 7.7.x
Read with this
Business Service Web Services
Business Service Web Services
Universal Controller 7.6.x
More like this
Variable Web Services
Variable Web Services
Universal Controller 7.7.x
Read with this
Business Service Web Services
Business Service Web Services
Universal Controller 7.3.x
More like this
Business Service Web Services
Business Service Web Services
Universal Controller 7.2.x
More like this
Business Service Web Services
Business Service Web Services
Universal Controller 7.5.x
More like this