Documentation
Table of Contents
14 Árbol de navegación del mapa
Descripción
Estos parámetros y los posibles valores de las propiedades para los respectivos objetos de campo del widget del tablero permiten configurar el widget Árbol de navegación de mapa en los métodos dashboard.create y dashboard.update.
Las propiedades de los "campos" del widget no se validan durante la creación o actualización de un tablero. Esto permite a los usuarios modificar built-in widgets y crear widgets personalizados, pero también introduce el riesgo de crear o actualizar widgets incorrectamente. Para garantizar la creación o actualización exitosa del widget Árbol de navegación de mapa, consulte el comportamiento de los parámetros descritos en las tablas siguientes.
Parámetros
Los siguientes parámetros son compatibles con el widget Árbol de navegación del mapa.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Intervalo de actualización | 0 | rf_rate | 0 - Sin actualización; 10 - 10 segundos; 30 - 30 segundos; 60 - 1 minuto; 120 - 2 minutos; 600 - 10 minutos; 900 - (predeterminado) 15 minutos. |
| Mostrar mapas no disponibles | 1 | show_unavailable | 0 - (predeterminado) Deshabilitado; 1 - Habilitado. |
| Referencia | 1 | reference | Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE, JBPNL, etc.).El valor del parámetro Referencia se utiliza en el [Mapa] (/manual/api/reference/dashboard/widget_fields/map) widget (referencia del widget vinculado) para vincular con el widget árbol de navegación del mapa. |
Se admiten los siguientes parámetros para configurar los elementos del árbol de navegación del mapa.
| Parámetro | tipo | nombre | valor |
|---|---|---|---|
| Nombre | 1 | navtree.name.1 | Cualquier valor de cadena. Nota: El número en el nombre de la propiedad establece el número del elemento. |
| Mapa vinculado | 8 | navtree.sysmapid.1 | Mapa ID. Nota: El número en el nombre de la propiedad hace referencia al elemento al que el mapa está vinculado. |
| Parámetros para crear jerarquía de elementos | 0 | navtree.parent.1 | Número de elemento principal. Nota: El número en el nombre de la propiedad hace referencia al elemento secundario. El valor de la propiedad hace referencia al elemento principal. |
| 0 | navtree.order.1 | Posición del elemento en el árbol de navegación del mapa. Nota: El número en el nombre de la propiedad hace referencia al número del elemento. El valor de la propiedad hace referencia a la posición del elemento en el árbol de navegación del mapa. La posición del elemento principal se determina dentro de todo el árbol de navegación del mapa. La posición del elemento hijo se determina dentro del elemento padre. |
Ejemplos
Los siguientes ejemplos pretenden describir únicamente la configuración de los objetos de campo del widget del tablero para el widget Árbol de navegación del mapa. Para obtener más información sobre cómo configurar un tablero, consulte dashboard.create.
Configuración de un widget Árbol de navegación del mapa
Configure un widget Árbol de navegación del mapa que muestre el siguiente árbol de navegación del mapa:
- Element A
- Element A1
- Element A2
- Element B
- Element B1 (contiene el mapa vinculado "1" que se puede mostrar en un widget de mapa vinculado)
- Element B2
- Element C
Solicitud:
{
"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": 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
}Respuesta: