Zabbix Documentation 2.2

2.23.04.04.2 (current)In development:4.4 (devel)Unsupported:1.82.02.43.23.4

User Tools

Site Tools


Sidebar

manual:api:reference:screenitem:object

> Screen item object

The following objects are directly related to the screenitem API.

Screen item

The screen item object defines an element displayed on a screen. It has the following properties.

Property Type Description
screenitemid string (readonly) ID of the screen item.
colspan integer Number of columns the screen item will span across.
resourcetype
(required)
integer Type of screen item.

Possible values:
0 - graph;
1 - simple graph;
2 - map;
3 - plain text;
4 - hosts info;
5 - triggers info;
6 - server info;
7 - clock;
8 - screen;
9 - triggers overview
10 - data overview;
11 - URL;
12 - history of actions;
13 - history of events;
14 - latest host group issues;
15 - system status;
16 - latest host issues.
rowspan integer Number or rows the screen item will span across.
screenid
(required)
string ID of the screen that the item belongs to.
dynamic integer Whether the screen item is dynamic.

Possible values:
0 - (default) not dynamic;
1 - dynamic.
elements integer Number of lines to display on the screen item.

Default: 25.
halign integer Specifies how the screen item must be aligned horizontally in the cell.

Possible values:
0 - (default) center;
1 - left;
2 - right.
height integer Height of the screen item in pixels.

Default: 200.
resourceid string ID of the object displayed on the screen item. Depending on the type of a screen item, the resourceid property can reference different objects.

Required for data overview, graph, map, plain text, screen, simple graph and trigger overview screen items. Unused by local and server time clocks, history of actions, history of events, hosts info, server info, system status and URL screen items.
sort_triggers integer Order in which actions or triggers must be sorted.

Possible values for history of actions screen elements:
3 - time, ascending;
4 - time, descending;
5 - type, ascending;
6 - type, descending;
7 - status, ascending;
8 - status, descending;
9 - retries left, ascending;
10 - retries left, descending;
11 - recipient, ascending;
12 - recipient, descending.

Possible values for latest host group issues and latest host issues screen items:
0 - (default) last change, descending;
1 - severity, descending;
2 - host, ascending.
style integer Screen item display option.

Possible values for data overview and triggers overview screen items:
0 - (default) display hosts on the left side;
1 - display hosts on the top.

Possible values for hosts info and triggers info screen elements:
0 - (default) horizontal layout;
1 - vertical layout.

Possible values for clock screen items:
0 - (default) local time;
1 - server time;
2 - host time.

Possible values for plain text screen items:
0 - (default) display values as plain text;
1 - display values as HTML.
url string URL of the webpage to be displayed in the screen item. Used by URL screen items.
valign integer Specifies how the screen item must be aligned vertically in the cell.

Possible values:
0 - (default) middle;
1 - top;
2 - bottom.
width integer Width of the screen item in pixels.

Default: 320.
x integer X-coordinates of the screen item on the screen, from left to right.

Default: 0.
y integer Y-coordinates of the screen item on the screen, from top to bottom.

Default: 0.