Attribute selectors

Introduction

An Attribute selector enables end users to select which attributes are used in a chart. End users can decide how to subdivide a chart by using attribute selectors.

Creating an Attribute selector

Follow these steps to create an attribute selector.

Step	Action
1	Open the app in your development environment, and go to the Data tab.
2	In the table item list, right-click on the table that contains the attributes you want to use in a selector and select New control - Selector.... A selector New selector is added in the table item list.
3	Double click on New selector to open the Edit Control dialog.
4	Right click on the Selector items panel and select Add…. See illustration below.
5	Select the datasource attributes you want to add to the selector and click on OK (2x).

Setting a default value

The default value for attribute selectors differs from other filters. Since it refers to a specific attribute the uid function must be used to refer the attribute. For other filters the default value can be configured as a text value.

Follow these steps to set the default value for an attribute selector.

Step	Action
1	In the Edit Control dialog, click on `expression` next to Default value.
2	Enter the expression `uid([attribute[)` , for example `uid(Invoice_owner)`. Note: [attribute] must be one of the attributes available in the selector.

Adding an additional level to the selector

The attributes which are most relevant for the end user to manipulate are added to the selector for quick access, whereas other, less relevant, attributes can be added to the More... items.

Step	Action
1	In the Edit Control dialog, right click in the “More…” items panel and select Add….
2	Select the dastasource attributes you want to add to the selector and click on OK (2x).

A new entry More... is added to the attribute selector. When a user clicks on this entry the Select An Attribute dialog opens in which the user can select the additional attributes. See illustration below.

Extra options

The Edit Control dialog contains several useful options that are available for attribute selectors. For example:

Use the Allow empty selection option in the General panel to control whether or not a user is forced to always select one attribute in the selector.
Use Hide name for end user in the Other panel to control whether or not the name of the attribute selector is visible to end users.
Use Custom dots in the Other panel to control what is shown when no attribute is selected or in the drop-down menu when an empty selection is selected.

Using the Attribute selector on a chart

Follow these steps to add the attribute selector on a chart

Step	Action
1	Go to the Dashboards tab and create a new dashboard based on the table in which the attribute selector control is present.
2	Go to the Chart tab.
3	Select the attribute you want to display in the chart from the Rows drop down list.
4	Select the attribute selector control from the Metric drop down list.
5	Drag the attribute selector control to the Header controls of the chart.

Using the Attribute selector on a Legacy chart

Follow these steps to add the attribute selector on a legacy chart.

Step	Action
1	Go to the Dashboards tab and create a new dashboard based on the table in which the attribute selector control is present.
2	Go to the Chart tab.
3	Drag attribute selector to the Rows level in the General panel.