DecisionMatrixDefinition

Represents a definition of a decision matrix.

Before deploying a decision matrix or a decision matrix version to a target org, review these decision matrix migration considerations.

Note

Parent Type 

This type extends Metadata and inherits its fields.

File Suffix and Directory Location 

DecisionMatrixDefinition components have the suffix .decisionMatrixDefinition and are stored in the decisionMatrixDefinition folder.

Version 

Introduced in API version 55.0.

Fields 

description 

  • Type: string
  • Required: No
  • Description: Describes a decision matrix definition.

groupKey 

  • Type: string
  • Required: No
  • Description: A key for grouping matrix rows in different versions, such as a geographic region or a product code.

label 

  • Type: string
  • Required: Yes
  • Description: Required.

processType 

  • Type: ExpsSetProcessType (enumeration of type string)
  • Required: No
  • Description: The process type that uses the expression set rule.

subGroupKey 

  • Type: string
  • Required: No
  • Description: A subgroup key for grouping matrix rows in different versions, such as a geographic region or a product code. For example, if the groupKey is Country, the subGroupKey can be State or Province.

type 

  • Type: DecisionMatrixType (enumeration of type string)
  • Required: No
  • Description: The type of a decision matrix.

versions 

  • Type: DecisionMatrixDefinitionVersion[]
  • Required: No
  • Description: Represents an array of decision matrix version definitions in a decision matrix. This array must contain at least one version.

DecisionMatrixDefinitionVersion Type 

Represents a definition of a decision matrix version.

Parent Type 

This type extends Metadata and inherits its fields.

Fields 

columns 

decisionMatrixDefinition 

  • Type: string
  • Required: No
  • Description: The full name of a decision matrix version.

endDate 

  • Type: dateTime
  • Required: No
  • Description: The date until which a decision matrix definition version is available for use.

groupKeyValue 

  • Type: string
  • Required: No
  • Description: The value of the groupKey for a decision matrix definition version. For example, if the groupKey is Country, the groupKeyValue can be United States.

label 

  • Type: string
  • Required: Yes
  • Description: Required.

rank 

  • Type: int
  • Required: No
  • Introduced: API version 64.0
  • Description: The rank of the Decision Matrix Definition Version. When more than one enabled version matches a decision matrix call, and the start date time to end date time spans overlap, the version with the highest rank is chosen.

startDate 

  • Type: dateTime
  • Required: Yes
  • Description: Required.

status 

  • Type: DecisionMatrixDefStatus (enumeration of type string)
  • Required: Yes
  • Description: Required.

subGroupKeyValue 

  • Type: string
  • Required: No
  • Description: The value of the subgroup key for a decision matrix definition version. For example, if the subGroupKey is State or Province, the subGroupKeyValue can be California.

versionNumber 

  • Type: int
  • Required: Yes
  • Description: Required.

DecisionMatrixDefinitionVersionColumn Type 

Represents a definition of a column in a decision matrix definition version.

Fields 

columnType 

  • Type: DecisionMatrixColumnType (enumeration of type string)
  • Required: Yes
  • Description: Required.

dataType 

  • Type: DecisionMatrixDataType (enumeration of type string)
  • Required: Yes
  • Description: Required.

displaySequence 

  • Type: int
  • Required: Yes
  • Description: Required.

isWildcardColumn 

  • Type: boolean
  • Required: Yes
  • Description: Required.

name 

  • Type: string
  • Required: Yes
  • Description: Required.

rangeValue 

  • Type: string
  • Required: No
  • Description: A list of values that define range boundaries.

wildcardValue 

  • Type: string
  • Required: No
  • Description: The wildcard value such as ALL.

Declarative Metadata Sample Definition 

The following is an example of a DecisionMatrixDefinition component.

1<?xml version="1.0" encoding="UTF-8"?>
2<DecisionMatrixDefinition
3	xmlns="http://soap.sforce.com/2006/04/metadata">
4	<label>HealthCloudUM_ValidRegions</label>
5	<type>Standard</type>
6	<versions>
7		<fullName>HealthCloudUM_ValidRegions_V1</fullName>
8		<columns>
9			<columnType>Input</columnType>
10			<dataType>Text</dataType>
11			<displaySequence>2</displaySequence>
12			<isWildcardColumn>false</isWildcardColumn>
13			<name>State</name>
14		</columns>
15		<columns>
16			<columnType>Input</columnType>
17			<dataType>Text</dataType>
18			<displaySequence>1</displaySequence>
19			<isWildcardColumn>false</isWildcardColumn>
20			<name>City</name>
21		</columns>
22		<columns>
23			<columnType>Output</columnType>
24			<dataType>Boolean</dataType>
25			<displaySequence>3</displaySequence>
26			<isWildcardColumn>false</isWildcardColumn>
27			<name>IsValid</name>
28		</columns>
29		<decisionMatrixDefinition>HealthCloudUM_ValidRegions</decisionMatrixDefinition>
30		<label>HealthCloudUM_ValidRegions V1</label>
31		<startDate>2022-05-02T13:04:06.000Z</startDate>
32		<status>Draft</status>
33		<versionNumber>1</versionNumber>
34	</versions>
35</DecisionMatrixDefinition>

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

1<?xml version="1.0" encoding="UTF-8"?>
2<Package
3	xmlns="http://soap.sforce.com/2006/04/metadata">
4	<types>
5		<members>*</members>
6		<name>DecisionMatrixDefinition</name>
7	</types>
8	<version>68.0</version>
9</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.