Overview


The titles of pages and visualizations as well as the visualization descriptions can be set to change with the selections done on the visualization axes. This can be accomplished either using the built-in "axis visualization properties" or by setting up custom document properties. Document properties can, in turn, be controlled via property controls in the text area.

Note: If you have specified a dynamic title or description and then change the setup of the visualization by removing all columns from an axis included in the title or description, you may end up with unexpected blank sections in the title or description. Try to consider how you and other users of the analysis intend to modify the visualization before you specify what to include.

Example – The Default Scatter Plot Title:

The factory default title of a new scatter plot in Spotfire 5.5 and forward is constructed by the display names used on the axes of the visualization:

dyn_titles_scatter_plot_example.png

When the axes are changed, then the title of the visualization is automatically updated:

dyn_titles_scatter_plot_example_modified.png

Example - Setting Up a Dynamic Bar Chart Title:

The factory default title for a new bar chart visualization is "Bar Chart":

dyn_titles_bar_chart_example.png

However, you might want to use a dynamic title instead, which contains the display names used on the axes of the bar chart. Right-click on the visualization and select Properties from the pop-up menu. On the General page, click Edit....

dyn_titles_bar_chart_example_edit_title_dialog.png

Here, you can select the properties of interest and insert them into the Title expression field. You can also type additional information in plain text. For example, the following expression includes the display names for the X- and Y-axes and also the color axis:

${Axis.Y.DisplayName} per ${Axis.X.DisplayName}, split by ${Axis.Color.DisplayName}

This would result in the following title, using the same visualization setup as above:

dyn_titles_bar_chart_example_dynamic.png

Example – Dynamic Description Updated Using a Property Control

If you are using custom properties to control what is shown in your analysis, you can also let the current property value be a part of the title or description of a visualization. In this example, a document property called MeasureColumnSelection has been used to set what is shown on the Y-axis of a bar chart. A property control in the text area allows you to change the value of the property:

dyn_titles_property_example.png

When the value of the property is changed using the property control, the visualization is updated:

dyn_titles_property_example_modified.png

The expressions used in this visualization were:

And the property control used fixed values with display names:

dyn_titles_property_example_control.png

See also:

Working with Dynamic Titles and Descriptions

Visualization Properties in Expressions

Properties in Expressions

Using Properties in the Analysis

Details on Property Control