Page History
Anchor | ||||
---|---|---|---|---|
|
Table of Contents | ||||
---|---|---|---|---|
|
Overview
The following sections outline sample dashboard content developed with DashXML and Yellowfin content. It will explore each of the avilalbe widget types, how they were set up in the XML, and how they were styled through custom CSS.
Note: this is merely a guide in order to walk you through using the DashXML framework for your own dashboard requirements.
The main XML widget types consist of the following:
Code Block | ||||
---|---|---|---|---|
| ||||
<application-definition> <sourcefilter></sourcefilter> <dashboard> <text></text> <exportlist> <export><export> </exportlist> <filter> <options> <summary><summary> </options> </filter> <report> <modal> <subcontent></subcontent> </modal> <filterMap></filterMap> </report> <modal> <subcontent></subcontent> </modal> <customhtml> <replacements></replacements> </customhtml> <subtab> <options> <subcontent></subcontent> <summary></summary> </options> <subtab> </dashboard> </application-definition> |
The full XML structure is outlined on the Widget XML page.
Dashboard Widget
Styleclass | ||
---|---|---|
| ||
Example Output
Example Elements
Expand | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Sub Tab Widget
Styleclass | ||
---|---|---|
| ||
Example Output
Example Elements
Expand | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
<subtab>
<options>For within a sub tab.
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Text Widget
Styleclass | ||
---|---|---|
| ||
<text>
XML Widget. This will simply need to contain the text to be displayed as the title, and a css class name to be used for styling that text.Example Output
Example Elements
Expand | |||||||||
---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Export Button Widget
Styleclass | ||
---|---|---|
| ||
<exportlist>
XML Widget. This will need to define which export formats you wish to allow, and which report to export (if you are using XLS).Example Output
Example Elements
Expand | ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Filter Widget
Styleclass | ||
---|---|---|
| ||
Dates
These can be implemented using the <filter>
XML widget. Each filter widget requires at least one option to be defined, allowing the user to select a value to apply. This particular filter has four options; Custom, Year, Month, and All Time. The Year, Month, and All Time filters have been set up using pre-defined date ranges, while the Custom option was specified as user prompt in order to allow users to specify a custom range.
Example Output
Example Elements
Expand | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Buttons
The filter widget displays possible filter value options that the user can select from. Each option has the capacity to display a title, description, icon, and summary value – all except the title are optional.
Example Output
Example Elements
Expand | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Report Widget
Styleclass | ||
---|---|---|
| ||
Chart
Reports and visualisations can be displayed using the <report>
XML widget. This will need to call the required report, specify the format and styling, and pass through any filters.
Example Output
Example Elements
Expand | |||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Table
Tables can be displayed using the <report>
XML widget. This will need to call the required report, specify the format and styling, and pass through any filter values required.
Example Output
Note: the See All Camps link pictured above is called through this widget, but the contents and display of the modal is actually defined through a modal widget. See the Modal Widget section for details.
Example Elements
Expand | |||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Modal Window Widget
Styleclass | ||
---|---|---|
| ||
<subcontent>
element. The modal itself is called outside of the <modal>
definition, for example as part of a report. For the purpose of this scenario, we have defined the modal link as part of a report (see Table outline above).Example Output
Example Elements
Expand | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Custom HTML Widget
Styleclass | ||
---|---|---|
| ||
Text & Report Data
The data from a report can be used within a <customHTML>
XML Widget along with other elements to produce a combined output. In this scenario, we wanted to display the first date we have records for within the user selected filter date range. To do this we wanted to combine some static text with a date record from a report. The widget needed to contain HTML to display the static text, such as "Your camp started on: ", and the dynamic date element that comes from the result of a Yellowfin report. In order to do this, you will also need to include the report that returns the date as a hidden report.
Example Output
Example Elements
Expand | |||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Example XML
Expand | |||||||
---|---|---|---|---|---|---|---|
|
Example CSS
Expand | |||||||
---|---|---|---|---|---|---|---|
|
horizontalrule |
---|
Styleclass | ||
---|---|---|
| ||