OpportunityHistory

Represents the stage history of an Opportunity.

Supported Calls

query(), retrieve(), getDeleted(), getUpdated(), describeSObjects()

Fields

Field Field Type Field Properties Description
Amount double Filter

Nillable

Estimated total sale amount.
CloseDate date Filter

Nillable

Date when the opportunity is expected to close.
ExpectedRevenue currency Filter

Nillable

Calculated revenue based on the Amount and Probability fields.
ForecastCategory picklist Filter

Nillable

Restricted picklist

Category that determines the column in which an opportunity is totaled in a forecast. Label is To ForecastCategory.
IsDeleted boolean Defaulted on create

Filter

Indicates whether the record has been moved to the Recycle Bin (true) or not (false).

Label is Deleted.

OpportunityId reference Filter ID of the associated Opportunity.
Probability percent Filter

Nillable

Percentage of estimated confidence in closing the opportunity.
StageName picklist Filter Name of the current stage of the opportunity (for example, Prospect or Proposal).

Usage

This object represents the history of a change to the Amount, Probability, Stage, or Close Date fields of an Opportunity. The OpportunityFieldHistory object represents the history of a change to any of the fields of an Opportunity. To obtain information about how a particular opportunity is progressing, query() all of the OpportunityHistory objects associated with a given Opportunity. Please note that if an opportunity's Amount, Probability, Stage, or Close Date fields have not changed, nothing will be returned in the OpportunityHistory objects. In this case, query() all of the OpportunityFieldHistory objects associated with a given Opportunity to get more information about changes to the opportunity.

This object is read-only. The system generates a new record whenever a user or client application changes the value of any of the above fields; the then-current values of all of these major fields are saved in the newly-generated object.

This object respects field-level security on the parent object.

Note
The record is automatically deleted if its parent Opportunity is deleted.
© Copyright 2000-2009 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.