Idea

Represents an idea on which users are allowed to comment and vote, for example, a suggestion for an enhancement to an existing product or process.

Supported Calls

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

Note

For other standard objects, the describeLayout() call returns the recordTypeMappings section that contains the layout ID and picklist values for each record type. However, the recordTypeMappings section and the fields it includes are not available for the Idea object.

When performing a SOSL search on Idea objects, IdeaComment objects are also searched.

Fields

Field	Field Type	Field Properties	Description
Body	textarea	Create Nillable Update	Description of the Idea.
Categories	multipicklist	Create Filter Nillable Update	Customizable multi-select picklist used to organize Ideas into logical groupings. Note This field is only available if your organization has the Categories field enabled in Salesforce.com. This field is enabled by default in organizations created after API version 14 was released. If the Categories field is enabled, API versions 13 and earlier do not have access to either the Categories or Category fields.
Category	picklist	Create Filter Nillable Update	Customizable picklist of values used to organize Ideas into logical groupings. Note This field is not available if your organization has the multi-select Categories field enabled.
CommunityId	reference	Create Filter	The Community ID associated with the Idea. Once you create an Idea, you cannot change the Community ID associated with that Idea. Note API version 12 does not support Community ID. If you create an idea in version 12, your idea is automatically posted to the oldest community that you have permission to access.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Deleting an idea also deletes its child objects IdeaComment and Vote.
IsHTML	boolean	Defaulted on create Filter	Read-only. If this value is `true`, your organization has the Salesforce CRM Ideas HTML editor enabled, and the Idea Body may contain HTML. If this value is `false`, the HTML editor is disabled and the Idea Body only contains regular text. For information on enabling the HTML editor, search for “HTML Editor” in the Salesforce.com online help.
IsLocked	boolean	Filter	Read only. Indicates whether the idea has been locked because it was merged with a parent idea (`true`) or not (`false`). You cannot vote for or add comments to a locked idea.
LastCommentDate	dateTime	Filter Nillable	The date and time the last comment (child IdeaComment object) was added.
LastCommentId	reference	Filter Nillable	Read only. The ID of the last comment (child IdeaComment object).
NumComments	int	Filter Nillable	The number of comments (child IdeaComment objects) that users have submitted for the given idea.
ParentIdeaID	reference	Nillable Filter	The ID associated with this idea's parent idea. When multiple ideas are merged together, one idea becomes the parent (master) of the other ideas. The ParentIdeaID is automatically set when you merge ideas in Salesforce.com.
Status	picklist	Create Filter Nillable Update	Customizable picklist of values used to specify the status of an idea.
Title	string	Create Filter Update	The descriptive title of the idea.
VoteScore	double	Filter Nillable	The internal score of the Idea, used to sort Ideas on the Popular tab in the application user interface. The internal algorithm that determines the score gives older votes less weight than newer votes, simulating exponential decay. The score itself does not display in the application user interface.
VoteTotal	double	Filter Nillable	An Idea's total number of points. Each vote a user makes is worth ten points, therefore the value of this field is ten times the number of votes an idea has received.

Note

If you are importing Idea data into Salesforce.com and need to set the value for an audit field, such as CreatedDate, contact salesforce.com. Audit fields are automatically updated during API operations unless you request to set these fields yourself. For more information, see System Fields.

Usage

Use this object to track ideas, which are written suggestions on which users can vote and comment. For more information on ideas, see ”“Ideas Overview” in the Salesforce.com online help.