Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NameDescription
Datasource

Select the datasource for the chart.

  • Default Datasource
  • Custom Datasource
    • Figure 2a: SQL Chart Properties - Custom Datasource

       
  • Load Data From
    • Figure 2b: SQL Chart Properties - Load Data From

  • Using List
    • Figure 2c: SQL Chart Properties - Using List

SQL Query

When Datasource is set to "Default Datasource" or "Custom Datasource", this option will show up. You use an SQL Query to produce the dataset required for the graph type. The first column in the dataset will be assumed for the X-axis/label.

Example 1:The first column to be returned from the query must be a label (X-axis), followed by value columns for the Y-axis.

Code Block
languagesql
titleExample
SELECT
    c_status AS 'status',
    COUNT(c_status) AS 'count' 
FROM
    app_fd_tix_tickets 
WHERE
    c_status IS NOT NULL 
GROUP BY
    c_status

Example 2:

Code Block
languagesql
titleSQL
SELECT
    c.c_claimant,
    SUM( CAST( replace(c.c_total, '$', '') AS DECIMAL(10, 2)) ) AS 'total',
    AVG( CAST( replace(c.c_total, '$', '') AS DECIMAL(10, 2)) ) AS 'avg' 
FROM
    app_fd_j_expense_claim c 
GROUP BY
    c.c_claimant


Data Store

When Datasource is set to "Load Data From", this option will show up. Advance Form Data Binder has more flexible ways to build chart datasets using join, group, and aggregate functions. Please see Datalist Binder for the available binders to use.

Configure Database

This option is available when the Datasource is set to "Custom Datasource" (Figure 2a).

NameDescription
Database Type

Enter the database type. (example: com.mysql.jdbc.Driver)

Please ensure that the database type entered here is compatible with Joget DX 8. For reference, check this Link.

Target DB URLEnter the Database's URL
UsernameEnter your DB username credential.
PasswordEnter your DB password credential.
Tip
titleTip

For a reference of what the parameters entered into "Configure Database" should look like, check the default Joget Datasource settings, Expand the admin bar then go to Settings>System Settings>Datasource & Profile Settings.

 

Using List
NameDescription
ListSelect the List that the chart will use to plot data.
Chart Dataset

Select the size of the chart's dataset.

  • Current Page Dataset
  • Entire Dataset
Show Tabular Data

This option allows you to view the data used to plot the chart in tabular form.

  • No - Do not show the tabular data
  • Top - Show tabular data on top of the chart
  • Bottom - Show tabular data on at the bottom of the chart
Show Export Links

Available when Show tabular data is set to either "Top" or "Bottom". When set to "Yes", this option allows you to export the chart into CSV, Excel, XML or PDF directly from the UI page.

  • Yes
  • No
Show Filters

Available when Show tabular data is set to either "Top" or "Bottom". When set to "Yes", this option allows you to filter the tabular data used to plot the chart from directly from the UI page.

  • Yes
  • No

...

NameDescription
Order ByColumn to be sorted in the graph dataset. This would affect how the graph is plotted.
Order
  • ASC
  • DESC
X-axis Value 
X-axis label. 
Y-axis Values

Y-axis dataset.

NameDescription

Number Value

Select a numeric parameter to be plotted on the Y-axis. This field supports hash variables, app variables and List columns.
Series NameCustom name for the series of values.
Series CustomizationThis field allows you to insert a script that can modify the graph's visualization. (e.g: modify legend position)

Add Row

Add another dataset to be plotted on the Y-axis.

Chart Options Properties

Figure 4: Chart Options

...

NameDescription
Echart Theme
This option appears when Echart Library is selected in Configure Chart (Fig 1).
X-axis Label 
X-axis Label 
X-axis display as
  • Category
  • Number
  • Date
Y-axis Label 
Y-axis Label 
Y-axis Prefix
Y-axis Prefix
Show Legend?
If checked, the legend will be shown in the generated graph.
Show Value Label in Chart?
If checked, the value label will be shown in the generated graph.
Stack Series?
If checked, this will affect the generated graph.
Display as Horizontal Chart?
Display as Horizontal Chart.If checked, the Chart will be displayed horizontally.
No Boundary Gap
If checked, there will be no gap between the axes label and the chart.
Width 

Width in character, for example 100%.

Height 

Height in character, example 300px.

ColorsColours

Series colorcolour. Optional field. This option only appears when jqPlots Library is selected in Configure Chart.

Comma-separated values (CSV) of color codes.

Example 1: #3333FF,#66FF00,#FF9933,#990000


Example 2
: red,orange,yellow,green,blue,indigo

Info
titleWhat are the default colors?

http://stackoverflow.com/questions/18332440/what-are-the-jqplot-default-series-colors

...

Figure 5: Advanced Properties


NameDescription
Series Customization
NameDescription
Series NameCustom name for the series of values.
Series CustomizationThis field allows you to insert a script that can modify the graph's visualization. e.g: tooltip : { "trigger" : "item" , "formatter" : {a} {b} : {c} ({d}%) }

Add Row

Add another dataset to be plotted on the Y-axis.
Additional Customization

This field allows you to insert an additional script that can modify the graph's visualization. (e.g: modify legend position)

UI Key Name

When defined, the additional conditions will be appended using the value defined here as the parameter and the userview UI key value as the value.

Info
titleExample

SQL: SELECT category, count(category) FROM table1

UI Key Name: type

UI Key Value: val

Resultant SQL:  SELECT category, count(category) FROM table1 WHERE type = 'val'

When UI key value is defined, you may define #userviewKey# in your SQL query to have it replaced with the UI key value.

Info
titleExample

SQL: SELECT category, count(category) FROM table1 WHERE type = '#userviewKey#'

UI Key Value: val

Resultant SQL:  SELECT category, count(category) FROM table1 WHERE type = 'val'

Custom Header
Custom Header in HTML.
Custom Footer
Custom Footer in HTML.

Performance & Offline

Figure 6: Chart Properties - Performance & Offline Settings 

...