Table of Contents
> 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. |