<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® data platform 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.) |
| 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 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.
