Striim 3.9.6 documentation

Properties common to multiple visualization types

Note

 If the visualization configuration  dialog's properties display no fields,  that means something is wrong with its query, or the application has not been deployed.

Data Retention Type: Select All to include all data from the query, or Current to include only the most recent. "All" is not supported for pie / donut charts as they would quickly become unreadable.

Group By: If specified, each value for this field will be visualized as a single point, bar, or slice. This setting interacts with Data Retention Type as follows:

Data Retention Type

Group By

behavior

All

unspecified

one new chart element for each value (for example, ever more bars are added to a chart)

All

specified

  • one chart element per Group By category

  • each new value for a category is added to the element (for example, a vertical bar gets ever higher)

Current

unspecified

only one chart element, which is updated for each new value (this setting would make sense for a gauge, which displays only a single value)

Current

specified

  • one chart element per Group By category

  • each new value for a category updates the element (for example, a vertical bar goes up and down)

The following shows the effect of the various combinations of Data Retention Type and Group By on a bar chart as each of four values (represented by red, yellow, green, and blue) is added.

retention_group_by.png

Color By: If specified, values from this field will populate the legend and (unless overridden by conditional colors) the color of chart elements.

Data Series + / Delete series : For scatter plots and bar, line, pie and donut charts, adds or removes a data series.

Series Alias: When you have defined multiple series, use this to define custom colors. These strings are also used for the legend labels, if any. See the line chart on the PosApp "Company details" page for an example.

Note

If you define multiple series, leave Group By unspecified.

Type (for X and Y axes): select Linear or Logarithmic for numerical values, DateTime for time values, or Category for text values (for example, CompanyName)

Filter settings - Visible: If enabled, when the visualization's data is being filtered, a pop-up will appear showing the filter criteria. See Creating links between pages.

Time Field: A field of type DateTime to use when filtering by time (see Viewing dashboards). If not specified, filters will use WAction start time.

Polling: See Defining dashboard queries.

Drill Down and Page Filters: See Creating links between pages and Making visualizations interactive.

Tooltip Configuration: Use this to defines which values will appear when you hover the mouse pointer over a map or chart point, slice, or bar. Check Show All to display all values selected by the query or click Add Another as many times as necessary to select individual fields.

Add a conditional color: Allows you to manually select colors based on JavaScript expressions, such as field_name=="value". For example:

create_chart_7.png

The seriesAlias variable may be used to manually assign colors to series based on their Series Alias settings. For example, from the line chart on the Company details page in the PosApp sample application's dashboard:

Screen_Shot_2015-10-02_at_6.01.45_PM.png

The above settings produce this result:

Screen_Shot_2015-10-02_at_6.02.10_PM.png

Show Legend: Check to display a legend of the Color By values in the visualization.

Maximum number of values to show / Maximum number of series to show: A series is an element in a visualization that may include one or more values. For example, in the line chart above, there are four series (the four lines) and 40 values (the number of points per line). If you specify a Group By field, the number of distinct values in that field is the number of series.

The maximum number of values is per series, so, for example, if for the chart above it was set to 20, each of the four lines would have 20 points. The oldest value and the series that was updated least recently will be removed from the visualization as necessary to keep within the maximums.

Be sure you set these maximums high enough to display all the desired values. For example, in the map on the main page of PosAppDash, Maximum number of series to show needs to be at least 423 (the number of merchants), but Maximum number of values to show can be 1, since only one point is shown for each merchant.

Regardless of this setting, each visualization can display a maximum of about 2000 values.