Update Business Object

Reference documentation for using the Ivanti Neurons for ITSM Update a Business Object action

Written By Support Channel

Last updated 8 months ago

Overview of the Update Business Object action

The Update Business Object action allows you to modify an existing record within Ivanti Neurons for ITSM using the Update a Business Object API.

Purpose

Create a new record of a selected business object within Ivanti Neurons for ITSM using specified field values.

Parameters

1 Neurons for ISM Instance
1 Business Object
Field Values

Output

Business Object

Understanding the Update Business Object action

The Update Business Object action is used to update existing records in Ivanti Neurons for ITSM by specifying the RecId of the target record and providing new values for its fields.

Neurons for ISM System

Select the Ivanti Neurons for ITSM system that the schema will be retrieved from.

Business Object

Specify the exact name of the business object. For example: Incident

Field Values

A list of field names and values to assign. These must match the field definitions in the selected business object. For example:

  • Subject: "I need help with my laptop"

  • Symptom: "my laptop does not turn on"

  • Status: "Active”

Unique Key

The unique identifier (GUID) of the record to update. This can be retrieved from previous steps in the workflow or hard set values.

Working with Update Business Object action

The values passed into the field mapping must match the data types and requirements of the business object schema. For example, link fields must use RecIDs, the type of picklists must match the type of configured values, and required fields must be populated to prevent creation errors.

Create and manage Update Business Object actions

Add a Update Business Object action

Add the action

Use the following steps to add the action to a workflow.

Configure the action

Use the following steps to configure the action.

  1. Set values for the Neurons for ISM System and Business Object.

  2. Click Add Fields to add a new field value.

  3. Select Field Name and give it a value in the Right field. This can be a simple value such as a Number or Text string, or it can be the return value of an expression.

  4. Click OK to complete setup of your new field value.

  5. Click back in the main view to hide the slide-over.

Delete a Update Business Object action

Use the following steps to remove the action from your workflow:

Take care when deleting an action to also remove any logic using its outputs: workflow steps may function incorrectly or break if they attempt to evaluate an output of a deleted action.