Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: image resizing to 1000px for all images

...

Chart menu allows you to select a form binder or define your own SQL query to display the chart data for the most common graph types. You can also include charts in your userview Dashboard Menu.

Image Modified

Chart Menu Properties

Configure Chart Menu

...

ID: Menu element unique id. Userview will use this id in the URL for the menu if the Custom ID is empty.

...

...

Custom ID

...

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

Label

...

Menu 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 as part of the generated graph.

Image Added

Figure 1: Edit Chart Properties

Configure Datasource

...

...

Datasource: 

  • Using Data Binder
  • Default Datasource
  • Custom

...

Image Removed

...

  • Datasource

Data Binder

...

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

SQL Query

...

:  When Datasource is set to use any of the "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

...

Image Added

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

Image Added

Image Removed

...

Image Added


Image Added

Figure 2: SQL Chart Properties - Datasource


Data Binder & Chart Data Mapping

...

Order By

...

: Column to be sorted in the graph dataset. This would affect how the graph is plotted.

...

Image Removed

Figure 3: Figure 3: Data Binder & Chart Data Mapping Properties

...

Order: 

  • ASC
  • DESC

X-axis Value

...

: X-axis label. 

Y-axis Values

...

: Y-axis dataset.

Image Added

Figure 3: Figure 3: Data Binder & Chart Data Mapping Properties

Chart Options Properties

...

X-axis Label: 

...

X-axis

...

Image Removed
Figure 4: Chart Options

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.

Width: 

...

Width in character, for example 100%.

Height: 

...

Height in character, example 300px.

Colors

...

Series color. Optional field.

Comma-separated values (CSV) of color codes.

Image Added

Figure 4: Chart Options

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

...

Image Added

Example 2: 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

Advanced Properties

...

Userview Key Name

...

When defined, the additional conditions 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'

...

Figure 5: Advanced Properties

Custom Header

...

Custom Header in HTML.

Custom Footer

...

Custom Footer in HTML.


Image Added

Figure 5: Advanced Properties

Performance & Offline Properties

...

Display Labels Outside the Pie Chart

Image Modified

The following code can be modified and put in "Custom Header" for displaying the labels outside of the pie chart.

...