Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

Chart (Formally known as SQL Chart) allows you to define

...

your own SQL query to determine the charts that you would like to generate, ranging from a number of graph types.

Image RemovedImage Added

Figure 1: SQL Chart Properties

NameDescription
Custom ID

Item link slug. Optional field.

Info
titleUnique field

Value defined here must be unique to the rest of the Userview Menus as the first matching name will be called upon.

LabelMenu label. Mandatory field.
Chart Type
  • Area Chart
  • Bar Chart
  • Bubble Chart
  • Candlestick Chart
  • Donut Chart
  • Line Chart
  • Open High Low Close Chart (OHLC Chart)
  • Pie Chart
  • XY Chart
Chart Title

Chart Title to be displayed part of the generated graph.

Image Removed

Figure 2: SQL Chart Properties - Chart Options

NameDescription
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, legend will be shown in the generated graph.
Show Value Label in Chart?
If checked, value label will be shown in the generated graph.
Width 

Width in character.

Code Block
titleExample
100%
Height 

Height in character.

Code Block
titleExample
300px
Colors

Series color. Optional field.

Comma separated values (CSV) of color codes.

Example:

Code Block
titleExample
 #3333FF,#66FF00,#FF9933,#990000

Image Removed

Code Block
titleExample
red,orange,yellow,green,blue,indigo

Image Removed

Info
titleWhat are the default colors?

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

Figure 3: SQL Chart Properties - SQL

Panel
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

This feature has been enhanced in Joget Workflow v6 to support join, group and aggregate function.

Image Added

Figure 2: SQL Chart Properties - Datasource

NameDescription
Datasource
  • Using Data Binder
  • Default Datasource
  • Custom Datasource
Panel
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titleNew Feature

New feature in Joget Workflow for more flexible ways to build chart dataset using the existing Datalist Binders.

Data Binder

When Datasource is set to "Using Data Binder", this option will show up.

Please see Datalist Binder for available binder to use.

SQL Query

When Datasource is set to use any of the "Datasource", this option will show up.

SQL

NameDescription
SQL Query 
SQL

Query to produce the dataset required for the graph type.

Info

The first column in the dataset will be assumed for X-axis/label.

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

Example 1:

Code Block
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

Image Modified

Example 2:

Code Block
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_hr_expense_claim c group by c.c_claimant

Image Modified

Image Modified


Image Added

Figure 43: SQL Chart Properties - UIData Binder & Chart Data Mapping (applicable for - using Data Binder)

NameDescription
Custom HeaderCustom Header in HTML.Custom FooterCustom Footer in HTML.
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.

Image Added

Figure 4Figure 5: SQL Chart Properties - AdvancedChart Options (applicable for - using Datasource)

NameDescription
Datasource
  • Default Datasource
  • Custom Datasource
If the default datasource is selected, the custom JDBC settings below will be ignored.
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, legend will be shown in the generated graph.
Show Value Label in Chart?
If checked, 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.
Width 

Width in character.

Code Block
titleExample
100%
Height 

Height in character.

Code Block
titleExample
300px
Colors

Series color. Optional field.

Comma separated values (CSV) of color codes.

Example:

Code Block
titleExample
 #3333FF,#66FF00,#FF9933,#990000

Image Added

Code Block
titleExample
red,orange,yellow,green,blue,indigo

Image Added

Info
titleWhat are the default colors?

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

Image Added

Figure 5: SQL Chart Properties - Advanced

NameDescription
Userview Key Name

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

Info
titleExample

SQL: SELECT category, count(category) FROM table1

Userview Key Name: type

Userview Key Value: val

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

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

Info
titleExample

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

Userview 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.

Interactive Chart

The following code can be modified and put in "Custom Footer" for interactive Chart.

...

Note

 This code does not work with OHLC and candlestick chart.

Panel
borderColorpurple
borderWidth1
titleBGColor#ddccff
borderStylesolid
titlePerformance

You can configure the Performance settings in this Userview Element which allows one to cache existing content for improved performance and loading speed. Read more at Performance Improvement with Userview Caching.