14 Map navigation tree

Description

These parameters and the possible property values for the respective dashboard widget field objects allow to configure the Map navigation tree widget in dashboard.create and dashboard.update methods.

Parameters

The following parameters are supported for the Map navigation tree widget.

Parametertypenamevalue
Refresh interval0rf_rate0 - No refresh;
10 - 10 seconds;
30 - 30 seconds;
60 - 1 minute;
120 - 2 minutes;
600 - 10 minutes;
900 - (default) 15 minutes.
Show unavailable maps1show_unavailable0 - (default) Disabled;
1 - Enabled.
Reference1referenceAny string value consisting of 5 characters (e.g. ABCDE, JBPNL, etc.).

Parameter Reference value is used in the Map widget (Linked widget reference) for linking with the Map navigation tree widget.

The following parameters are supported for configuring map navigation tree elements.

Parametertypenamevalue
Name1navtree.name.1Any string value.

Note: The number in the property name sets the element number.
Linked map8navtree.sysmapid.1Map ID.

Note: The number in the property name references the element to which the map is linked.
Parameters for creating element hierarchy0navtree.parent.1Parent element number.

Note: The number in the property name references the child element. The property value references the parent element.
0navtree.order.1Element position in the map navigation tree.

Note: The number in the property name references the element number. The property value references the element position in the map navigation tree. Parent element position is determined within the whole map navigation tree. Child element position is determined within the parent element.

Examples

The following examples aim to only describe the configuration of the dashboard widget field objects for the Map navigation tree widget. For more information on configuring a dashboard, see dashboard.create.

Configuring a Map navigation tree widget

Configure a Map navigation tree widget that displays the following map navigation tree:

  • Element A
    • Element A1
    • Element A2
  • Element B
    • Element B1 (contains linked map “1” that can be displayed in a linked Map widget)
    • Element B2
  • Element C

Request:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "method": "dashboard.create",
  4.            "params": {
  5.                "name": "My dashboard",
  6.                "display_period": 30,
  7.                "auto_start": 1,
  8.                "pages": [
  9.                    {
  10.                        "widgets": [
  11.                            {
  12.                                "type": "navtree",
  13.                                "name": "Map navigation tree",
  14.                                "x": 0,
  15.                                "y": 0,
  16.                                "width": 6,
  17.                                "height": 5,
  18.                                "view_mode": 0,
  19.                                "fields": [
  20.                                    {
  21.                                        "type": 1,
  22.                                        "name": "navtree.name.1",
  23.                                        "value": "Element A"
  24.                                    },
  25.                                    {
  26.                                        "type": 1,
  27.                                        "name": "navtree.name.2",
  28.                                        "value": "Element B"
  29.                                    },
  30.                                    {
  31.                                        "type": 1,
  32.                                        "name": "navtree.name.3",
  33.                                        "value": "Element C"
  34.                                    },
  35.                                    {
  36.                                        "type": 1,
  37.                                        "name": "navtree.name.4",
  38.                                        "value": "Element A1"
  39.                                    },
  40.                                    {
  41.                                        "type": 1,
  42.                                        "name": "navtree.name.5",
  43.                                        "value": "Element A2"
  44.                                    },
  45.                                    {
  46.                                        "type": 1,
  47.                                        "name": "navtree.name.6",
  48.                                        "value": "Element B1"
  49.                                    },
  50.                                    {
  51.                                        "type": 1,
  52.                                        "name": "navtree.name.7",
  53.                                        "value": "Element B2"
  54.                                    },
  55.                                    {
  56.                                        "type": 0,
  57.                                        "name": "navtree.parent.4",
  58.                                        "value": 1
  59.                                    },
  60.                                    {
  61.                                        "type": 0,
  62.                                        "name": "navtree.parent.5",
  63.                                        "value": 1
  64.                                    },
  65.                                    {
  66.                                        "type": 0,
  67.                                        "name": "navtree.parent.6",
  68.                                        "value": 2
  69.                                    },
  70.                                    {
  71.                                        "type": 0,
  72.                                        "name": "navtree.parent.7",
  73.                                        "value": 2
  74.                                    },
  75.                                    {
  76.                                        "type": 0,
  77.                                        "name": "navtree.order.1",
  78.                                        "value": 1
  79.                                    },
  80.                                    {
  81.                                        "type": 0,
  82.                                        "name": "navtree.order.2",
  83.                                        "value": 2
  84.                                    },
  85.                                    {
  86.                                        "type": 0,
  87.                                        "name": "navtree.order.3",
  88.                                        "value": 3
  89.                                    },
  90.                                    {
  91.                                        "type": 0,
  92.                                        "name": "navtree.order.4",
  93.                                        "value": 1
  94.                                    },
  95.                                    {
  96.                                        "type": 0,
  97.                                        "name": "navtree.order.5",
  98.                                        "value": 2
  99.                                    },
  100.                                    {
  101.                                        "type": 0,
  102.                                        "name": "navtree.order.6",
  103.                                        "value": 1
  104.                                    },
  105.                                    {
  106.                                        "type": 0,
  107.                                        "name": "navtree.order.7",
  108.                                        "value": 2
  109.                                    },
  110.                                    {
  111.                                        "type": 8,
  112.                                        "name": "navtree.sysmapid.6",
  113.                                        "value": 1
  114.                                    },
  115.                                    {
  116.                                        "type": 1,
  117.                                        "name": "reference",
  118.                                        "value": "ABCDE"
  119.                                    }
  120.                                ]
  121.                            }
  122.                        ]
  123.                    }
  124.                ],
  125.                "userGroups": [
  126.                    {
  127.                        "usrgrpid": 7,
  128.                        "permission": 2
  129.                    }
  130.                ],
  131.                "users": [
  132.                    {
  133.                        "userid": 1,
  134.                        "permission": 3
  135.                    }
  136.                ]
  137.            },
  138.            "id": 1
  139.        }

Response:

  1. {
  2.            "jsonrpc": "2.0",
  3.            "result": {
  4.                "dashboardids": [
  5.                    "3"
  6.                ]
  7.            },
  8.            "id": 1
  9.        }

See also