<subjectArea>

Defines a subject area in a Business Intelligence subject area class.

Details>

The <subjectArea> element contains the following items:

Attribute or Element	Purpose
name, displayName, description, disabled	See Common Attributes in a Subject Area.Note that the name attribute must be unique within the InterSystems IRIS® namespace.
baseCube	Logical name of the cube on which this subject area is based. (This can also be a comma-separated list of logical cube names; see Defining Compound Cubes Advanced Modeling for InterSystems Business Intelligence.)
owner	(Optional) Name of owner of subject area.
resource	(Optional) Name of the resource used to control access to this subject area, when it is accessed via the Architect. See the Implementing InterSystems Business Intelligence.
filterSpec	(Optional) MDX set expression to use as a filter for this subject area. See the subsection Filtering a Subject Area. The default is an empty string so that there is no filtering.
caption	(Optional) Caption for this subject area. If you do not specify this, the system uses the caption of the base cube instead.
countMeasureCaption	(Optional) Caption to use for the default measure, which counts records. The default caption is Count. Internally, the name of the measure is %Count.
defaultListing	(Optional) Specify the logical name of the <listing> to use as the default in this subject area; see <listing>. If you do not specify this, the system uses the default listing as specified in the base cube.
disableListingGroups	(Optional) Specify this attribute as "true" if you want to prevent anyone from defining a listing group that uses this subject area as a target. The default is "false". See Compiling a Listing Group.
defaultMember, defaultMeasure	Do not use.
<measure>	(Optional) You can include zero or more <measure> elements, each of which can hide or customize a measure.
<dimension>	(Optional) You can include zero or more <dimension> elements, each of which can hide or customize a dimension.
<listing>	(Optional) You can include zero or more <listing> elements, each of which can hide, customize, or add a listing for this subject area.

Filtering a Subject Area

The filterSpec attribute enables you to specify a filter that applies to the subject area. This attribute must equal a valid MDX set expression. For example:

{AgeD.H1.[10 to 19],AgeD.H1.[20 to 29]}

See Writing Filter Expressions.

Instead of (or in addition to) specifying filterSpec, you can implement the %OnGetFilterSpec callback; see Filtering a Cube or Subject Area Dynamically in Advanced Modeling for InterSystems Business Intelligence.

Common Attributes in a Subject Area Class