Node - dash

Owned by Verba Support (Unlicensed)
Sept 24, 2012
3 min read

Description

<dash> is the main node, it is also called the document element. This element is mandatory, the XML document has to be started with <dash> and ended with </dash>. Widget configuration is stored between these tags.

Attributes

id

Mandatory, has to be a unique number amongst the existing XML files, to identify the widget on a saved dashboard.
widgetTypeLangName The name of the widget that will appear in the Widget Type drop-down list on the Dashboard Widget Configuration panel. It must be a lang file name and a key name in that lang file separated by a dot.
xAxis A column name in the result set of the SQL query, which makes up the X-axis values of the chart.
yAxis A column name in the result set of the SQL query, which makes up the Y-axis values of the chart.
xAxisLangName The label of the X-axis, treated in the same way as the widgetTypeLangName attribute. This text is displayed under the X-axis of the chart.
yAxisLangName The label of the Y-axis, treated in the same way as the widgetTypeLangName attribute. This text is displayed under the Y-axis of the chart.
zAxisLangName Used only with the Table display method, where three columns are required. Available only when Scatter chart is defined, this attribute represents the name of the third column. For further information, check out thedisplayMethods node.
seriesId

Mandatory, has to be a column name from the result set of the SQL query. This is used by charts with multiple series (like the Group Performance Trend), and represents the third dimension of the chart.

This is mandatory, even when the chart is made of one series (like Top Performing Agents). A fix value has to be used from the result set, like in Top Performing Agents the seriesId='id' is mapped to the column generated by this SQL '1 as id'. This way you will only have one series.
seriesName

Mandatory, has to be a column name from the result set of the SQL query, used by charts with multiple series.

If the chart is made of only one series, a dummy value has to be used, like in Top Performing Agents: seriesName='series_name' and the SQL mapped to this is : " as series_name".

If the chart is made of multiple series, the seriesName will represent the name of each series, like in Groups Performance Trend: seriesName='group_name' and the column of the result set mapped to this is "(SELECT name FROM [Group] g WHERE g.Group_ID=ug.Group_ID) as group_name)"
numberSuffix This sign will be displayed after each value of the Y-axis. (e.g.: '%' or '$').
category Mandatory, can be 'qm' or 'call', depending on whether the category of the Widget Typedrop-down where the widget belongs to is Quality Management Widgets or Call Activity Widgets.