# PropertySettingsList JSP Tag Attributes

Use the PropertySettingsList JSP tag to define a list in which each item represents one or more property settings for BI objects, session variables, or both. A session variable is a custom property that you define and set on the session while completing the PropertySettingsList wizard.

## Technical note about the list

When you complete the wizard for the PropertySettingsList tag, the following nested tags are also generated in your source code:

- PropertyGroup tag -- Identifies the label for one item that appears in the PropertySettingsList. There is one PropertyGroup tag for each list item. Each PropertyGroup tag has one or more Property tags nested within it.

- Property tag -- Identifies one property setting within a PropertyGroup tag.

## Attributes for PropertySettingsList tag

id -- (Required) Unique identifier for this tag.

partialTargets -- Tag identifiers of additional objects that this tag should update and include in a partial page refresh.

## Attributes for PropertyGroup tag

id -- Unique identifier for this tag. The wizard generates this attribute automatically. You can locate the attribute in the Code tab of the visual editor.

label -- Text that is to appear as an item in the list. When a user clicks this text, all the property settings related to this label are applied.

## Attributes for Property tag

name -- Property name. For existing BI objects, this must be a valid property name. For session variables, you create a custom name.

targetObject -- Name of the object to which this property setting applies or <session variable> if this is a custom property that is to be stored on the session.

type -- Data type of the property. This attribute is generated by the wizard.

value -- The value that specifies the property setting.

## Usage cases

A usage case for the PropertySettingsList tag is to display a list in which each item represents a different setting of the graph type property for a graph. This PropertySettingsList might give users the option of selecting one of the following text links: Bar, Pie, Horizontal Bar.

For this example, the PropertyGroup tags use the labels: Bar, Pie, Horizontal Bar. Within each PropertyGroup there is only one Property tag and it specifies a setting for the graphType property of a specific target graph object.

A more complicated example might set multiple properties (such as background color or font size) for the graph or for other target objects.