[comment]: # translation:outdated
[comment]: # ({5d9c8f6f-36d63c25})
# 13 Карта сети
[comment]: # ({/5d9c8f6f-36d63c25})
[comment]: # ({7168bc3f-5d3b49a4})
### Описание
Эти параметры и возможные значения свойств для соответствующих объектов полей виджета информационной панели позволяют настроить виджет [*Карта сети*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) в методах `dashboard.create` и `dashboard.update`.
::: noteimportant
Свойства полей виджета не проверяются во время создания или обновления информационной панели.
Это позволяет пользователям изменять [встроенные виджеты](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) и создавать [пользовательские виджеты](/manual/modules#developing-modules), но также создает риск неправильного создания или обновления виджетов.
Чтобы обеспечить успешное создание или обновление виджета *Карта сети*, ознакомьтесь с требованиями к параметрам, указанными в таблицах ниже.
:::
[comment]: # ({/7168bc3f-5d3b49a4})
[comment]: # ({new-e91ef9af})
### Parameters
The following parameters are supported for the *Map* widget.
|Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Refresh interval*|0|rf_rate|0 - No refresh;
10 - 10 seconds;
30 - 30 seconds;
60 - 1 minute;
120 - 2 minutes;
600 - 10 minutes;
900 - *(default)* 15 minutes.|
|*Source type*|0|source_type|1 - *(default)* Map;
2 - Map navigation tree.|
|*Map*|8|sysmapid|[Map](/manual/api/reference/map/get) ID.
Parameter *Map* required if *Source type* is set to "Map".|
|*Linked widget reference*|1|filter_widget_reference|Valid [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree) widget parameter *Reference* value.
Parameter *Linked widget reference* required if *Source type* is set to "Map navigation tree".|
[comment]: # ({/new-e91ef9af})
[comment]: # ({1509d89a-85e84f33})
### Примеры
Следующие примеры предназначены только для описания конфигурации объектов полей виджета информационной панели для виджета *Карта сети*.
Для получения дополнительной информации о настройке информационной панели см. [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/1509d89a-85e84f33})
[comment]: # ({new-ce6f770b})
#### Configuring a *Map* widget
Configure a *Map* widget that displays the map "1".
Request:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "map",
"name": "Map",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 8,
"name": "sysmapid",
"value": 1
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Response:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/new-ce6f770b})
[comment]: # ({new-a52bd53b})
#### Configuring a linked *Map* widget
Configure a *Map* widget that is linked to a [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget) widget.
Request:
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "map",
"name": "Map",
"x": 0,
"y": 5,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 0,
"name": "source_type",
"value": 2
},
{
"type": 1,
"name": "filter_widget_reference",
"value": "ABCDE"
}
]
},
{
"type": "navtree",
"name": "Map navigation tree",
"x": 0,
"y": 0,
"width": 6,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "navtree.name.1",
"value": "Element A"
},
{
"type": 1,
"name": "navtree.name.2",
"value": "Element B"
},
{
"type": 1,
"name": "navtree.name.3",
"value": "Element C"
},
{
"type": 1,
"name": "navtree.name.4",
"value": "Element A1"
},
{
"type": 1,
"name": "navtree.name.5",
"value": "Element A2"
},
{
"type": 1,
"name": "navtree.name.6",
"value": "Element B1"
},
{
"type": 1,
"name": "navtree.name.7",
"value": "Element B2"
},
{
"type": 0,
"name": "navtree.parent.4",
"value": 1
},
{
"type": 0,
"name": "navtree.parent.5",
"value": 1
},
{
"type": 0,
"name": "navtree.parent.6",
"value": 2
},
{
"type": 0,
"name": "navtree.parent.7",
"value": 2
},
{
"type": 0,
"name": "navtree.order.1",
"value": 1
},
{
"type": 0,
"name": "navtree.order.2",
"value": 2
},
{
"type": 0,
"name": "navtree.order.3",
"value": 3
},
{
"type": 0,
"name": "navtree.order.4",
"value": 1
},
{
"type": 0,
"name": "navtree.order.5",
"value": 2
},
{
"type": 0,
"name": "navtree.order.6",
"value": 1
},
{
"type": 0,
"name": "navtree.order.7",
"value": 2
},
{
"type": 8,
"name": "navtree.sysmapid.6",
"value": 1
},
{
"type": 1,
"name": "reference",
"value": "ABCDE"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}
```
Response:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/new-a52bd53b})
[comment]: # ({68e104c3-b648e5e7})
### Смотрите также
- [Поле виджета панели](/manual/api/reference/dashboard/object#поле-виджета-панели)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
- [Дерево навигации карт сетей](/manual/api/reference/dashboard/widget_fields/map_tree)
[comment]: # ({/68e104c3-b648e5e7})