Skip to main content
Neurons for ITSM Actions

Link Business Objects

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

Written By Support Channel

Last updated Over 1 year ago

Overview of the Link Business Objects action

The Link Business Object action allows you to create a relationship between two business object records in Ivanti Neurons for ITSM using Link Business Objects API.

Purpose

Create a defined relationship between two records from one or more business objects within Ivanti Neurons for ITSM.

Parameters

1 Neurons for ISM Instance
1 Business Object
1 Relationship
1 Parent Business Object Unique ID
1 Child Business Object Unique ID

Output

None

Understanding the Link Business Objects action

The Link Business Object action is used to associate two records in Ivanti Neurons for ITSM, allowing you to build relationships such as parent-child connections between business objects. This is used to connect related items, such as linking an Incident to a Problem or associating a Task with a Change Request.

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

Relationship

The name of the relationship as defined in the Ivanti environment.

Parent Business Object Unique Id

The unique identifier of the parent record the action will link to. (RecId)

Child Business Object Unique Id

The unique identifier of the child record the action will link to. (RecId)

Working with Link Business Objects action

The Link Business Objects action is useful for creating relationships between two records within Ivanti Neurons for ITSM, such as linking tasks to a change request.

Create and manage Link Business Objects actions

Add a Link Business Objects action

Add the action

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

  1. Click the ‘plus’ symbol on the workflow path at the point you want to insert the action. This opens the action menu slide-over.

  2. Either:

    • Search for the action using the Search field above the actions in the menu.

    • Locate a Recently Used action in the top section of the menu.

    • Navigate to the action within menu: Core actions are listed under Actions, while Plugin actions are contained within their associated integration.

  3. Select the desired action to insert it. This reveals the action’s configuration panel.

  4. Use the Name field to name the action. This can help users to understand your workflow at a glance. (optional)

  5. Use the Description field to add information describing the action. This can help users wanting to understand how your workflow functions (optional).

Configure the action

Use the following steps to configure the action.

  1. Set values for the Neurons for ISM System, Business Object, Relationship, Parent Business Object Unique Id and Child Business Object Unique Id.

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

Delete a Link Business Objects action

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

  1. Access the workflow in draft mode to edit it.

  2. Either:

    • hover your mouse cursor over the action, and then click the red cross that appears over the top-right corner of the action to delete it. Or:

    • click on the action to open the action slide-over. Click the red 'Delete Step’ button to remove the action from your workflow.

  3. Click Publish in the top-right to commit your changes.

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.

Was this helpful?

Still need help? Share an idea