ForecastingSettings

この情報は、コラボレーション売上予測にのみ適用されます。

メモ

パッケージマニフェストでは、Settings の名前を使用してすべての組織設定メタデータ型にアクセスします。詳細は「設定」を参照してください。

ファイルのサフィックスおよびディレクトリの場所

ForecastingSettings の値は、対応するパッケージディレクトリの settings ディレクトリの Forecasting.settings という 1 つのファイルに保存されます。.settings ファイルは、各設定コンポーネントに設定ファイルが 1 つしかないため、他の名前つきのコンポーネントとは異なります。

バージョン

ForecastingSettings コンポーネントは、API バージョン 28 以降で使用できます。ForecastingSettings 型の構造は、API バージョン 30.0 で大幅に変更されました。

項目

項目名	項目の型	説明
displayCurrency	DisplayCurrency (string 型の列挙)	削除済み。売上予測の表示に使用する通貨。組織のマスタ通貨または各売上予測所有者の個人設定の通貨のいずれかになります。選択された通貨は、コラボレーション売上予測で使用され、設定で選択されるデフォルトです。組織で使用するために有効化されているいずれか 1 つの通貨を選択する必要があり、選択できるのは 1 つのみです。デフォルトは `CORPORATE` です。有効な値は、次のとおりです。 `CORPORATE` `PERSONAL` API バージョン 28.0 ～ 46.0 で使用可能です。API バージョン 47.0 以降では、defaultToPersonalCurrency を使用します。
defaultToPersonalCurrency	boolean	マルチ通貨が有効な場合、この項目はユーザの個人設定の通貨を売上予測で使用するかどうかを示します。`true` (デフォルト) の場合、ユーザの個人設定の通貨が使用されます。`false` の場合、マスタ通貨が使用されます。 API バージョン 47.0 以降で利用できます。
enableForecasts	boolean	コラボレーション売上予測が有効化されているかどうかを示します。コラボレーション売上予測を有効にするには `true` に設定し、無効にするには `false` に設定します。売上予測を無効にすると、データが失われる可能性があります。機能を無効にする前に、Salesforce ヘルプを参照してください。警告
forecastingCategoryMappings	ForecastingCategoryMapping[]	売上予測種別と売上予測積み上げ集計を関連付ける対応付けのリスト。Spring ’20 以降、このサブタイプにアクセスできるのは、「すべての売上予測の参照」権限もしくは「売上予測を許可」権限を持つ標準ユーザ、または代理売上予測マネージャ状況の標準ユーザのみとなります。
forecastingDisplayedFamilySettings	ForecastingDisplayedFamilySettings[]	Lightning Experience で売上予測を可能にするために選択される商品ファミリ。この項目は、API バージョン 40.0 以降で使用できます。
forecastingTypeSettings	ForecastingTypeSettings[]	売上予測種別のリストです。項目値については、ForecastingTypeSettings を参照してください。売上予測種別の最大数は 4 です。

ForecastingCategoryMapping

コラボレーション売上予測の売上予測分類の対応付け。このサブタイプは、ForecastingSettings 種別内に 8 回出現します。各出現箇所には、売上予測分類積み上げ集計の種別を指定する項目、各積み上げ集計に含まれる売上予測分類、および積み上げ集計での各売上予測分類の加重が含まれます。累積売上予測積み上げ集計列または個々の売上予測分類列を使用する組織は、このサブタイプの 8 つの出現箇所すべてを含める必要があります。Spring ’20 以降、このサブタイプにアクセスできるのは、「すべての売上予測の参照」権限もしくは「売上予測を許可」権限を持つ標準ユーザ、または代理売上予測マネージャ状況の標準ユーザのみとなります。

項目	項目の型	説明
forecastingItemCategoryApiName	string	必須。この項目は、積み上げ集計種別の API 名を指定します。有効な値は、次のとおりです。 `openpipeline` `bestcaseforecast` `commitforecast` `pipelineonly` `bestcaseonly` `commitonly` `closedonly` `omittedonly`
weightedSourceCategories	WeightedSourceCategory[]	この項目は、複数の売上予測分類を積み上げ集計種別に含めるように指定した場合、複数回出現します。各出現箇所には、売上予測積み上げ集計種別に含める売上予測分類とその加重を指定する 2 つのサブ項目が含まれます。一部の積み上げ集計種別には、複数の売上予測分類が含まれます。次のリストは、各積み上げ集計種別に含まれる売上予測分類を示します。積み上げ集計: `openpipeline`、売上予測分類: パイプライン、最善達成予測、達成予測積み上げ集計: `bestcaseforecast`、売上予測分類: 最善達成予測、達成予測、完了積み上げ集計: `commitforecast`、売上予測分類: 達成予測、完了積み上げ集計: `pipelineonly`、売上予測分類: `pipeline` 積み上げ集計: `bestcaseonly`、売上予測分類: `best case` 積み上げ集計: `commitonly`、売上予測分類: `commit` 積み上げ集計: `closedonly`、売上予測分類: `closed` 積み上げ集計: `omittedonly`、売上予測分類: `omitted`

ForecastingDisplayedFamilySettings

Lightning Experience で売上予測を可能にするためにシステム管理者が選択する商品ファミリ。この項目は、API バージョン 40.0 以降で使用できます。

項目	項目の型	説明
productFamily	string	売上予測に使用可能な商品ファミリ。商品ファミリはそれぞれ異なります。

ForecastingTypeSettings

各売上予測種別の設定。組織では、最大 4 個の売上予測種別を有効にできます。最小の API バージョンがメタデータパッケージバージョン以下の、以前有効だった売上予測種別を除外すると、その目標と調整データが組織から削除されます。

XML から売上予測種別項目を除外すると、その売上予測種別が無効になる場合があります。その売上予測種別が XML パッケージバージョンで指定されたリリースで使用可能だった場合、その売上予測種別は無効になり、その目標および調整データは削除されます。

警告

項目名	項目の型	説明
active	boolean	必須。name 項目で指定されている売上予測種別が有効かどうかを示します。 active 項目を false に設定すると、その売上予測種別のすべての売上予測データ、調整、および目標が消去されます。active を true に設定すると、[売上予測] タブの一部の値がすぐに表示されない場合があります。処理中アイコンが表示され、値が計算中であることを示します。メモ
adjustmentsSettings	AdjustmentsSettings	必須。これは、売上予測の売上予測調整オプションを有効または無効にします。
displayedCategoryApiNames	string	この参照のみ項目は、累積売上予測積み上げ集計または個々の売上予測分類積み上げ集計について、[売上予測] タブに表示される 4 つの売上予測積み上げ集計カテゴリを指定するために 4 回出現します。displayedCategoryApiNames と forecastedCategoryApiNames の両方で、常に同じ 4 つの値を使用します。累積売上予測積み上げ集計を使用する組織の有効値は次のとおりです。 `openpipeline` `bestcaseforecast` `commitforecast` `closedonly` 個々の売上予測分類積み上げ集計を使用する組織の有効値は次のとおりです。 `pipelineonly` `bestcaseonly` `commitonly` `closedonly`
forecastedCategoryApiNames	string	この項目は、累積売上予測積み上げ集計または個々の売上予測分類積み上げ集計について、組織で使用される 4 つの売上予測積み上げ集計カテゴリを指定するために 4 回出現します。累積売上予測積み上げ集計を使用する組織の有効値は次のとおりです。 `openpipeline` `bestcaseforecast` `commitforecast` `closedonly` 個々の売上予測分類積み上げ集計を使用する組織の有効値は次のとおりです。 `pipelineonly` `bestcaseonly` `commitonly` `closedonly` ある 4 つの値のセットから他のセットに変更すると、[設定] の [累積売上予測積み上げ集計列を有効化] の組織設定が変更されます。この項目が省略されると、設定は変更されません。
ForecastingDateType	ForecastingDateType (string 型の列挙)	必須。コラボレーション売上予測で売上予測金額のベースとなる date 型。有効な値は、次のとおりです。 `OpportunityCloseDate` (デフォルト) `ProductDate` `ScheduleDate` API バージョン 42.0 以降で利用できます。API バージョン 42.0 に限り、date 型を参照のみで API を介してのみ使用できます。
forecastRangeSettings	ForecastRangeSettings	必須。コラボレーション売上予測のデフォルトの期間と範囲の選択。
hasProductFamily	boolean	必須。売上予測種別で商品ファミリ売上予測が有効かどうかを示します。API バージョン 41.0 以降で利用できます。
isAmount	boolean	必須。この参照のみ項目は、売上予測種別が収益金額に基づくかどうかを示します。isAmount の値は常に isQuantity の値の反対です。
isAvailable	boolean	必須。この参照のみ項目は、売上予測種別を現在組織で使用できるかどうかを示します。たとえば、収益分割売上予測種別は、商談の分割が有効ではない組織では使用できません。
isQuantity	boolean	必須。この参照のみ項目は、売上予測種別が商品数量に基づくかどうかを示します。isQuantity の値は常に isAmount の値の反対です。
managerAdjustableCategoryApiNames	string	この参照のみの項目は、累積売上予測積み上げ集計または個々の売上予測分類積み上げ集計について、組織で売上予測マネージャが調整可能な 2 つの売上予測積み上げ集計カテゴリを指定するために 2 回出現します。この項目は、enableAdjustments 項目の値が true の場合にのみ使用できます。managerAdjustableCategoryApiNames および ownerAdjustableCategoryApiNames の両方の項目が使用されている場合、同じ 2 つの値が含まれている必要があります。それらの値は、enableAdjustments および enableOwnerAdjustments 項目の値と一致する必要もあります。累積売上予測積み上げ集計を使用する組織の有効値は次のとおりです。 `bestcaseforecast` `commitforecast` 個々の売上予測分類積み上げ集計を使用する組織の有効値は次のとおりです。 `bestcaseonly` `commitonly`
masterLabel	string	必須。この参照のみの項目は、売上予測種別の UI 表示ラベルを示します。
name	string	必須。売上予測種別の名前。売上予測種別ごとに特定の文字列が必要です。使用できる値は次のとおりです。 `LineItemQuantityProductDate`: 商品ファミリ - 商品提供日別数量。API バージョン 47.0 以降で利用できます。 `LineItemQuantityScheduleDate`: 商品ファミリ - スケジュール日別数量。API バージョン 47.0 以降で利用できます。 `LineItemRevenueProductDate`: 商品ファミリ - 商品提供日別収益。API バージョン 47.0 以降で利用できます。 `LineItemRevenueScheduleDate`: 商品ファミリ - スケジュール日別収益。API バージョン 47.0 以降で利用できます。 `OpportunityLineItemQuantity`: 商品ファミリ - 数量 `OpportunityLineItemRevenue`: 商品ファミリ - 収益 `OpportunityOverlayRevenue`: 商談オーバーレイ分割 - 収益 `OpportunityQuantity`: 商談 - 数量 `OpportunityQuantityProductDate`: 商談 - 数量 (商品提供日別)。API バージョン 43.0 以降で利用できます。 `OpportunityQuantityScheduleDate`: 商談 - 数量 (スケジュール日別)。API バージョン 43.0 以降で利用できます。 `OpportunityRevenue`: 商談 - 収益 `OpportunityRevenueProductDate`: 商談 - 収益 (商品提供日別)。API バージョン 43.0 以降で利用できます。 `OpportunityRevenueScheduleDate`: 商談 - 収益 (スケジュール日別)。API バージョン 43.0 以降で利用できます。 `OpportunitySplitRevenue`: 商談収益分割 - 収益 `Territory_Model_NameN`: テリトリー。`Territory_Model_Name` は API の有効なテリトリーモデルの名前。`Territory_Model_Name` は後ろに `N` が続く場合があります。N は自動生成される数値で、テリトリー売上予測種別を識別します。API バージョン 44.0 以降で利用できます。 `Territory_Model_NameN_ProductFamily`: 非推奨。テリトリー - 商品ファミリ。`Territory_Model_Name` は API の有効なテリトリーモデルの名前であり、後ろに `N` が続く場合があります。N は自動生成される数値で、テリトリー売上予測種別を識別します。API バージョン 45.0 および 46.0 で使用できます。API バージョン 47.0 以降で作成されたテリトリーモデルには、`Territory_Model_NameN` が使用されます。売上予測種別として有効化されているカスタム商談分割種別の名前。カスタム分割種別は通貨項目に基づいており、収益金額のみを保存できます。
opportunityListFieldsLabelMappings	OpportunityListFieldsLabelMapping	商談オブジェクトのすべての項目の API 名と UI 表示ラベルの参照のみリスト。
opportunityListFieldsSelectedSettings	OpportunityListFieldsSelectedSettings	必須。売上予測種別の売上予測ページの商談ペインに表示するために選択された項目。選択した項目の 1 つが [商談名] である必要があります。15 項目まで選択できます。
opportunityListFieldsUnselectedSettings	OpportunityListFieldsUnselectedSettings	必須。売上予測種別の売上予測ページの商談ペインに表示される対象として選択されていない項目。
opportunitySplitName	string	売上予測種別に分割種別があるかどうか、ある場合はその分割種別名を示します。API バージョン 41.0 以降で利用できます。
ownerAdjustableCategoryApiNames	string	この参照のみの項目は、累積売上予測積み上げ集計または個々の売上予測分類積み上げ集計について、組織で売上予測所有者が調整可能な 2 つの売上予測積み上げ集計カテゴリを指定するために 2 回出現します。この項目は、enableOwnerAdjustments 項目の値が true の場合にのみ使用できます。managerAdjustableCategoryApiNames および ownerAdjustableCategoryApiNames の両方の項目が使用されている場合、同じ 2 つの値が含まれている必要があります。それらの値は、enableAdjustments および enableOwnerAdjustments 項目の値と一致する必要もあります。累積売上予測積み上げ集計を使用する組織の有効値は次のとおりです。 `bestcaseforecast` `commitforecast` 個々の売上予測分類積み上げ集計を使用する組織の有効値は次のとおりです。 `bestcaseonly` `commitonly`
quotasSettings	QuotasSettings	必須。これは、売上予測の目標オプションを有効または無効にします。
territory2ModelName	string	売上予測種別に Territory2 モデルがあるかどうか、ある場合はその Territory2 モデル名を示します。API バージョン 41.0 以降で利用できます。

AdjustmentsSettings

コラボレーション売上予測の調整オプション。

項目	項目の型	説明
enableAdjustments	boolean	必須。コラボレーション売上予測マネージャによる調整を有効にするには `true` に設定し、無効にするには `false` に設定します。すべての売上予測種別には、同じ enableAdjustments 値が含まれている必要があります。調整を無効にすると、コラボレーション売上予測調整データが消去されます。警告
enableOwnerAdjustments	boolean	必須。コラボレーション売上予測所有者による調整を有効にするには `true` に設定し、無効にするには `false` に設定します。すべての売上予測種別には、同じ enableAdjustments 値が含まれている必要があります。調整を無効にすると、コラボレーション売上予測調整データが消去されます。警告

ForecastRangeSettings

コラボレーション売上予測のデフォルトの期間と範囲の選択。ユーザは、過去または将来の 15 か月、15 会計期間、または 8 四半期までの売上予測が可能です。売上予測範囲に当月、当期間、または当四半期が含まれている場合、売上予測ページにはデフォルトで当月、当期間、または当四半期が表示されます。含まれていない場合は、範囲の最初の月、期間、または四半期が選択されます。すべての売上予測種別には、同じ forecastRangeSettings 項目値が含まれている必要があります。

期間を [毎月] から [毎四半期] または [毎四半期] から [毎月] に変更するか、標準会計年度を変更すると、すべての調整および目標が消去されます。カスタム会計年度を有効にした場合、最初のカスタム会計年度を作成すると、対応する標準会計年度以降の目標と調整が削除されます。これらの変更により、売上予測の再計算がトリガされます。データ量によっては、この再計算にかなりの時間がかかる場合があります。

警告

項目	項目の型	説明
beginning	int	必須。デフォルトで表示する開始月または開始四半期を示します。
displaying	int	必須。デフォルトで表示する月数または四半期数を示します。最大月数は 12、最大四半期数は 8 です。
periodType	PeriodTypes (string 型の列挙)	必須。使用する期間の種別を示します。有効な値は、次のとおりです。 `Month` `Quarter` `Week` `Year`

OpportunityListFieldsLabelMapping

商談オブジェクトのすべての項目の API 名と UI 表示ラベルの参照のみリスト。

項目	項目の型	説明
field	string	必須。商談項目の API 名。
label	string	必須。商談項目の UI 表示ラベル。

OpportunityListFieldsSelectedSettings

売上予測種別の売上予測ページの商談ペインに表示するために選択された項目。選択した項目の 1 つが [商談名] である必要があります。15 項目まで選択できます。

項目	項目の型	説明
field	string	商談ペインに表示する項目名を指定します。

OpportunityListFieldsUnselectedSettings

売上予測種別の売上予測ページの商談ペインに表示される対象として選択されていない項目。

項目	項目の型	説明
field	string	商談ペインに表示しない項目名を指定します。

QuotasSettings

QuotasSettings は、コラボレーション売上予測で目標を使用できるかどうかを示します。

項目	項目の型	説明
showQuotas	boolean	必須。目標を有効にするには、`true` に設定します。すべての売上予測種別には、同じ showQuotas 項目値が含まれている必要があります。

WeightedSourceCategory

この項目は、複数の売上予測分類を積み上げ集計種別に含めるように指定した場合、複数回出現します。各出現箇所には、売上予測積み上げ集計種別に含める売上予測分類とその加重を指定する 2 つのサブ項目が含まれます。一部の積み上げ集計種別には、複数の売上予測分類が含まれます。次の表は、各積み上げ集計種別に含まれる売上予測分類を示します。

項目	項目の型	説明
sourceCategoryApiName	string	必須。積み上げ集計種別に含める売上予測分類の API 名を指定します。有効な値は、次のとおりです。 `パイプライン` `最善達成予測` `達成予測` `完了` `売上予測から除外`
weight	double	必須。積み上げ集計種別の売上予測を計算するときに売上予測分類に指定される加重を指定します。サポートされている値は、`1.0` のみです。

宣言的なメタデータの定義のサンプル

次に、[商談 - 収益] および [商品ファミリ - 数量] 売上予測種別を有効にする ForecastingSettings コンポーネントの例を示します。

マニフェストファイル内のワイルドカードのサポート

package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) は、機能設定のメタデータ型には適用されません。ワイルドカードは、個々の設定ではなくすべての設定を取得するときにのみ適用されます。詳細は、「設定」を参照してください。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。

メタデータ API 開発者ガイド