Force.com Apex Code 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

FieldSet Class

Contains methods for discovering and retrieving the details of field sets created on sObjects.

Namespace

Schema

Usage

Use the methods in the Schema.FieldSet class to discover the fields contained within a field set, and get details about the field set itself, such as the name, namespace, label, and so on. The following example shows how to get a collection of field set describe result objects for an sObject. The key of the returned Map is the field set name, and the value is the corresponding field set describe result.

Field sets are also available from sObject describe results. The following lines of code are equivalent to the prior sample:

To work with an individual field set, you can access it via the map of field sets on an sObject or, when you know the name of the field set in advance, using an explicit reference to the field set. The following two lines of code retrieve the same field set:

Example: Displaying a Field Set on a Visualforce Page

This sample uses Schema.FieldSet and Schema.FieldSetMember methods to dynamically get all the fields in the Dimensions field set for the Merchandise custom object. The list of fields is then used to construct a SOQL query that ensures those fields are available for display. The Visualforce page uses the MerchandiseDetails class as its controller.
The Visualforce page using the above controller is simple:
One thing to note about the above markup is the expression used to determine if a field on the form should be indicated as being a required field. A field in a field set can be required by either the field set definition, or the field’s own definition. The expression handles both cases.

FieldSet Methods

The following are methods for FieldSet. All are instance methods.

getDescription()

Returns the field set’s description.

Signature

public String getDescription()

Return Value

Type: String

Usage

Description is a required field for a field set, intended to describe the context and content of the field set. It’s often intended for administrators who might be configuring a field set defined in a managed package, rather than for end users.

getFields()

Returns a list of Schema.FieldSetMember objects for the fields making up the field set.

Signature

public List<FieldSetMember> getFields()

Return Value

Type: List<Schema.FieldSetMember>

getLabel()

Returns the text label that is displayed next to the field in the Salesforce user interface.

Signature

public String getLabel()

Return Value

Type: String

getName()

Returns the field set’s name.

Signature

public String getName()

Return Value

Type: String

getNamespace()

Returns the field set’s namespace.

Signature

public String getNamespace()

Return Value

Type: String

Usage

The returned namespace is an empty string if your organization hasn’t set a namespace, and the field set is defined in your organization. Otherwise, it’s the namespace of your organization, or the namespace of the managed package containing the field set.

getSObjectType()

Returns the Schema.sObjectType of the sObject containing the field set definition.

Signature

public Schema.SObjectType getSObjectType()

Return Value

Type: Schema.SObjectType