メタデータ API 開���者ガイド
jTerritory2Settings
組織の Territory2 設定を表します。Territory2 設定を使用して、営業テリトリーに関連付けられているレコードに対して Territory Management 2.0 ユーザが持つアクセスレベルを設定し、機能を有効にします。標準レコードアクセス設定は、取引先と商談に適用されます。Salesforce 組織で取引先責任者またはケースに「非公開」のデフォルトの内部アクセス権を使用している場合は、それらのレコードのアクセス権も設定できます。Metadata メタデータ型を拡張し、その fullName 項目を継承します。
ファイルのサフィックスおよびディレクトリの場所
パッケージマニフェストでは、Settings の名前を使用してすべての組織設定メタデータ型にアクセスします。詳細は「設定」を参照してください。
Territory2Settings の値は、対応するパッケージディレクトリの settings ディレクトリの Territory2.settings という 1 つのファイルに保存されます。.settings ファイルは、各設定コンポーネントに設定ファイルが 1 つしかないため、他の名前つきのコンポーネントとは異なります。
バージョン
Territory2Settings は、API バージョン 32.0 以降で使用できます。
特別なアクセスルール
項目
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| defaultAccountAccessLevel | string | テリトリーの取引先レコードに対してユーザが持つデフォルトアクセスレベル (テリトリーに割り当てられた取引先の参照および編集、またはテリトリーに割り当てられた取引先の参照、編集、移行、および削除) を設定します。 |
| defaultCaseAccessLevel | string | テリトリーのケースレコードに対してユーザが持つデフォルトアクセスレベル (テリトリーに割り当てられた取引先の参照および編集、またはテリトリーに割り当てられた取引先の参照、編集、移行、および削除) を設定します。 |
| defaultContactAccessLevel | string | テリトリーの取引先責任者レコードに対してユーザが持つデフォルトアクセスレベル (テリトリーに割り当てられた取引先の参照および編集、またはテリトリーに割り当てられた取引先の参照、編集、移行、および削除) を設定します。 |
| defaultOpportunityAccessLevel | string | テリトリーの商談レコードに対してユーザが持つデフォルトアクセスレベル (テリトリーに割り当てられた取引先の参照および編集、またはテリトリーに割り当てられた取引先の参照、編集、移行、および削除) を設定します。 |
| enableTerritoryManagement2 | boolean | エンタープライズテリトリー管理のみを有効および無効にします。true の場合、エンタープライズテリトリー管理が有効になります。false (デフォルト) の場合、エンタープライズテリトリー管理が無効になります。エンタープライズテリトリー管理の有効化および無効化は他の操作に対して排他的で、他のテリトリー管理操作を実行する前にこの項目値を true にする必要があります。 API バージョン 47.0 以降で利用できます。 |
| showTM2EnabledBanner | boolean |
true の場合、[設定] の [テリトリーの設定] ページに成功バナーが表示されます。 API バージョン 49.0 以降で利用できます。 |
| t2ForecastAccessLevel | string | 商談の所有者に関係なく、親テリトリーのユーザが下位テリトリーに割り当てられた商談にアクセスするときのアクセスレベルを設定します。 有効な値は、次のとおりです。
API バージョン 49.0 以降で利用できます。 |
| tm2BypassRealignAccInsert | boolean |
true の場合、取引先の挿入ジョブ中に取引先割り当てルールは実行されません。 API バージョン 53.0 以降で利用できます。 |
宣言的なメタデータの定義のサンプル
次の例は、Territory2Settings コンポーネントの定義を示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<Territory2Settings xmlns="http://soap.sforce.com/2006/04/metadata">
3 <defaultAccountAccessLevel>Owner</defaultAccountAccessLevel>
4 <defaultOpportunityAccessLevel>Read</defaultOpportunityAccessLevel>
5 <defaultCaseAccessLevel>None</defaultCaseAccessLevel>
6 <defaultContactAccessLevel>Edit</defaultContactAccessLevel>
7 <enableTerritoryManagement2>true</enableTerritoryManagement2>
8 <showTM2EnabledBanner>true</showTM2EnabledBanner>
9 <t2ForecastAccessLevel>View</t2ForecastAccessLevel>
10</Territory2Settings>使用方法
Territory Management 2.0 のコンポーネントは、パッケージ化や変更セットをサポートしておらず、CRUD コールでサポートされていません。
マニフェストファイル内のワイルドカードのサポート
package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) は、機能設定のメタデータ型には適用されません。ワイルドカードは、個々の設定ではなくすべての設定を取得するときにのみ適用されます。詳細は、「設定」を参照してください。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。