Create a dashboard
To create a dashboard and display its table of contents, follow these steps:
-
Click Create → Dashboard in the upper-right corner of your workbook page.
-
Give a name to your dashboard and click Create.
Note
This configuration is a segment in the overall description of Visualization assets in the workbook. For the complete tutorial, see Use Visualization API.
A dashboard is the final asset to describe when creating a configuration for the contents of your workbook. The reason for this is that the dashboard must contain the descriptions of all the charts and widgets you want to add to it.
The structure of the dashboard description is the following:
-
Describe the first tab. Any dashboard must contain at least a single tab.
-
Describe the items in a tab:
-
The element
id
. It must be unique within the workbook. -
The
element
properties:-
kind
- the type of element to put into the tab container -
tabs
- the element's credentials.For example, a
charts_container
element needstitle
,id
andchart_name
as credentials. -
hide_title
- aboolean
responsible for hiding or displaying the element's title in the dashboard.
-
-
The element
placement
. Described with integer numbers for the following coordinate values:Tip
The placement grid consists of
36
columns, each height unit equals18
pixels.X
andY
parameters start from0
.-
x
- the position on the horizontal axis. -
y
- the position on the vertical axis. -
w
- the width of the element. -
h
- the height of the element.
-
-
API example
- name: main_dash
dashboard:
tabs:
- title: Default
id: default
items:
- id: tiid_chart_0
element:
kind: charts_container
tabs:
- id: wtid_ch_area_sales_per_week_per_cat
chart_name: ch_area_sales_per_week_per_cat
hide_title: true
placement:
x: 0
y: 2
w: 9
h: 9
ignored_connections: []
Display the table of contents
In the breadcrumbs line on top of your dashboard page,
click
Add charts and widgets
On your dashboard, you can add previously created charts.