Get Business Objects

Reference documentation for using the Ivanti Neurons for ITSM Get Business Objects action

Written By Support Channel

Last updated 8 months ago

Overview of the Get Business Objects action

The Get Business Objects action allows you to retrieve a selection of records from a business object in Ivanti Neurons for ITSM using its filter options with the Get Business Objects API.

Purpose	To fetch JSON records from a specified business object within Ivanti Neurons for ITSM using search, filter, and sort options.
Parameters	1 Neurons for ISM Instance 1 Business Object Name 1 Search Term (optional) 1 Filter Query (optional) 1 Sort By Field (optional) 1 First Record Index (optional) 1 Number of Records to Return (optional)
Output	JSON Array, where each element contains record data

Understanding the Get Business Objects action

The Get Business Objects action is used to retrieve one or more records from a specific business object in Ivanti Neurons for ITSM, such as incidents, knowledge articles, or employees. The action supports search terms, filters, sorting, and record limits to help you control exactly what data is returned.

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

Search (optional)
A keyword or phrase used to narrow results by matching against common fields like title or number.

Filter (optional)
A more specific way to control what is returned. Use OData style syntax, for example CountHelpful eq 50 or Status eq 'Active'.

Sort By (optional)
Choose a field to sort the returned records by. For example CreatedDateTime or Title.

First Record (optional)
Sets the starting point of the result set. For example if you want to skip the first few records and start at the 5th result, enter 5.

Number of Records (optional)
Limits how many records are returned. By default the query will return up to 25 records with a max of 100

Working with Get Business Objects action

The Get Business Objects action is one of the main ways used to retrieve data from Ivanti Neurons for ITSM to drive decisions and actions in your workflow.

For example, this action allows you to dynamically access records from business objects such as Incidents, Service Requests, or Change objects. The action allows you to use search terms, filters, and sorting logic that you define to retrieve appropriate records.

Once retrieved, related records can be looped over using a For Each action or passed into a card carousel, a message, or any other action that supports this data.

Create and manage Get Business Objects actions

Add a Get Business Objects 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.

Set values for the Neurons for ISM System, Business Object, Search, Filter, Sort By, First Record and Number of Records.
Click back in the main view to hide the slide-over.

Delete a Get Business Objects 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.