Skip to main content

Update Business Object

Description

Ivanti Service Manager: Update Business Object step, updates a business object record in Ivanti Service Manager.

Limitation

The service request business object record cannot be updated using this plugin step since there is a different API endpoint provided to update service request.

References

  • Documentation for creating an API Key: https://help.ivanti.com/ht/help/en_US/ISM/2021/admin/Content/Configure/API/Using-REST-API-Key.htm
  • API documentation: https://help.ivanti.com/ht/help/en_US/ISM/2021/admin/Content/Configure/API/Update-a-Business-Object.htm

Configurations

No.Field NameDescription
1Step nameName of the step as it appears in the workflow workspace. This name has to be unique in a single workflow.
Connection
2Tenant URLTenant URL of Ivanti Service Manager instance.
The data type is String. This field is mandatory.
3API KeySpecify or select API Key generated for the tenant.,
If checkbox above is enabled API Key field appears as Text box and accepts static values or variables. Else if checkbox above is disabled API Key field appears as a drop down containing values from previous steps to select from.
The data type is String. This field is mandatory.
Input Fields
1Business ObjectSpecify the internal name of the Business Object for which record is to be updated.The data type is String. This field is mandatory.
Note: Locate the internal name using the following steps:
i. Click on Settings icon at the right uppermost corner.
ii. Select Business Objects under Build option.
iii. In the Find box, type the display name of the Business Object and you can see the internal name enclosed in the bracket just under Display Name.
2Rec IDSelect the Rec ID of the record to be updated.
Button: GetClick to get the list of record IDs.
3Accept Fields As JSONSelect the checkbox, to use the JSON field as an input to build JSON. If it is not selected, use the table input to build the JSON.
4JSONSelect the JSON in a valid format to update a record. For sample JSON, see Sample.
Note: This field is available only if Accept Fields As JSON checkbox is selected. If this field is available then it is a mandatory field.
Table FieldsThe table fields are available only if Accept Fields As JSON checkbox is not selected.
1Variable Field NameSelect the field name as a field or variable. This is an optional field.
2Static Field NameOn clicking the cell in the input table, fields associated with the business object will get populated.
3Field ValueSelect valid values for the field associated with the field name.

Sample

{"Category":"Compute","CreatedBy":"Admin","Description":"Test","Owner":"Andrew I. Smythe","OwnerTeam":”Application Development”,"TypeOfChange":”minor”,"Subject:”Test Record”}