Configure an element

After an element has been added to a dashboard, it needs to be configured. When you add an element to your dashboard, the configuration window for that element opens. You can also open an element's configuration from the Layout panel by clicking the Options button Options next to the element and clicking Configure, or by hovering over the element on the dashboard and clicking the Configure button Configure. The exact configuration details for each element differ. The following topic includes general configuration information. For configuration details specific to an element, see that element's topic in the help.

Many elements have too many configuration settings to fit on one screen. When this occurs, a series of tabs appear in the configuration window. Each tab includes options that correspond to a particular aspect of configuring that element. The following image shows the configuration window for a serial chart, with the Data tab open.

Example of element configuration

Note:

When an element does not need more than one tab to capture all the necessary configuration information, no tabs appear. For example, header, sidebar, and rich text do not have tabs.

To understand the settings on the various tabs, think of the element as having three distinct areas: a title area, an area for the visualization, and a description area, which are labeled 1, 2, and 3, respectively, in the following image. The title and description areas are configured on the General tab. The visualization area is based on settings configured on the Data tab (if applicable) and any other element-specific tabs you see.

Element areas

General settings

In many cases, the general settings for an element appear on the General tab, although not all elements have tabs. The most common general settings are described below:

  • Name—When each element is added to a dashboard, it is assigned a name. If your dashboard will be a static representation of data, you can leave the default name. However, if your dashboard will provide a more interactive experience, assigning an easy-to-interpret name makes configuring dashboard actions easier.
  • Title—An area at the top of the element to place a title or other useful information. This information is configured as rich text. See Effective use of HTML for more information. If a title is not specified, this area can be occupied by the data visualization. Titles larger than 30 percent of an element's height will cause scroll bars to appear. If you need to add a lot of text, consider using a rich text element and grouping it to the element being configured instead.
  • Description—An area at the bottom of the element to place useful information. This information is configured as rich text. See Effective use of HTML for details. If a description is not specified, this area can be occupied by the data visualization. Descriptions larger than 30 percent of an element's height will cause scroll bars to appear. If you need to add a lot of text, consider using a rich text element and grouping it to the element being configured instead.
  • Last update text—Displays the last time the element's layer was refreshed. When enabled, it appears in the lower corner of the element's description area.
  • No data—For data-driven elements, choose to configure a label that displays when there is no data to render on the element. By default, an element in this state will display the label No Data.
  • No selection—When elements are configured to render only when a selection is made using the Render only when filtered option, choose to configure how the element displays before rendering. By default, an element in this state displays the label Selection required on one or more elements.

Data settings

Most dashboard elements are data driven and require that you select their data source as the first step of configuring them. In the case of the map element, you are prompted to select a web map. In the case of other elements, such as indicator, gauge, list, and details, you are prompted to select a layer or data expression.

Tip:

If you have previously added other elements to the dashboard, their data sources will appear as options you can select when adding new elements. For example, if you have previously added a map element, its operational layers will appear as potential data sources when adding other elements.

When configuring a data-driven element, a Data tab is available. On this tab, you can change the data source, and apply and configure filters. You can also apply filters. For some element types, there are also element-specific data settings. For example, both the indicator and gauge elements have a Value conversion setting that is used to convert values from one unit of measure to another at run time.

As you configure your element, you can preview your visualization in the preview area. For data-driven elements, you can click Data table in the preview area to expand the attribute table for your data source.