Business Object Usage and Examples

The Cherwell REST API supports basic CRUD (create, read, update, and delete) operations on all Business Objects.

Usage: Field Identifiers

CSM field identifiers come in two forms:

  • Field identifiers for the main business object:

    BO:6dd53665c0c24cab86870a21cf6434ae,FI:c1e86f31eb2c4c5f8e8615a5189e9b19

  • Field Identifiers for mapped relational fields:

    FI:9397b3c0357e0678f9e3c94ce290e3783e4a61cabc,

    BO:9337c2311b8e8044aa3e2a48c4a95a9f5555815126,

    RE:9402756722d89a20ab008c41cc882fd219da37dc5f

Once a field has been created, its ID will not change.

Usage: Batch Operations

You can perform batch CRUD operations that allow you build up a collection of SaveRequests, ReadRequests or DeleteRequests on the client, and then send them as a batch to be processed on the server. This can greatly improve performance.

As batch operations are being processed, if one item in the batch fails to save, the entire batch stops processing if StopOnError is set to true. If StopOnError is set to false, the system will continue processing the remaining items in the batch.

When the system finishes processing the batch, a batch response is returned to the client. Inside of that object there is a collection of responses so you can determine if each batch operation failed or succeeded.

Usage: Creating and Updating Business Objects

Use these operations to create or update Business Objects:

  • savebusinessobject
  • savebusinessobjectbatch
  • saverelatedbusinessobjects

To create Business Objects, do not include a record ID or public ID in the request.

To update existing Business Objects, specify the record ID or public ID in the request. If duplicate public IDs exist, you must use the record ID.

Examples