Documentation
19 地图导航树
描述
这些参数以及相应仪表板 widget 字段的可能属性值 objects 允许在 dashboard.create 和 dashboard.update 方法中配置 Map navigation tree widget。
widget fields 属性在仪表板创建或 update 期间不会进行验证。
这允许用户修改 built-in widgets 和 create custom widgets，但也带来了创建或更新部件时出错的风险。
为确保成功创建或 update 地图导航树 部件，请参考下表中列出的参数行为。
参数
Map navigation tree小部件支持以下参数。
| 参数 | 仪表板小部件字段 | 名称 | 值 |
|---|---|---|---|
| Refresh interval | 0 | rf_rate | 0 - 无刷新; 10 - 10 秒; 30 - 30 秒; 60 - 1 分钟; 120 - 2 分钟; 600 - 10 分钟; 900 - (默认) 15 分钟。 |
| Show unavailable maps | 1 | show_unavailable | 0 - (默认) 已禁用； 1 - 已启用。 |
| Reference | 1 | reference | 任何由5字符组成的string值（例如：ABCDE 或 JBPNL）。此值在该widget所属的仪表板内必须唯一。参数行为： - 必填 |
以下参数支持配置地图导航树元素。
| 参数 | 仪表板小部件字段 | 名称 | 值 |
|---|---|---|---|
| Name | 1 | navtree.1.name | 任意 string 值。 注意：属性名称中的数字表示元素编号。 |
| Linked map | 8 | navtree.1.sysmapid | Map ID。 注意：属性名称中的数字引用的是与该地图关联的元素。 |
| Parameters for creating element hierarchy | 0 | navtree.1.parent | 父元素编号。 注意：属性名称中的编号引用子元素。属性值引用父元素。 |
| 0 | navtree.1.order | 地图导航树中元素的位置。 注意：属性名中的数字表示元素编号。属性值表示元素在地图导航树中的位置。父元素的位置是在整个地图导航树中确定的。子元素的位置是在父元素内确定的。 |
示例
以下示例仅用于描述如何为地图导航树小部件配置仪表板 widget 字段 objects。 有关配置仪表板的更多信息，请参阅 dashboard.create。
配置 地图导航树 部件
配置一个地图导航树 widget，用于显示以下地图导航树：
- 元素 A
- 元素 A1
- 元素 A2
- 元素 B
- 元素 B1 （包含链接地图 "1"，该地图可在 配置关联的-map-部件 中显示）
- 元素 B2
- 元素 C
执行请求:
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": 30,
"auto_start": 1,
"pages": [
{
"widgets": [
{
"type": "navtree",
"name": "Map navigation tree",
"x": 0,
"y": 0,
"width": 18,
"height": 5,
"view_mode": 0,
"fields": [
{
"type": 1,
"name": "navtree.1.name",
"value": "Element A"
},
{
"type": 1,
"name": "navtree.2.name",
"value": "Element B"
},
{
"type": 1,
"name": "navtree.3.name",
"value": "Element C"
},
{
"type": 1,
"name": "navtree.4.name",
"value": "Element A1"
},
{
"type": 1,
"name": "navtree.5.name",
"value": "Element A2"
},
{
"type": 1,
"name": "navtree.6.name",
"value": "Element B1"
},
{
"type": 1,
"name": "navtree.7.name",
"value": "Element B2"
},
{
"type": 0,
"name": "navtree.4.parent",
"value": 1
},
{
"type": 0,
"name": "navtree.5.parent",
"value": 1
},
{
"type": 0,
"name": "navtree.6.parent",
"value": 2
},
{
"type": 0,
"name": "navtree.7.parent",
"value": 2
},
{
"type": 0,
"name": "navtree.1.order",
"value": 1
},
{
"type": 0,
"name": "navtree.2.order",
"value": 2
},
{
"type": 0,
"name": "navtree.3.order",
"value": 3
},
{
"type": 0,
"name": "navtree.4.order",
"value": 1
},
{
"type": 0,
"name": "navtree.5.order",
"value": 2
},
{
"type": 0,
"name": "navtree.6.order",
"value": 1
},
{
"type": 0,
"name": "navtree.7.order",
"value": 2
},
{
"type": 8,
"name": "navtree.6.sysmapid",
"value": 1
},
{
"type": 1,
"name": "reference",
"value": "HJQXF"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}响应: