FeedTrackedChange

Represents an individual field change or set of field changes. A FeedTrackedChange is a child object of an associated NewsFeed, UserProfileFeed, or record feed, such as AccountFeed. This object is available in API version 18.0 and later.

Supported Calls

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

Fields

Field	Details
CurrencyIsoCode	Type picklist Properties Group, Restricted picklist, Sort Description Available only for organizations with the multicurrency feature enabled. Contains the ISO currency code for the field, if FieldName is a currency field.
FeedItemId	Type reference Properties Group, Sort, Filter Description ID of the parent feed that tracks the field change.
FieldName	Type string Properties Group, Sort Description The name of the field that was changed. Note This field also tracks other events that are not related to an individual field for a parent feed. These events occur as the parent record advances through its pipeline. For example, a value of `leadConverted` indicates that a lead has been converted to an opportunity. For a full list of values, see Tracking of Special Events.
NewValue	Type anyType Properties Nillable, Sort Description The new value of the field that was changed.
OldCurrencyIsoCode	Type string Properties Group, Nillable, Sort Description Available only for organizations with the multicurrency feature enabled. Contains the ISO currency code for the OldValue field, if FieldName is a currency field.
OldValue	Type anyType Properties Nillable, Sort Description The last value of the field before it was changed.

Usage

A user can subscribe to a record so that changes to the record are displayed in the Chatter feed on the user's home page, which is a useful way to stay up-to-date with changes made to records in Salesforce. Feeds are available in API version 18.0 and later.

If you move a custom field to the Recycle Bin, all FeedTrackedChange records that track historical changes to the custom field are automatically deleted and are not restored if the custom-field is undeleted.

The following sections outline the difference between standard feeds and custom feeds.

Standard Feeds

A standard feed is a NewsFeed, UserProfileFeed, or record feed, such as AccountFeed. FeedTrackedChange records for standard feeds can only be queried via the parent feed object. This query returns information, including child FeedTrackedChange records for parent NewsFeed records:

SELECT ID, CreatedDate, CreatedById, CreatedBy.FirstName, CreatedBy.LastName, ParentId, Parent.Name,
        (SELECT ID, FieldName, OldValue, NewValue FROM FeedTrackedChanges ORDER BY ID DESC)
      FROM NewsFeed
      ORDER BY CreatedDate DESC, Id DESC
      LIMIT 20

Note the following when working with standard feed items:

Feed items for standard feeds are read only in the API.
A FeedTrackedChange record is visible when you have read access on the feed's parent NewsFeed, UserProfileFeed, or record feed, and when the field in the FeedTrackedChange is visible in the field-level security settings.

Custom Feeds

If you want more control over the information provided in a record feed, such as AccountFeed, you can create a custom feed. A custom feed can replace or augment an existing record feed. For example, you might want to:

Disable the standard account record feed and use an Apex trigger to generate FeedTrackedChange records for the events that you want to track in the feed instead.
Augment the standard contact record feed by writing an API client that inserts feed items for events that are not tracked in the standard feed.

Tracking of Special Events

The FieldName field also tracks other events that are not related to an individual field for a parent feed. These events occur as the parent record advances through its pipeline. For example, a value of leadConverted indicates that a lead has been converted to an opportunity.

Valid values for the FieldName field for multiple objects:

created
ownerAccepted
ownerAssignment

Additional valid values for the FieldName field for individual objects:

Account

accountCreatedFromLead
accountMerged
accountUpdatedByLead
personAccountUpdatedByLead

Case

closed
ownerEscalated

Contact

contactCreatedFromLead
contactMerged
contactUpdatedByLead

Contract

contractActivation
contractApproval
contractConversion
contractExpiration
contractTermination

Lead

leadConverted
leadMerged

Opportunity

opportunityCreatedFromLead