The important information that every script chart developer should know, is that a Scripted Chart has 2 parts:

  1. script that is responsible for collecting data and preparing it for display
  2. a Javascript layout


(info) We will explain both parts with examples, but keep in mind, that programming skills are required in order to be able to develop own custom script charts.



Data Script

The script will be written in Groovy language (or Java), and is responsible for collecting the data and formatting/grouping it as needed in the chart.

Our xChart API provides some helper classes for creating the scripts.

What the chart needs to return, is a JSON Object (chartData), which will be the input for the javascript layout. You can return our ready-to-use ChartData Object or just return a String which contains valid JSON. This JSON value will be available as the param chartData in the JavaScript script.

Parameters are available as Variables. To get the variable name of a parameter you can just click on the name and the variable will be inserted in the script where at the point of the cursor.

Javascript Layout

The layouts are created with the help of the c3.js library. Following the documentation on their website, you can create your own layouts.

Overview of Scripting Examples

Simple Timeseries Chart


Simple Table Report


Report - Lucene Group By


Simple External Database Chart


Customers in a Google Map

Issues in specific status (Period)


Open issues with average


Additional Chart Scripting Examples



On this page