Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

...


Description

URI

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 Web Services#Business Service Properties, below.

Example Response

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

...

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

Property

UI Field Name

Description

Specifications

Required

Anchor
description - CBS
description - CBS
description

Description

User-defined; description of this record.


N

Anchor
exportReleaseLevel - CBS
exportReleaseLevel - CBS
exportReleaseLevel

n/a

Universal Controller release that the record was exported from.

read onlyN

Anchor
exportTable - CBS
exportTable - CBS
exportTable

n/aRecord table information.read onlyN

Anchor
name - CBS
name - CBS
name

Name

Name used within the Controller to identify this Business Service.

Maximum 40 alphanumerics.

Y

Anchor
retainSysIds - CBS
retainSysIds - CBS
retainSysIds

n/a

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

Html bobswift
Note
titleNote

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


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

N

Anchor
sysId - CBS
sysId - CBS
sysId

n/a

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

Persisted only if retainSysIds is set to true.

N

...


Description

URI

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 Web Services#Business Service Properties.

Anchor
List Business Services Example Response
List Business Services Example Response
List Business Services: Example Response

...


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 Web Services#Business Service Properties.

Example Response

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

...

URI

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 Web Services#Business Service Properties.

Anchor
Read a Business Service URI Parameters
Read a Business Service URI Parameters
Read a Business Service: URI Parameters

...