> Template dashboard object

The following objects are directly related to the templatedashboard API.

Template dashboard

The template dashboard object has the following properties.

PropertyTypeDescription
dashboardidstringID of the template dashboard.

Property behavior:
- read-only
- required for update operations
namestringName of the template dashboard.

Property behavior:
- required for create operations
templateidstringID of the template the dashboard belongs to.

Property behavior:
- constant
- required for create operations
display_periodintegerDefault page display period (in seconds).

Possible values: 10, 30, 60, 120, 600, 1800, 3600.

Default: 30.
auto_startintegerAuto start slideshow.

Possible values:
0 - do not auto start slideshow;
1 - (default) auto start slideshow.
uuidstringUniversal unique identifier, used for linking imported template dashboards to already existing ones. Auto-generated, if not given.

Template dashboard page

The template dashboard page object has the following properties.

PropertyTypeDescription
dashboard_pageidstringID of the dashboard page.

Property behavior:
- read-only
namestringDashboard page name.

Default: empty string.
display_periodintegerDashboard page display period (in seconds).

Possible values: 0, 10, 30, 60, 120, 600, 1800, 3600.

Default: 0 (will use the default page display period).
widgetsarrayArray of the template dashboard widget objects.

Template dashboard widget

The template dashboard widget object has the following properties.

PropertyTypeDescription
widgetidstringID of the dashboard widget.

Property behavior:
- read-only
typestringType of the dashboard widget.

Possible values:
clock - Clock;
graph - Graph (classic);
graphprototype - Graph prototype;
item - Item value;
plaintext - Plain text;
url - URL.

Property behavior:
- required
namestringCustom widget name.
xintegerA horizontal position from the left side of the dashboard.

Valid values range from 0 to 23.
yintegerA vertical position from the top of the dashboard.

Valid values range from 0 to 62.
widthintegerThe widget width.

Valid values range from 1 to 24.
heightintegerThe widget height.

Valid values range from 2 to 32.
view_modeintegerThe widget view mode.

Possible values:
0 - (default) default widget view;
1 - with hidden header;
fieldsarrayArray of the template dashboard widget field objects.

Template dashboard widget field

The template dashboard widget field object has the following properties.

PropertyTypeDescription
typeintegerType of the widget field.

Possible values:
0 - Integer;
1 - String;
4 - Item;
5 - Item prototype;
6 - Graph;
7 - Graph prototype.

Property behavior:
- required
namestringWidget field name.

Property behavior:
- required
valuemixedWidget field value depending on type.

Property behavior:
- required