Newer Version Available

This content describes an older version of this product. View Latest

SearchResultActionConfig

Represents a collection of fields to set up the actions that a user can perform on results returned by criteria-based search.

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

Important

Parent Type

This type extends the Metadata metadata type and inherits its fullName field.

File Suffix and Directory Location

SearchResultActionConfig components have the suffix .SearchResultActionConfigSettings and are stored in the SearchResultActionConfigSettings folder.

Version

SearchResultActionConfig components are available in API version 59.0 and later.

Special Access Rules

This type is available if Criteria-Based Search and Filter is enabled in your org.

Fields

Field Name Description
actionReference
Field Type
string
Description

Required.

The action that a user can launch for a search result. Specify the ID of an instance that corresponds to your action type.

actionScope
Field Type
SearchResultActionScope (enumeration of type string)
Description

Required.

Specifies the scope of the action that the user can launch. For example, select Global to apply the action to all record types in the search result.

Values are:

  • Global
actionType
Field Type
SearchResultActionType (enumeration of type string)
Description

Required.

Specifies the type of action that a user can launch.

Values are:

  • FlowDefinition
  • LightningWebComponent
  • OmniScript—Available in API version 60.0 and later.
description
Field Type
string
Description
The description of the search result action configuration.
masterLabel
Field Type
string
Description

Required.

The name of the action that's displayed in the search page.

Declarative Metadata Sample Definition

The following is an example of a SearchResultActionConfig component.

1<?xml version="1.0" encoding="UTF-8"?>
2<SearchResultActionConfig xmlns="http://soap.sforce.com/2006/04/metadata">
3    <actionReference>setup_service_experience__Create_Case</actionReference>
4    <actionScope>Global</actionScope>
5    <actionType>FlowDefinition</actionType>
6    <description>Screen flow to create a case.</description>
7    <masterLabel>Create a Case</masterLabel>
8</SearchResultActionConfig>

The following is an example package.xml that references the previous definition.

1<?xml version="1.0" encoding="UTF-8"?>
2<Package xmlns="http://soap.sforce.com/2006/04/metadata">
3    <types>
4        <members>*</members>
5        <name>SearchResultActionConfig</name>
6    </types>
7    <version>64.0</version>
8</Package>

Wildcard Support in the Manifest File

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.