[comment]: # ({e87d2514-c7c352d1})
# 5. Карты сети

[comment]: # ({/e87d2514-c7c352d1})

[comment]: # ({330b8ea3-f69156a2})
#### Обзор

[Экспорт](/manual/xml_export_import) карты сети содержит:

-   Все связанные изображения
-   Структуру карты (все настройки карты, все находящиеся на карте элементы с их настройками, связи карты и индикаторы состояний связей карты)

::: notewarning
Не экспортируются группы узлов сети, узлы сети, триггеры, другие карты и любые другие элементы, которые могут быть связаны с экспортируемой картой.
Поэтому если хотя бы один из элементов, на который ссылается карта, отсутствует, импорт завершится с ошибкой.
:::

[comment]: # ({/330b8ea3-f69156a2})

[comment]: # ({c5b92c54-bc82aec8})
#### Экспорт

Для экспорта карт сети сделайте следующее:

1. Перейдите к: *Мониторинг* → *Карты сети (Monitoring* → *Maps)*
2. Отметьте карты сети, которые нужно экспортировать
3. Нажмите на *Экспорт (Export)* ниже списка

![](../../../assets/en/manual/xml_export_import/export_maps.png)

В зависимости от выбранного формата, карты сети экспортируются в локальный файл с именем по умолчанию:

-   `zabbix_export_maps.yaml` — при экспорте в YAML (опция по умолчанию для экспорта)
-   `zabbix_export_maps.xml` — при экспорте в XML
-   `zabbix_export_maps.json` — при экспорте в  JSON

[comment]: # ({/c5b92c54-bc82aec8})

[comment]: # ({0da4fe77-cc31311c})
#### Импорт

Чтобы импортировать карты сети, выполните следующие действия:

1. Перейдите в *Monitoring* → *Maps*.
2. Нажмите *Import* в правом верхнем углу.
3. Выберите файл импорта.
4. Отметьте нужные параметры в правилах импорта.
5. Нажмите *Import* в правом нижнем углу формы настройки.

![](../../../assets/en/manual/xml_export_import/import_maps.png){width="600"}

Правила импорта:

|Rule|Description|
|----|-----------|
|*Update existing*|Существующие карты будут обновлены с использованием данных из файла импорта. В противном случае они не будут обновлены.|
|*Create new*|Новые карты будут созданы с использованием данных из файла импорта. В противном случае они не будут созданы.|

Если снять оба параметра для карт и отметить соответствующие параметры для изображений, будут импортированы только изображения.
Импорт изображений доступен только пользователям с ролью *Super admin*.

В веб-интерфейсе будет отображено сообщение об успешном или неуспешном импорте.

::: notewarning
Если заменить существующее изображение, это повлияет на все карты, которые используют это изображение.
:::

[comment]: # ({/0da4fe77-cc31311c})

[comment]: # ({35a830bc-53418cf1})
#### Формат экспорта

Экспорт в YAML:

```yaml
zabbix_export:
  version: '8.0'
  images:
    - name: Zabbix_server_3D_(128)
      imagetype: '1'
      encodedImage: iVBOR...5CYII=
  maps:
    - name: 'Local network'
      width: '680'
      height: '200'
      label_type: '0'
      label_location: '0'
      highlight: '1'
      expandproblem: '1'
      markelements: '1'
      show_unack: '0'
      severity_min: '0'
      show_suppressed: '0'
      grid_size: '50'
      grid_show: '1'
      grid_align: '1'
      label_format: '0'
      label_type_host: '2'
      label_type_hostgroup: '2'
      label_type_trigger: '2'
      label_type_map: '2'
      label_type_image: '2'
      label_string_host: ''
      label_string_hostgroup: ''
      label_string_trigger: ''
      label_string_map: ''
      label_string_image: ''
      expand_macros: '1'
      background: {  }
      iconmap: {  }
      urls: {  }
      selements:
        - elementtype: '0'
          elements:
            - host: 'Zabbix server'
          label: |
            {HOST.NAME}
            {HOST.CONN}
          label_location: '0'
          x: '111'
          'y': '61'
          elementsubtype: '0'
          areatype: '0'
          width: '200'
          height: '200'
          viewtype: '0'
          use_iconmap: '0'
          selementid: '1'
          icon_off:
            name: Zabbix_server_3D_(128)
          icon_on: {  }
          icon_disabled: {  }
          icon_maintenance: {  }
          urls: {  }
          evaltype: '0'
      shapes:
        - type: '0'
          x: '0'
          'y': '0'
          width: '680'
          height: '15'
          text: '{MAP.NAME}'
          font: '9'
          font_size: '11'
          font_color: '000000'
          text_halign: '0'
          text_valign: '0'
          border_type: '0'
          border_width: '0'
          border_color: '000000'
          background_color: ''
          zindex: '0'
      lines: {  }
      links: {  }
```

[comment]: # ({/35a830bc-53418cf1})

[comment]: # ({2e83c283-efe541b5})
### Экспортированные элементы

Экспортированные элементы описаны в таблице ниже.

|Элемент|<|Тип|Описание|
|-|---|---|------------------------|
|images|<| |Корневой элемент для изображений.|
|<|name|строка|Уникальное имя изображения.|
|^|imagetype|целое число|Тип изображения.<br>Возможные значения:<br>1 — Изображение;<br>2 — Фон.|
|^|encodedImage|строка|Изображение в кодировке Base64.|
|maps|<| |Корневой элемент для [карт сети](#карты-сети-1).|

[comment]: # ({/2e83c283-efe541b5})

[comment]: # ({0250d445-9a766d06})
#### Карты сети

|Элемент|<|Тип|Описание|
|-|---|---|-----------------------|
|name|<|строка|Уникальное имя карты.|
|width|<|целое число|Ширина карты, в пикселях.|
|height|<|целое число|Высота карты, в пикселях.|
|label\_type|<|целое число|Тип подписи к элементам карты.<br>Возможные значения:<br>0 — Подпись;<br>1 — IP адрес узла сети;<br>2 — Имя элемента;<br>3 — Только состояние;<br>4 — Ничего.|
|label\_location|<|целое число|Расположение подписи к элементам карты по умолчанию.<br>Возможные значения:<br>0 — Снизу;<br>1 — Слева;<br>2 — Справа;<br>3 — Сверху.|
|highlight|<|целое число|Включение подсветки иконок для активных триггеров и состояний узлов сети.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|expandproblem|<|целое число|Отображение триггера с проблемой у элементов с одной проблемой.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|markelements|<|целое число|Подсветка элементов карты, которые недавно изменили своё состояние.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|show\_unack|<|целое число|Отображение проблем.<br>Возможные значения:<br>0 — Количество всех проблем;<br>1 — Количество неподтвержденных проблем;<br>2 — Количество подтвержденных и неподтвержденных проблем раздельно.|
|severity\_min|<|целое число|Минимальная важность триггеров, которая отображается на карте, по умолчанию.<br>Возможные значения:<br>0 — Не классифицировано;<br>1 — Информация;<br>2 — Предупреждение;<br>3 — Средняя;<br>4 — Высокая;<br>5 — Чрезвычайная.|
|show\_suppressed|<|целое число|Отображение проблем, которые в противном случае были бы подавлены (не показаны) по причине обслуживания узлов сети.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|grid\_size|<|целое число|Размер ячейки сетки карты в пикселях.<br>Поддерживается, если `grid_show` равно `0`.<br>Возможные значения: 20, 40, 50, 75 или 100.|
|grid\_show|<|целое число|Отображение сетки в настройке карты.<br>Возможные значения:<br>0 — Yes;<br>1 — No.|
|grid\_align|<|целое число|Автоматическое выравнивание иконок в настройке карты.<br>Возможные значения:<br>0 — Yes;<br>1 — No.|
|label\_format|<|целое число|Использование расширенной конфигурации подписей.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|label\_type\_host|<|целое число|Метод отображения подписи к узлам сети.<br>Поддерживается, если `label_format` равно `1`.<br>Возможные значения:<br>0 — Подпись;<br>1 — IP адрес узла сети;<br>2 — Имя элемента;<br>3 — Только состояние;<br>4 — Ничего;<br>5 — пользовательская подпись.|
|label\_type\_hostgroup|<|целое число|Метод отображения подписи к группам узлов сети.<br>Поддерживается, если `label_format` равно `1`.<br>Возможные значения:<br>0 — Подпись;<br>2 — Имя элемента;<br>3 — Только состояние;<br>4 — Ничего;<br>5 — Пользовательская подпись.|
|label\_type\_trigger|<|целое число|Метод отображения подписи к триггеров.<br>Поддерживается, если `label_format` равно `1`.<br>Возможные значения:<br>0 — Подпись;<br>2 — Имя элемента;<br>3 — Только состояние;<br>4 — Ничего;<br>5 — Пользовательская подпись.|
|label\_type\_map|<|целое число|Метод отображения подписи к картам сети.<br>Поддерживается, если `label_format` равно `1`.<br>Возможные значения:<br>0 — Подпись;<br>2 — Имя элемента;<br>3 — Только состояние;<br>4 — Ничего;<br>5 — Пользовательская подпись.|
|label\_type\_image|<|целое число|Метод отображения подписи к изображениям.<br>Поддерживается, если `label_format` равно `1`.<br>Возможные значения:<br>0 — Label;<br>2 — Element name;<br>4 — Nothing;<br>5 — Custom label.|
|label\_string\_host|<|строка|Пользовательская подпись к элементам узлов сети.<br>Поддерживается, если `label_type_host` равно `5`.|
|label\_string\_hostgroup|<|строка|Пользовательская подпись к элементам групп узлов сети.<br>Поддерживается, если `label_type_hostgroup` равно `5`.|
|label\_string\_trigger|<|строка|Пользовательская подпись к элементам триггеров.<br>Поддерживается, если `label_type_trigger` равно `5`.|
|label\_string\_map|<|строка|Пользовательская подпись к элементам карт сети.<br>Поддерживается, если `label_type_map` равно `5`.|
|label\_string\_image|<|строка|Пользовательская подпись к элементам изображений.<br>Поддерживается, если `label_type_image` равно `5`.|
|expand\_macros|<|целое число|Раскрытие макросов в подписях при настройке карты.<br>Возможные значения:<br>0 — No;<br>1 — Yes.|
|background|<| |Корневой элемент для фонового изображения (если имеется).<br>Поддерживается, если `imagetype` равно `2`.|
| |name|строка|Имя фонового изображения.|
|iconmap|<| |Корневой элемент для соответствия иконок (если имеется).|
| |name|строка|Имя соответствия иконок.|
|urls|<| |Корневой элемент для URL, используемых картами сети либо каждым элементом карты.|
|<|name|строка|Имя ссылки.|
|^|url|строка|Сама ссылка URL.|
|^|elementtype|целое число|Тип элемента карты, к которому относится ссылка.<br>Возможные значения:<br>0 — Узел сети;<br>1 — Карта;<br>2 — Триггер;<br>3 — Группа узлов сети;<br>4 — Изображение.|
|selements|<| |Корневой элемент для [элементов карты](#элементы-карты).|
|shapes|<| |Корневой элемент для фигур карты.|
|<|type|целое число|Тип фигуры.<br>Возможные значения:<br>0 — Прямоугольник;<br>1 — Эллипс.|
|^|x|целое число|Координата X фигуры (в пикселях).|
|^|y|целое число|Координата Y фигуры (в пикселях).|
|^|width|целое число|Ширина фигуры.|
|^|height|целое число|Высота фигуры.|
|^|text|строка|Текст внутри фигуры.|
|^|font|целое число|Стиль шрифта для текста.<br>Возможные значения:<br>0 — Georgia, serif;<br>1 — "Palatino Linotype", "Book Antiqua", Palatino, serif;<br>2 — "Times New Roman", Times, serif;<br>3 — Arial, Helvetica, sans-serif;<br>4 — "Arial Black", Gadget, sans-serif;<br>5 — "Comic Sans MS", cursive, sans-serif;<br>6 — Impact, Charcoal, sans-serif;<br>7 — "Lucida Sans Unicode", "Lucida Grande", sans-serif;<br>8 — Tahoma, Geneva, sans-serif;<br>9 — "Trebuchet MS", Helvetica, sans-serif;<br>10 — Verdana, Geneva, sans-serif;<br>11 — "Courier New", Courier, monospace;<br>12 — "Lucida Console", Monaco, monospace.|
|^|font\_size|целое число|Размер шрифта в пикселях.|
|^|font\_color|строка|Цвет шрифта, представленный в виде 16-ричного кода.|
|^|text\_halign|целое число|Выравнивание текста по горизонтали.<br>Возможные значения:<br>0 — По центру;<br>1 — По левой стороне;<br>2 — По правой стороне.|
|^|text\_valign|целое число|Выравнивание текста по вертикали.<br>Возможные значения:<br>0 — По середине;<br>1 — По верхнему краю;<br>2 — По нижнему краю.|
|^|border\_type|целое число|Тип рамки фигуры.<br>Возможные значения:<br>0 — Отсутствует;<br>1 — Жирная линия;<br>2 — Точечная линия;<br>3 — Пунктирная линия.|
|^|border\_width|целое число|Ширина рамки в пикселях.|
|^|border\_color|строка|Цвет рамки, представленный в виде 16-ричного кода.|
|^|background\_color|строка|Цвет фона (заливки), представленный в виде 16-ричного кода.|
|^|zindex|целое число|Значение, используемое для указания порядка всех фигур и линий (z-index).|
|lines|<| |Корневой элемент для линий карты.|
|<|x1|целое число|Координата X точки 1 линии в пикселях.|
|^|y1|целое число|Координата Y точки 1 линии в пикселях.|
|^|x2|целое число|Координата X точки 2 линии в пикселях.|
|^|y2|целое число|Координата Y точки 2 линии в пикселях.|
|^|line\_type|целое число|Тип линии.<br>Возможные значения:<br>0 — Отсутствует;<br>1 — Жирная линия;<br>2 — Точечная линия;<br>3 — Пунктирная линия.|
|^|line\_width|целое число|Ширина линии в пикселях.|
|^|line\_color|строка|Цвет линии, представленный в виде 16-ричного кода.|
|^|zindex|целое число|Значение, используемое для указания порядка всех фигур и линий (z-index).|
|links|<| |Корневой элемент для связей между элементами карты.|
|<|drawtype|целое число|Стиль связи.<br>Возможные значения:<br>0 — Отсутствует;<br>1 — Жирная линия;<br>2 — Точечная линия;<br>3 — Пунктирная линия.|
|^|color|строка|Цвет связи (6 символов, hex).|
|^|label|строка|Подпись к связи.|
|^|selementid1|идентификатор|Идентификатор первого элемента, с которым соединена связь.|
|^|selementid2|идентификатор|Идентификатор второго элемента, с которым соединена связь.|
|linktriggers|<| |Корневой элемент для [индикаторов состояния связей](#индикаторы-состояния-связей-карты).|

::: noteclassic
Смотрите также: [Объект карты сети](/manual/api/reference/map/object) (смотрите соответствующее свойство с совпадающим именем).
:::

[comment]: # ({/0250d445-9a766d06})

[comment]: # ({917b09e0-40b8b222})
##### Элементы карты

|Element|<|Type|Description|
|-|---|---|-----------------------|
|elementtype|<|integer|Тип элемента карты.<br>Возможные значения:<br>0 - Узел сети;<br>1 - Карта;<br>2 - Триггер;<br>3 - Группа узлов сети;<br>4 - Изображение.|
|elements|<| |Корневой элемент для сущностей Zabbix (узел сети, группа узлов сети, карта и т. д.), которые отображаются на карте.<br>У каждой сущности есть соответствующий элемент (`host` и т. д.; см., например, [Формат экспорта](#export-format)).|
|label|<|string|Подпись значка.|
|label\_location|<|integer|Расположение подписи.<br>Возможные значения:<br>-1 - Использовать значение по умолчанию карты;<br>0 - Снизу;<br>1 - Слева;<br>2 - Справа;<br>3 - Сверху.|
|x|<|integer|Положение по оси X.|
|y|<|integer|Положение по оси Y.|
|elementsubtype|<|integer|Подтип элемента.<br>Поддерживается, если для `elementtype` установлено значение `3`.<br>Возможные значения:<br>0 - Одна группа узлов сети;<br>1 - Все группы узлов сети.|
|areatype|<|integer|Размер области.<br>Поддерживается, если для `elementtype` установлено значение `1`.<br>Возможные значения:<br>0 - Как у всей карты;<br>1 - Пользовательский размер.|
|width|<|integer|Ширина области.<br>Поддерживается, если для `areatype` установлено значение `1`.|
|height|<|integer|Высота области.<br>Поддерживается, если для `areatype` установлено значение `1`.|
|viewtype|<|integer|Алгоритм размещения области.<br>Поддерживается, если для `elementsubtype` установлено значение `1`.<br>Возможные значения:<br>0 - Равномерно размещать в области.|
|use\_iconmap|<|integer|Использовать сопоставление значков для этого элемента. Актуально только если сопоставление значков включено на уровне карты.<br>Возможные значения:<br>0 - Нет;<br>1 - Да.|
|selementid|<|id|Уникальный ID записи элемента.|
|icon\_off|<| |Корневой элемент для изображения, используемого, когда элемент находится в состоянии **`OK`**.|
| |name|string|Уникальное имя изображения.|
|icon\_on|<| |Корневой элемент для изображения, используемого, когда элемент находится в состоянии **`Problem`**.|
| |name|string|Уникальное имя изображения.|
|icon\_disabled|<| |Корневой элемент для изображения, используемого, когда элемент отключен.|
| |name|string|Уникальное имя изображения.|
|icon\_maintenance|<| |Корневой элемент для изображения, используемого, когда элемент находится в обслуживании.|
| |name|string|Уникальное имя изображения.|
|urls|<| |Корневой элемент для URL, используемых картами или каждым элементом карты.|
|<|name|string|Имя ссылки.|
|^|url|string|URL ссылки.|
|evaltype|<|integer|Тип оценки для тегов.|
|tags|<| |Корневой элемент для тегов проблемы (для элементов узла сети и группы узлов сети).<br>Если указаны теги, на карте будут отображаться только проблемы с этими тегами.|
|<|tag|string|Имя тега.|
|^|value|string|Значение тега.|
|^|operator|integer|Оператор.|

::: noteclassic
См. также: [Объект элемента карты](/manual/api/reference/map/object#map-element) (см. соответствующее свойство с совпадающим именем).
:::

[comment]: # ({/917b09e0-40b8b222})

[comment]: # ({0f0ec9b8-d0768fc5})
##### Индикаторы состояния связей карты

|Элемент|<|Тип|Описание|
|-|---|---|-----------------------|
|drawtype|<|целое число|Стиль связи, когда триггер в состоянии «Проблема».<br>Возможные значения:<br>0 — Линия;<br>2 — Жирная линия;<br>3 — Точечная линия;<br>4 — Пунктирная линия.|
|color|<|строка|Цвет связи (6 символов, hex), когда триггер в состоянии «Проблема».|
|trigger|<| |Корневой элемент для триггера, используемого для индикации состояния связи.|
|<|description|строка|Имя триггера.|
|^|expression|строка|Выражение триггера.|
|^|recovery\_expression|строка|Выражение восстановления триггера.|

::: noteclassic
Смотрите также: [Объект карты сети](/manual/api/reference/map/object#map-link-trigger) (смотрите соответствующее свойство с совпадающим именем).
:::

[comment]: # ({/0f0ec9b8-d0768fc5})
