> Объект карты сети

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

Карта сети

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

Свойство Тип Описание
sysmapid строка (только чтение) ID карты сети.
height
(требуется)
целое число Высота карты сети в пикселях.
name
(требуется)
строка Имя карты сети.
width
(требуется)
целое число Ширина карты сети в пикселях.
backgroundid строка ID изображения, которое используется в качестве фона на карте сети.
expand_macros целое число Необходимо ли раскрывать макросы в подписях при настройке карты сети.

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

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

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

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

Возможные значения: 20, 40, 50, 75 и 100.

По умолчанию: 50.
highlight целое число Необходимо ли активировать подсветку иконок.

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

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

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

Требуется для карт сетей с пользовательским типом подписей к узлам сети.
label_string_hostgroup строка Пользовательская подпись к элементам групп узлов сети.

Требуется для карт сетей с пользовательским типом подписей к группам узлов сетей.
label_string_image строка Пользовательская подпись к элементам изображений.

Требуется для карт сетей с пользовательским типом подписей к изображениям.
label_string_map строка Пользовательская подпись к элементам карт.

Требуется для карт сетей с пользовательским типом подписей к картам.
label_string_trigger строка Пользовательская подпись к элементам триггеров.

Требуется для карт сетей с пользовательским типом подписей к триггерам.
label_type целое число Тип подписи к элементам карт сетей.

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

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

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

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

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

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

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

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

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

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

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

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

Свойство Тип Описание
selementid строка (только чтение) ID элемента карты.
elementid
(требуется)
строка ID объекта, который отображается элементом карты.

Требуется для элементов с типами узел сети, группа узлов сети, триггер и карта сети.
elementtype
(требуется)
целое число Тип элемента карты.

Возможные значения:
0 - узел сети;
1 - карта сети;
2 - триггер;
3 - группа узлов сети;
4 - изображение.
iconid_off
(требуется)
строка ID изображения, которое используется для отображения элемента в состоянии по умолчанию.
areatype целое число Каким образом необходимо отображать разделение узлов сети групп узлов сети.

Возможные значения:
0 - (по умолчанию) элемент группы узлов сети будет занимать всю карту сети;
1 - элемент группы узлов сети будет занимать фиксированный размер.
application строка Имя группы элементов данных из которой необходимо отображать проблемы. Используется только для элементов карты узла сети и группы узлов сети.
elementsubtype целое число Каким образом отображать элемент группы узлов сети на карте сети.

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

По умолчанию: 200.
iconid_disabled строка ID изображения, которое используется для отображения элемента в деактивированном состоянии. Не используется для элементов изображений.
iconid_maintenance строка ID изображения, которое используется для отображения элемента в состоянии обслуживания. Не используется для элементов изображений.
iconid_on строка ID изображения, которое используется для отображения элемента карты сети с имеющимися проблемами. Не используется для элементов изображений.
label строка Подпись к элементу.
label_location целое число Размещение подписи к элементу карты сети.

Возможные значения:
-1 - (по умолчанию) размещение по умолчанию;
0 - снизу;
1 - слева;
2 - справа;
3 - сверху.
sysmapid строка (только чтение) ID карты сети, которой принадлежит элемент.
urls array URL'ы элемента карты.

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

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

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

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

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

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

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

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

Свойство Тип Описание
sysmapelementurlid строка (только чтение) ID URL элемента карты.
name
(требуется)
строка Подпись к ссылке.
url
(требуется)
строка URL ссылки.
selementid строка ID элемента карты, которому принадлежит URL.

Связь карты

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

Свойство Тип Описание
linkid строка (только чтение) ID связи карты.
selementid1
(требуется)
строка ID первого элемента карты сети, присоединенного с одного конца.
selementid2
(требуется)
строка ID второго элемента карты сети, присоединенного с другого конца.
color строка Цвет линии в виде шестнадцатеричного кода цвета.

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

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

Объект триггеров связи на карте сети детально описан ниже.
sysmapid строка ID карты сети, которой принадлежит связь.

Триггера связи на карте

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

Свойство Тип Описание
linktriggerid строка (только чтение) ID триггера связи на карте.
triggerid
(требуется)
строка ID триггера, который используется индикатором связи.
color строка Цвет индикатора в виде шестнадцатеричного кода цвета.

По умолчанию: DD0000.
drawtype целое число Стиль отрисовки индикатора.

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

URL карты

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

Свойство Тип Описание
sysmapurlid строка (только чтение) ID URL карты.
name
(требуется)
строка Подпись к ссылке.
url
(требуется)
строка URL ссылки.
elementtype целое число Тип элемента карты сети, которому будет доступен URL.

Обратитесь к свойству "type" элемента карты для получения списка поддерживаемых типов.

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

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

Список прав доступа к карте сети основанный на пользователях. Этот объект имеет следующие свойства:

Свойство Тип Описание
sysmapuserid строка (только чтение) ID пользователя карты.
userid
(требуется)
строка ID пользователя.
permission
(требуется)
целое число Тип уровня прав доступа.

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

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

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

Свойство Тип Описание
sysmapusrgrpid строка (только чтение) ID группы пользователей карты.
usrgrpid
(требуется)
строка ID группы пользователей.
permission
(требуется)
целое число Тип уровня прав доступа.

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