Объект карты

Следующие объекты напрямую связаны с API map.

Карта

Объект карты имеет следующие свойства.

Property Type Description
sysmapid ID ID карты.

Поведение свойства:
- только для чтения
- обязательное для операций обновления
height integer Высота карты в пикселях.

Поведение свойства:
- обязательное для операций создания
name string Имя карты.

Поведение свойства:
- обязательное для операций создания
width integer Ширина карты в пикселях.

Поведение свойства:
- обязательное для операций создания
backgroundid ID ID изображения, используемого в качестве фона карты.
expand_macros integer Следует ли разворачивать макросы в метках при настройке карты.

Возможные значения:
0 - (по умолчанию) не разворачивать макросы;
1 - разворачивать макросы.
expandproblem integer Следует ли отображать триггер проблемы для элементов с одной проблемой.

Возможные значения:
0 - всегда отображать количество проблем;
1 - (по умолчанию) отображать триггер проблемы, если проблема только одна.
grid_align integer Следует ли включить выравнивание по сетке.

Возможные значения:
0 - отключить выравнивание по сетке;
1 - (по умолчанию) включить выравнивание по сетке.
grid_show integer Следует ли отображать сетку на карте.

Возможные значения:
0 - не отображать сетку;
1 - (по умолчанию) отображать сетку.
grid_size integer Размер сетки карты в пикселях.

Поддерживаемые значения: 20, 40, 50, 75 и 100.

По умолчанию: 50.
highlight integer Включена ли подсветка значков.

Возможные значения:
0 - подсветка отключена;
1 - (по умолчанию) подсветка включена.
iconmapid ID ID карты значков, используемой на карте.
label_format integer Следует ли включить расширенные метки.

Возможные значения:
0 - (по умолчанию) отключить расширенные метки;
1 - включить расширенные метки.
label_location integer Расположение метки элемента карты.

Возможные значения:
0 - (по умолчанию) снизу;
1 - слева;
2 - справа;
3 - сверху.
label_string_host string Пользовательская метка для элементов узла сети.

Поведение свойства:
- обязательное, если label_type_host установлено в "custom"
label_string_hostgroup string Пользовательская метка для элементов группы узлов сети.

Поведение свойства:
- обязательное, если label_type_hostgroup установлено в "custom"
label_string_image string Пользовательская метка для элементов изображения.

Поведение свойства:
- обязательное, если label_type_image установлено в "custom"
label_string_map string Пользовательская метка для элементов карты.

Поведение свойства:
- обязательное, если label_type_map установлено в "custom"
label_string_trigger string Пользовательская метка для элементов триггера.

Поведение свойства:
- обязательное, если label_type_trigger установлено в "custom"
label_type integer Тип метки элемента карты.

Возможные значения:
0 - метка;
1 - IP-адрес;
2 - (по умолчанию) имя элемента;
3 - только статус;
4 - ничего.
label_type_host integer Тип метки для элементов узла сети.

Возможные значения:
0 - метка;
1 - IP-адрес;
2 - (по умолчанию) имя элемента;
3 - только статус;
4 - ничего;
5 - пользовательский.
label_type_hostgroup integer Тип метки для элементов группы узлов сети.

Возможные значения:
0 - метка;
2 - (по умолчанию) имя элемента;
3 - только статус;
4 - ничего;
5 - пользовательский.
label_type_image integer Тип метки для элементов группы узлов сети.

Возможные значения:
0 - метка;
2 - (по умолчанию) имя элемента;
4 - ничего;
5 - пользовательский.
label_type_map integer Тип метки для элементов карты.

Возможные значения:
0 - метка;
2 - (по умолчанию) имя элемента;
3 - только статус;
4 - ничего;
5 - пользовательский.
label_type_trigger integer Тип метки для элементов триггера.

Возможные значения:
0 - метка;
2 - (по умолчанию) имя элемента;
3 - только статус;
4 - ничего;
5 - пользовательский.
markelements integer Следует ли выделять элементы карты, которые недавно изменили свой статус.

Возможные значения:
0 - (по умолчанию) не выделять элементы;
1 - выделять элементы.
severity_min integer Минимальная серьезность триггеров, которые будут отображаться на карте.

См. свойство severity триггера для списка поддерживаемых уровней серьезности триггеров.
show_unack integer Как следует отображать проблемы.

Возможные значения:
0 - (по умолчанию) отображать количество всех проблем;
1 - отображать только количество неподтвержденных проблем;
2 - отображать количество подтвержденных и неподтвержденных проблем отдельно.
userid ID ID пользователя, являющегося владельцем карты.
private integer Тип общего доступа к карте.

Возможные значения:
0 - общедоступная карта;
1 - (по умолчанию) частная карта.
show_suppressed integer Следует ли отображать подавленные проблемы.

Возможные значения:
0 - (по умолчанию) скрывать подавленные проблемы;
1 - отображать подавленные проблемы.

Элемент карты

Объект элемента карты определяет объект, отображаемый на карте. Он имеет следующие свойства.

Property Type Description
selementid ID ID элемента карты.

Поведение свойства:
- только для чтения
elements array Объект данных элемента.

Поведение свойства:
- обязательно, если elementtype задан как "host", "map", "trigger" или "host group"
elementtype integer Тип элемента карты.

Возможные значения:
0 - host;
1 - map;
2 - trigger;
3 - host group;
4 - image.

Поведение свойства:
- обязательно
iconid_off ID ID изображения, используемого для отображения элемента в состоянии по умолчанию.

Поведение свойства:
- обязательно
areatype integer Способ отображения отдельных узлов сети в группе узлов сети.

Возможные значения:
0 - (по умолчанию) элемент группы узлов сети занимает всю карту;
1 - элемент группы узлов сети имеет фиксированный размер.
elementsubtype integer Способ отображения элемента группы узлов сети на карте.

Возможные значения:
0 - (по умолчанию) отображать группу узлов сети как один элемент;
1 - отображать каждый узел сети в группе отдельно.
evaltype integer Метод оценки условия фильтрации тегов элемента карты evaluation method.

Возможные значения:
0 - (по умолчанию) And/Or;
2 - Or.
height integer Высота элемента группы узлов сети фиксированного размера в пикселях.

По умолчанию: 200.
iconid_disabled ID ID изображения, используемого для отображения отключенных элементов карты.

Поведение свойства:
- поддерживается, если elementtype задан как "host", "map", "trigger" или "host group"
iconid_maintenance ID ID изображения, используемого для отображения элементов карты в обслуживании.

Поведение свойства:
- поддерживается, если elementtype задан как "host", "map", "trigger" или "host group"
iconid_on ID ID изображения, используемого для отображения элементов карты с проблемами.

Поведение свойства:
- поддерживается, если elementtype задан как "host", "map", "trigger" или "host group"
label string Метка элемента.
label_location integer Расположение метки элемента карты.

Возможные значения:
-1 - (по умолчанию) расположение по умолчанию;
0 - снизу;
1 - слева;
2 - справа;
3 - сверху.
permission integer Тип уровня доступа.

Возможные значения:
-1 - нет;
2 - только чтение;
3 - чтение-запись.
sysmapid ID ID карты, к которой принадлежит элемент.

Поведение свойства:
- только для чтения
urls array URL-адреса элемента карты.

Объект URL-адреса элемента карты подробно описан ниже.
use_iconmap integer Следует ли использовать сопоставление значков для элементов узлов сети.

Возможные значения:
0 - не использовать сопоставление значков;
1 - (по умолчанию) использовать сопоставление значков.
viewtype integer Алгоритм размещения элемента группы узлов сети.

Возможные значения:
0 - (по умолчанию) сетка.
width integer Ширина элемента группы узлов сети фиксированного размера в пикселях.

По умолчанию: 200.
x integer Координата X элемента в пикселях.

По умолчанию: 0.
y integer Координата Y элемента в пикселях.

По умолчанию: 0.

Объект узла сети элемента карты

Объект Host элемента карты определяет один элемент узла сети.

Property Type Description
hostid ID ID узла сети.

Элемент карты Группа узлов сети

Объект элемента карты Группа узлов сети определяет один элемент группы узлов сети.

Property Type Description
groupid ID ID группы узлов сети.

Элемент карты Map

Объект Map элемента карты определяет один элемент карты.

Property Type Description
sysmapid ID ID карты.

Объект триггера элемента карты

Объект Trigger элемента карты определяет один или несколько элементов триггера.

Property Type Description
triggerid ID ID триггера.

Тег элемента карты

Объект Tag элемента карты имеет следующие свойства.

Property Type Description
tag string Имя тега элемента карты.

Property behavior:
- required
operator integer Оператор условия тега элемента карты.

Возможные значения:
0 - (default) Содержит;
1 - Равно;
2 - Не содержит;
3 - Не равно;
4 - Существует;
5 - Не существует.
value string Значение тега элемента карты.

URL элемента карты

Объект URL элемента карты определяет кликабельную ссылку, которая будет доступна для конкретного элемента карты. Он имеет следующие свойства:

Property Type Description
sysmapelementurlid ID ID URL элемента карты.

Property behavior:
- read-only
name string Подпись ссылки.

Property behavior:
- required
url string URL ссылки.

Property behavior:
- required
selementid ID ID элемента карты, которому принадлежит URL.

Ссылка карты

Объект ссылки карты определяет связь между двумя элементами карты. Он имеет следующие свойства.

Property Type Description
linkid ID ID ссылки карты.

Property behavior:
- read-only
selementid1 ID ID первого элемента карты, связанного на одном конце.

Property behavior:
- required
selementid2 ID ID первого элемента карты, связанного на другом конце.

Property behavior:
- required
color string Цвет линии в виде шестнадцатеричного кода цвета.

По умолчанию: 000000.
drawtype integer Стиль отображения линии связи.

Возможные значения:
0 - (по умолчанию) линия;
2 - жирная линия;
3 - точечная линия;
4 - пунктирная линия.
label string Метка ссылки.
linktriggers array Триггеры ссылки карты, используемые в качестве индикаторов состояния ссылки.

Объект триггера ссылки карты подробно описан ниже.
permission integer Тип уровня доступа.

Возможные значения:
-1 - нет;
2 - только чтение;
3 - чтение-запись.
sysmapid ID ID карты, к которой принадлежит ссылка.

Триггер ссылки карты

Объект триггера ссылки карты определяет индикатор состояния ссылки карты на основе состояния триггера. Он имеет следующие свойства:

Property Type Description
linktriggerid ID ID триггера ссылки карты.

Property behavior:
- read-only
triggerid ID ID триггера, используемого в качестве индикатора ссылки.

Property behavior:
- required
color string Цвет индикатора в виде шестнадцатеричного кода цвета.

По умолчанию: DD0000.
drawtype integer Стиль отображения индикатора.

Возможные значения:
0 - (по умолчанию) линия;
2 - жирная линия;
3 - пунктирная линия;
4 - штриховая линия.
linkid ID ID ссылки карты, к которой принадлежит триггер ссылки.

URL карты

Объект URL карты определяет кликабельную ссылку, которая будет доступна для всех элементов определенного типа на карте. Он имеет следующие свойства:

Property Type Description
sysmapurlid ID ID URL карты.

Property behavior:
- read-only
name string Подпись ссылки.

Property behavior:
- required
url string URL ссылки.

Property behavior:
- required
elementtype integer Тип элемента карты, для которого будет доступен URL.

Список поддерживаемых типов см. в свойстве type элемента карты.

По умолчанию: 0.
sysmapid ID ID карты, которой принадлежит URL.

Пользователь карты

Список прав доступа к карте на основе пользователей. Он имеет следующие свойства:

Property Type Description
sysmapuserid ID ID пользователя карты.

Property behavior:
- read-only
userid ID ID пользователя.

Property behavior:
- required
permission integer Тип уровня доступа.

Возможные значения:
2 - только чтение;
3 - чтение и запись.

Property behavior:
- required

Группа пользователей карты

Список прав доступа к карте на основе групп пользователей. Имеет следующие свойства:

Property Type Description
sysmapusrgrpid ID ID группы пользователей карты.

Property behavior:
- read-only
usrgrpid ID ID группы пользователей.

Property behavior:
- required
permission integer Тип уровня доступа.

Возможные значения:
2 - только чтение;
3 - чтение-запись.

Property behavior:
- required

Фигуры карты

Объект фигуры карты определяет геометрическую фигуру (с текстом или без него), отображаемую на карте. Он имеет следующие свойства:

Property Type Description
sysmap_shapeid ID ID элемента фигуры карты.

Поведение свойства:
- только для чтения
type integer Тип элемента фигуры карты.

Возможные значения:
0 - прямоугольник;
1 - эллипс.

Свойство обязательно при создании новых фигур.

Поведение свойства:
- обязательное
x integer Координата X фигуры в пикселях.

По умолчанию: 0.
y integer Координата Y фигуры в пикселях.

По умолчанию: 0.
width integer Ширина фигуры в пикселях.

По умолчанию: 200.
height integer Высота фигуры в пикселях.

По умолчанию: 200.
text string Текст фигуры.
font integer Шрифт текста внутри фигуры.

Возможные значения:
0 - Georgia, serif
1 - "Palatino Linotype", "Book Antiqua", Palatino, serif
2 - "Times New Roman", Times, serif
3 - Arial, Helvetica, sans-serif
4 - "Arial Black", Gadget, sans-serif
5 - "Comic Sans MS", cursive, sans-serif
6 - Impact, Charcoal, sans-serif
7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif
8 - Tahoma, Geneva, sans-serif
9 - "Trebuchet MS", Helvetica, sans-serif
10 - Verdana, Geneva, sans-serif
11 - "Courier New", Courier, monospace
12 - "Lucida Console", Monaco, monospace

По умолчанию: 9.
font_size integer Размер шрифта в пикселях.

По умолчанию: 11.
font_color string Цвет шрифта.

По умолчанию: 000000.
text_halign integer Горизонтальное выравнивание текста.

Возможные значения:
0 - по центру;
1 - слева;
2 - справа.

По умолчанию: 0.
text_valign integer Вертикальное выравнивание текста.

Возможные значения:
0 - по середине;
1 - сверху;
2 - снизу.

По умолчанию: 0.
border_type integer Тип границы.

Возможные значения:
0 - нет;
1 - —————;
2 - ·····;
3 - - - -.

По умолчанию: 0.
border_width integer Ширина границы в пикселях.

По умолчанию: 0.
border_color string Цвет границы.

По умолчанию: 000000.
background_color string Цвет фона (цвет заливки).

По умолчанию: (empty).
zindex integer Значение, используемое для упорядочивания всех фигур и линий (z-index).

По умолчанию: 0.

Линии карты

Объект линии карты определяет линию, отображаемую на карте. Он имеет следующие свойства:

Property Type Description
sysmap_shapeid ID ID элемента фигуры карты.

Поведение свойства:
- только для чтения
x1 integer Координата X точки 1 линии в пикселях.

По умолчанию: 0.
y1 integer Координата Y точки 1 линии в пикселях.

По умолчанию: 0.
x2 integer Координата X точки 2 линии в пикселях.

По умолчанию: 200.
y2 integer Координата Y точки 2 линии в пикселях.

По умолчанию: 200.
line_type integer Тип линии.

Возможные значения:
0 - нет;
1 - —————;
2 - ·····;
3 - - - -.

По умолчанию: 0.
line_width integer Ширина линии в пикселях.

По умолчанию: 0.
line_color string Цвет линии.

По умолчанию: 000000.
zindex integer Значение, используемое для упорядочивания всех фигур и линий (z-index).

По умолчанию: 0.