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

Следующие объекты напрямую связаны с 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	целое число	Размер сетки карты сети в пикселях. Supported values: 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 - отображать количество подтвержденных и неподтвержденных проблем раздельно.

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

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

Свойство	Тип	Описание
selementid	строка	(только чтение) ID элемента карты.
elementid (требуется)	строка	ID объекта, который отображается элементом карты. Требуется для элементов с типами узел сети, группа узлов сети, триггер и карта сети.
elementtype (требуется)	целое число	Тип элемента карты. Возможные значения: 0 - узел сети; 1 - карта сети; 2 - триггер; 3 - группа узлов сети; 4 - изображение.
iconid_off (требуется)	строка	ID изображения, которое используется для отображения элемента в состоянии по умолчанию.
areatype	целое число	Каким образом необходимо отображать разделение узлов сети групп узлов сети. Возможные значения: 0 - (по умолчанию) элемент группы узлов сети будет занимать всю карту сети; 1 - элемент группы узлов сети будет занимать фиксированный размер.
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.

Documentation