Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Removed translated content for 'zh'
Sv translation
languageen

Bar chart

JSON used as input for Bar chart rendering consists of multiple elements.

Table of Contents
minLevel3

Basic structure

Code Block
{
  "x_axis": {
    "labels": {
      "labels": [ ... ]
    }
  }
  "y_axis": {
    "labels": {
      "labels": [ ... ]
    }
  }
  "elements": [
    {
      "type": "bar",
      "values": [ ... ]
    }
  ]
}

Common elements

NameDescriptionExample
chartId
Chart view identifier. Refer to REST API.
chart_3-FDEp6Q41fb_s3fwVc7F9H
bg_color
Defines the color of the background for the entire chart
#e5e5e5
is_decimal_separator_comma
Determines whether to use comma as decimal separator. [0, 1]1
is_thousand_separator_disabled
Determines whether to use the thousands separator or not. [0, 1]1
tooltip

Defines the basic tooltip settings for the entire chart.

NameDescriptionExample
mouse
Mouse sensitivity2
shadow
[true, false]true
stroke
[0, 1]1
colour
Default font color for tooltips
#202020
background
Default background for tooltips.
"#ffffff"
 

Example

Code Block
{
	"chartId": "chart_3-FDEp6Q41fb_s3fwVc7F9H",
	"bg_colour": "#e5e5e5",
	"is_decimal_separator_comma": 1,
	"is_thousand_separator_disabled": 1,
	"tooltip": {
	    "mouse": "2",
    	"shadow": true,
	    "stroke": 1,
	    "colour": "#202020",
	    "background": "#ffffff"
	},
	"options": {}
} 

"x_axis" content

NameDescriptionExample
colour
Color of the axis label
#c7c7c7
grid-colour
Color of the x-axis grid (horizontal)
#c7c7c7
labels

Nested object defining the axis labels

NameDescriptionExample
colour
Color of the labels
#4e4e4e
labels
Array of labels to display.
[ "Austria", "Canada", "France", "Germany" ]
 

Example:

Code Block
 "x_axis": {
    "colour": "#c7c7c7",
    "grid-colour": "#c7c7c7",
    "labels": {
       "colour": "#4e4e4e",
       "labels": [ "Austria", "Canada", "France", "Germany" ]
    }
 },

"y_axis" content

Y axis is defined by min and max value, size of one step (steps) and labels. Each label consists of value on Y axis (y) and displayed text. You can specify also colour and grid-colour for Y axis.

NameDescriptionExample
colour
Color of the axis label
#e9e9e9
grid-colour
Color of the y-axis grid (vertical)
#e9e9e9
steps
Size of the steps of the axis100000
min
Minimal value displayed on the axis0
max
Maximal value displayed on the axis800000
labels

Nested object defining the axis labels

NameDescriptionExample
colour
Color of the labels
#4e4e4e
labels
Array of label and values
[ { "text": "0 USD", "y": 0 }, { "text": "100.000 USD", "y": 100000 } ]
 

 

Example:

Code Block
"y_axis": {
    "colour": "#e9e9e9",
    "grid-colour": "#e9e9e9",
    "steps": 100000,
    "min": 0,
    "max": 800000,
    "labels": {
      "colour": "#4e4e4e",
      "labels": [
        { "text": "0 USD", "y": 0 },
        { "text": "100.000 USD", "y": 100000 },
        { "text": "200.000 USD", "y": 200000 },
        { "text": "300.000 USD", "y": 300000 },
        { "text": "400.000 USD", "y": 400000 },
        { "text": "500.000 USD", "y": 500000 },
        { "text": "600.000 USD", "y": 600000 },
        { "text": "700.000 USD", "y": 700000 },
        { "text": "800.000 USD", "y": 800000 }
      ]
    }
  }

"elements" content

Each object in array elements describe one chart element. In example below we have only one element with text Revenue, that has type bar and contains array with 4 values. Each value object consists of label, tool tip, top, context. Colour is specified at the end of this element.

NameDescriptionExample
type
Type of the chart. For bar chart, the value is "bar"bar
text
Name of the chart 
font-size
Font size used for displaying text 
colour
Color used for displayed text 
values
NameDescriptionExample
top
Numerical value specifying the top position of a bar12345.4567
tip
Tooltip text to display on mouse hoverThis is tooltip
label
Value label displayed at the top of a bar (optional)This is label
context
If defined, context will be send to the client as event parameter 
 
Code Block
 "elements": [
    {
      "type": "bar",
      "text": "Revenue",
      "font-size": 10,
      "colour": "#4379bd",
      "values": [
        {
          "top": 444835.123456789,
          "tip": "Austria\n444835.1",
          "label": "444.835",
          "context": "{\"dataLink\":\"3_-2043221543\",\"identifierQuery\":\"[L_COUNTRY={Austria}]\"}"
        },
        {
          "top": 730974,
          "tip": "Canada\n730974",
          "label": "730.974",
          "context": "{\"dataLink\":\"3_-1852385212\",\"identifierQuery\":\"[L_COUNTRY={Canada}]\"}"
        },
        {
          "top": 546650,
          "tip": "France\n546650",
          "label": "546.650",
          "context": "{\"dataLink\":\"3_-1863819183\",\"identifierQuery\":\"[L_COUNTRY={France}]\"}"
        },
        {
          "top": 643782.34,
          "tip": "Germany\n643782.3",
          "label": "643.782",
          "context": "{\"dataLink\":\"3_-547347785\",\"identifierQuery\":\"[L_COUNTRY={Germany}]\"}"
        }
      ]
    }
  ]

Examples

Attachments
uploadfalse
oldfalse
sortByname

 

Sv translation
languageja

棒チャート

棒チャートレンダリングの入力として使用されるJSONは、複数の要素で構成されています。

Table of Contents
minLevel3

基本的な構造

Code Block
{
  "x_axis": {
    "labels": {
      "labels": [ ... ]
    }
  }
  "y_axis": {
    "labels": {
      "labels": [ ... ]
    }
  }
  "elements": [
    {
      "type": "bar",
      "values": [ ... ]
    }
  ]
}

共通の要素

名前説明
chartId
チャートビュー識別子。 RESTAPIをご参照してください。
chart_3-FDEp6Q41fb_s3fwVc7F9H
bg_color
チャートの全体に背景の色を定義します
#e5e5e5
is_decimal_separator_comma
小数点記号としてカンマを使用/非使用を決定します。 [0, 1]1
is_thousand_separator_disabled
桁区切りを使用/非使用を決定する。 [0, 1]1
tooltip

チャートの全体に基本的なツールチップの設定を定義します。

説明
mouse
マウス感度2
shadow
[true, false]true
stroke
[0, 1]1
colour
ツールチップのの色フォントデフォルト
#202020
background
ツールチップの背景デフォルト
"#ffffff"
 

Code Block
{
	"chartId": "chart_3-FDEp6Q41fb_s3fwVc7F9H",
	"bg_colour": "#e5e5e5",
	"is_decimal_separator_comma": 1,
	"is_thousand_separator_disabled": 1,
	"tooltip": {
	    "mouse": "2",
    	"shadow": true,
	    "stroke": 1,
	    "colour": "#202020",
	    "background": "#ffffff"
	},
	"options": {}
} 

「x_axis」コンテンツ


名前説明
colour
軸ラベルの色
#c7c7c7
grid-colour
x軸グリッドの色(水平方向)
#c7c7c7
labels

軸ラベルを定義するネストされたオブジェクト

説明
colour
ラベルの色
#4e4e4e
labels
表示用ラベルの配列
[ "Austria", "Canada", "France", "Germany" ]
 

Code Block
 "x_axis": {
    "colour": "#c7c7c7",
    "grid-colour": "#c7c7c7",
    "labels": {
       "colour": "#4e4e4e",
       "labels": [ "Austria", "Canada", "France", "Germany" ]
    }
 },

「y_axis」コンテンツ

Y軸は、最小値と最大値、一つステップのサイズ(ステップ)とラベルによって定義されます。各ラベルは、Y軸(y)上に値が含まれて、テキストを表示しました。また、Y軸の色グリッドを指定できます。

名前説明
colour
軸ラベルの色
#e9e9e9
grid-colour
y軸グリッドの色(垂直)
#e9e9e9
steps
軸ステップサイズ100000
min
軸上に表示した最小値0
max
軸上に表示した最大値800000
labels

軸ラベルを定義するネストされたオブジェクト

名前説明
colour
ラベルの色
#4e4e4e
labels
ラベルと値の配列
[ { "text": "0 USD", "y": 0 }, { "text": "100.000 USD", "y": 100000 } ]
 

 

Code Block
"y_axis": {
    "colour": "#e9e9e9",
    "grid-colour": "#e9e9e9",
    "steps": 100000,
    "min": 0,
    "max": 800000,
    "labels": {
      "colour": "#4e4e4e",
      "labels": [
        { "text": "0 USD", "y": 0 },
        { "text": "100.000 USD", "y": 100000 },
        { "text": "200.000 USD", "y": 200000 },
        { "text": "300.000 USD", "y": 300000 },
        { "text": "400.000 USD", "y": 400000 },
        { "text": "500.000 USD", "y": 500000 },
        { "text": "600.000 USD", "y": 600000 },
        { "text": "700.000 USD", "y": 700000 },
        { "text": "800.000 USD", "y": 800000 }
      ]
    }
  }

「要素」コンテンツ

配列要素内の各オブジェクトは、1つのチャート要素を記述します。上記の例では、棒タイプ を持つRevenueテキストを持つ要素が1つしかなく、4の値を持つ配列が含まれています。各値オブジェクトは、ラベル、ツールチップ、値、コンテキストハイライトで構成されています。カラーはこの円チャートの要素の最後に指定されます。

名前説明
type
チャートのタイプ。棒チャートの場合に値は「バー」としますbar
text
チャート名 
font-size
テキストを表示するために使用されるフォントのサイズ 
colour
表示されたテキストに使用されるカラー 
values
説明
top
バーの上部の位置を指定する数値12345.4567
tip
マウスのホバーに表示用テキストツールチップThis is tooltip
label
バーの上部に表示される値ラベル(オプション)This is label
context
定義されている場合、コンテキストがイベントパラメータとしてクライアントに送信されます。 
 
Code Block
 "elements": [
    {
      "type": "bar",
      "text": "Revenue",
      "font-size": 10,
      "colour": "#4379bd",
      "values": [
        {
          "top": 444835.123456789,
          "tip": "Austria\n444835.1",
          "label": "444.835",
          "context": "{\"dataLink\":\"3_-2043221543\",\"identifierQuery\":\"[L_COUNTRY={Austria}]\"}"
        },
        {
          "top": 730974,
          "tip": "Canada\n730974",
          "label": "730.974",
          "context": "{\"dataLink\":\"3_-1852385212\",\"identifierQuery\":\"[L_COUNTRY={Canada}]\"}"
        },
        {
          "top": 546650,
          "tip": "France\n546650",
          "label": "546.650",
          "context": "{\"dataLink\":\"3_-1863819183\",\"identifierQuery\":\"[L_COUNTRY={France}]\"}"
        },
        {
          "top": 643782.34,
          "tip": "Germany\n643782.3",
          "label": "643.782",
          "context": "{\"dataLink\":\"3_-547347785\",\"identifierQuery\":\"[L_COUNTRY={Germany}]\"}"
        }
      ]
    }
  ]

 

Attachments
uploadfalse
oldfalse
sortByname