Territory2Rule

Represents the metadata associated with a territory assignment rule associated with an object, such as Account, in Territory Management 2.0. This type extends the Metadata metadata type and inherits its fullName field.Available only if Territory Management 2.0 has been enabled for your Salesforce org.

File Suffix and Directory Location

Territory2Rule components have the suffix territory2Rule and are stored in the rules folder under the folder for the corresponding Territory2Model.

Version

Territory2Rule components are available in API version 32.0 and later.

Special Access

The Territory2Model object has a State field in the SOAP API. States include Planning, Active, Archived, and a number of other states, such as Cloning, that indicate that a process is underway. Users who do not have the “Manage Territories” permission can access only rules that belong to the model in Active state. The “Manage Territories” permission is required for deploy() calls for all territory management entities, in addition to the “Modify All Data” permission required by Metadata API. Using retrieve() without the “Manage Territories” permission will return only entities that belong to a Territory2Model in Active state. We recommend against retrieving without the “Manage Territories” permission because the call will retrieve only partial data.The SOAP API and the user interface require that a user attempting to create or edit a rules has field-level security access to the fields referenced in the rule item. This restriction is relaxed for Metadata API deploy() operations, as those require “Modify All Data” and “Manage Territories” permissions. “Modify All Data” is the base permission requirement for all Metadata API operations.

Fields

Field Name	Field Type	Description
active	boolean	Required. Indicates whether the rule is active (`true`) or inactive (`false`). Via the API, active rules run automatically when object records are created and edited. The exception is when the value of the IsExcludedFromRealign field on an object record is `true`, which prevents record assignment rules from evaluating that record.
booleanFilter	string	An advanced filter condition. For example: `(1 AND 2) OR 3`. Numbering must start at 1 and must be contiguous.
name	string	Required. The user interface label for the rule.
objectType	string	Required. The object that the rule is defined for. For API version 32.0, the only available object is Account.
ruleItems	Territory2RuleItem	The items that define a rule’s the selection criteria, such as Billing State `equals` California.

Territory2RuleItem

Represents the association of a rule item to a rule. Available in API version 32.0 and later.

Field Name	Field Type	Description
field	string	The standard or custom object field that the rule item operates on.
operation	FilterOperation (enumeration of type string)	The criterion to apply for the rule item. For example: `equals` or `starts with`.
value	string	The field value or values to evaluate. For example: if the field is Billing ZIP/Postal Code, a value might be `94105`.

Declarative Metadata Sample Definition

The following example shows the definition of a Territory2RuleItem component.

1<?xml version="1.0" encoding="UTF-8"?>
2<Territory2Rule xmlns="http://soap.sforce.com/2006/04/metadata">
3    <label>Northern CA</label>
4    <description>To capture northern CA based accounts</description>
5    <objectType>Account</objectType>
6    <active>True</active>
7    <ruleItems>
8        <field>BillingZip</field>
9        <operation>contains</operation>
10        <value><94105,94404,94536/value>
11    </ruleItems>
12    <ruleItems>
13        <field>Industry</field>
14        <operation>equals</operation>
15        <value>IT</value>
16    </ruleItems>
17    <ruleItems>
18        <field>someCustomField__c</field>
19        <operation>greater_than</operation>
20        <value>50000</value>
21    </ruleItems>
22    <booleanFilter>(1 OR 2) AND 3</booleanFilter>
23</Territory2Rule>

The following is a package.xml sample. FY13 and FY14 represent names of territory models and demonstrate that rules can have identical developer names within different models. A wildcard character (*) in place of the model name can be used to retrieve all rules in all models in an org.

1<?xml version="1.0" encoding="UTF-8"?> 
2<Package xmlns="http://soap.sforce.com/2006/04/metadata"> 
3        <types> 
4            <members>FY13</members>
5            <members>FY14</members> 
6            <name>Territory2Model</name> 
7        </types>
8        
9        <types>
10            <members>FY13.AccRule1</members>
11            <members>FY14.AccRule1</members>
12            <name>Territory2Rule</name>
13        </types>
14        
15        <version>39.0</version>
16</Package>

Usage

A territory rule can have up to 10 rule items.
The sort order of rule items is implicitly derived from the position of the rule items in the XML
Rules can’t be run via Metadata API.
Territory Management 2.0 components don’t support packaging or change sets and aren’t supported in CRUD calls.

Metadata API Developer Guide