QuantityForecast

Represents a quantity-based forecast.

The API also provides revenue-based forecasts using RevenueForecast.

Supported Calls

create(), delete(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), update(), upsert()

Special Access Rules

Fields

Field Details
Closed
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. A rollup of opportunities or opportunity line items that have closed in this period.
Commit
Type
double
Properties
Filter, Nillable, Sort
Description
The owner's Commit total.
CommitComment
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Read-only. The comment entered when the owner edited his or her Commit total from the Adjusted Total link on the forecast edit page.
CommitOverride
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Read-only. The owner's override of their own My Commit total.
DefaultRollupCommit
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The owner's standard Commit rollup, including their own opportunities and forecast-level overrides from subordinate users in the role hierarchy.
DefaultRollupUpside
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The owner's standard Best Case rollup, including their own opportunities and forecast-level overrides from subordinate users in the role hierarchy.
InvalidationDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
Read-only. If not blank, indicates that the rollup numbers for Forecast Override fields that represent calculated (summarized) amounts may not be up to date.
ManagerChoiceCommit
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Read-only. The manager's choice regarding the commit amount:
  • DefaultRollup: Use the manager's default commit rollup for owner's forecast, which reflects the manager's opportunity forecast overrides.
  • AcceptForecast (default selection): Accept the forecast owner's Adjusted Total commit amount, which may or may not be an override.
  • ManagerManualOverride: Use the manager's manual override.
  • OpportunityOnlyRollup: Use the opportunity rollup, including opportunity forecast overrides, but excluding any forecast-level (Adjusted Total) overrides.
ManagerChoiceUpside
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Read-only. The manager's choice regarding the best case amount:
  • DefaultRollup: Use the manager's default best case rollup for owner's forecast, which reflects the manager's opportunity forecast overrides.
  • AcceptForecast (default selection): Accept the forecast owner's Adjusted Total best case amount, which may or may not be an override.
  • ManagerManualOverride: Use the manager's manual override.
  • OpportunityOnlyRollup: Use the opportunity rollup, including opportunity forecast overrides, but excluding any forecast-level (Adjusted Total) overrides.
ManagerClosed
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The manager's closed total for the owner's forecast, including any opportunity or opportunity product overrides made by the manager.
ManagerCommit
Type
double
Properties
Filter, Nillable, Sort
Description
The manager's Commit total.
ManagerCommitOverride
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Read-only. The manager's manual override of the forecast owner's Commit total. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
ManagerDefaultRollupCommit
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The manager's standard Commit rollup for the forecast owner. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
ManagerDefaultRollupUpside
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The manager's standard Best Case rollup for the forecast owner. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
ManagerId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Read-only. ID of the direct manager of the user who owns this forecast.
ManagerOpportunityRollupCommit
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The manager's view of the forecast owner's opportunity-level Commit rollup, ignoring all forecast overrides. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
ManagerOpportunityRollupUpside
Type
double
Properties
Filter, Nillable, Sort
Description
Read-only. The manager's view of the forecast owner's opportunity-level Best Case rollup, ignoring all forecast overrides. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
ManagerPipeline
Type
double
Properties
Filter, Nillable, Sort
Description
The manager's pipeline total for the owner's forecast, including any opportunity or opportunity product overrides made by the manager.
ManagerUpside
Type
double
Properties
Filter, Nillable, Sort
Description
The manager's Best Case total.
ManagerUpsideOverride
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
The manager's manual override of the forecast owner's Best Case total. Represents an option in the override pop-up window, which allows managers to choose how to roll up the forecast numbers of a direct report.
OpportunityRollupClosed
Type
double
Properties
Filter, Nillable, Sort
Description
The owner's Closed total for his or her opportunities only.
OpportunityRollupCommit
Type
double
Properties
Filter, Nillable, Sort
Description
The owner's Commit total for his or her opportunities only.
OpportunityRollupPipeline
Type
double
Properties
Filter, Nillable, Sort
Description
The owner's Pipeline total for his or her opportunities only.
OpportunityRollupUpside
Type
double
Properties
Filter, Nillable, Sort
Description
The owner's Best Case total for his or her opportunities only.
OwnerId
Type
reference
Properties
Create, Defaulted on create, Filter, Group, Sort
Description
ID of the User who owns this forecast. Required on create.
PeriodId
Type
reference
Properties
Filter, Nillable, Group, Sort
Description
The ID of the Period that contains the StartDate.
Pipeline
Type
double
Properties
Filter, Nillable, Sort
Description
The total pipeline rollup from subordinates in the role hierarchy, including the owner's opportunities.
ProductFamily
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort
Description
The value chosen in the Product Family picklist, which can be configured from Setup at Customize | Products | Fields. This field is relevant if you have chosen “Use Product Families” as the Forecast Type from Setup at Customize | Forecast | Settings. If you are not forecasting by product family or if the forecast represents opportunities that are not associated with a product family, then this field is blank. Required on create.
Quota
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
The quota amount for the period. You can create, update, upsert, and delete. Requires the “Modify All Data” and “Manage Users” permission. Required on create.
StartDate
Type
date
Properties
Create, Filter, Group, Nillable, Sort
Description
The start date of this forecast. The ID of the Period that contains this date is written to the PeriodId field if it changes. A new Period is created if none exists. Required on create.
Upside
Type
currency
Properties
Filter, Nillable
Description
The owner's Best Case total.
UpsideComment
Type
string
Properties
Filter, Nillable, Update
Description
The comment entered when the owner edited his or her Best Case total.
UpsideOverride
Type
double
Properties
Filter, Nillable, Update
Description
Read only. The owner's override of their own My Best Case total.

Usage

Query this object to support customizable forecasts based on quantities.

You can update one field, Quota, which means that you can mass update sales users' quotas instead of updating them one by one in the user interface. Editing Quota, which means that you can mass update sales users' quotas instead of updating them one by one in the user interface. Editing Quota requires the “Modify All Data” and “Manage Users” permissions.

The rollup fields always reflect opportunity and opportunity product overrides by the forecast owner or one of the forecast owner’s subordinates in the role hierarchy. In addition, the manager rollup fields include overrides by the forecast owner's direct manager in the role hierarchy.

Some of the rollup fields ignore forecast-level (Adjusted Total) overrides, but they never ignore opportunity forecast overrides that are visible to the owner or manager.

© Copyright 2000–2014 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.