Go to Record Quick Action (CAD)

4 min

Graphical Action Designer: Go to Record Quick Action (GAD)

About the Go to Record Quick Action

To use this Quick Action, set the global constant EnableActionService to True. If EnableActionService is not available in the global constants list (this may be the case for upgraded instances), Administrators can manually add the constant.

The Go to Record Quick Action allows ITSM to switch context between records in a business object based on input criteria. Subsequent actions can then be performed on the destination record.

The input criteria can come from a webhook, from another action, or from the field value of the current record This action can be used standalone or with other actions.

There is an option for the action to create a new record if not found without it throwing an error or the user having to make amendments.

Suggestions for Use

Here are a few ways you can use the Go To Record Quick Action:

Updating a field on an Incident: Going to a related Incident, for example, a parent/master incident, and updating more fields there, without the use of the Run for Child Quick Action.

Navigating to records outside of UI contexts: For example, when you send data to a webhook the system has no way of knowing which record to run against because you aren’t selecting anything in the UI. This allows you to use webhooks for scenarios beyond simple record creation; for example, you could specify a value within the webhook data that contains the unique identifier for an existing record, then use the Go to Record Quick Action to actually navigate to that record and update it.

Using with the Run for Collection Quick Action: Specify a JSON or XML collection of records to update, where each entry has a unique identifier for a different record. Use the Run for Collection Quick Action and the Go to Record Quick Action together to iterate over the collection, go to the record for each item in the collection, and perform some action on the record before proceeding to the next.

Creating actions with more complex logic than has been possible in the past: The most common example of this is “I want to update a record if it exists, or create it if it doesn’t”. You can easily use the Go to Record Quick Action to navigate to an existing record, but also use the Create Record if not Found option to create the record if it doesn’t exist. A real-world example is that of a customer using the CI business object and an external system which sends data about these CI records to ITSM. Using the Go to Record Quick Action, incoming CI data can be used to update existing records, but if the external system finds some new CI and sends that as part of the data, the Create Record if not Found option automatically creates a record in ITSM for the new item.

Parameters

Field	Parameter
Enter action name	A unique name for the action.
Enter action description	Optional. Enter a plain-text description of what the action does.
Business object	The business object to use with this action. The fields that appear are based on the business object. At present, your choice of business object is fixed so you can only use the current business object associated with the Go To Record action. Hence you can only go to records for that one business object.
Field Name	The field name that is used as part of the input criteria for finding the record to go to. Only unique field names are included in the drop-down list.
Field Value	The value that is used as as part of the input criteria for finding the record to go to. There must be only one record with this value as multiple records cannot be used when using Go To Record.
Create a new record if not found	When switching records, if a record cannot be found that fulfils the input criteria, select this option to create a new one automatically. When this option is selected, new fields appear below this option for you to add values for populating the new record. When the new record is created, the field values you previously entered for all the required and unique fields are auto-populated and the record is validated. It will look something like this: If you select the option for Create a new Record if not found but don't enter any values, you get an error message saying that field data is missing.

Actions

Button	Action
	Adds a field to the list.
	Removes a field from the list.
Save	Commits your settings.
Cancel	Exits without saving.