Force.com Tooling API Developer's Guide

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Newer Version Available

This content describes an older version of this product. View Latest

FieldHistoryRetentionJob

Specifies the date range for the retention of field history data, beyond the standard 18 months of data retention that Salesforce provides. The specified retention period cannot be less than 18 months.

Available from API version 29.0 or later.

The FieldHistoryRetentionJob object is currently available through a limited pilot program. Contact your salesforce.com representative to see if your organization qualifies.

Note

Supported SOAP API Calls

create(),  describeSObjects(), query(), retrieve()

Supported REST API HTTP Methods

GET, POST

Fields

Field Name Details
CreatedById
Type
reference
Properties
Default on create, Filter, Group, Sort
Description
The user ID of the user who created the field history retention job.
CreatedDate
Type
dateTime
Properties
Default on create, Filter, Sort
Description
The date the record was saved.
DurationSeconds
Type
int
Properties
Filter, Group, Nillable, Sort
Description
How many seconds the field history retention job took to complete (either successfully or with failures).
FieldHistoryType
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort
Description
The standard Salesforce object type containing the field history you want to retain. Valid values are:
  • Account
  • Contact
  • Leads
  • Opportunity
NumberOfRowsRetained
Type
int
Properties
Filter, Group, Nillable, Sort
Description
The number of field history rows a field history retention job has retained.
RetainOlderThanDate
Type
dateTime
Properties
Create, Filter, Sort
Description
The date and time before which all field history data will be retained.
StartDate
Type
dateTime
Properties
Filter, Nillable, Sort
Description
The start date of the field history retention job.
Status
Type
picklist
Properties
Filter, Group, Nillable, Restricted picklist, Sort
Description
Provides the status of the field history retention job. Valid values are:
  • Scheduled
  • Running
  • Succeeded
  • Failed