14 Árbol de navegación del mapa

Descripción

Estos parámetros y los valores de propiedad posibles para los objetos de campo del widget del dashboard respectivo permiten configurar el widget Árbol de navegación del mapa en los métodos dashboard.create y dashboard.update.

::: noteimportant 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 los widgets integrados 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 del mapa, consulte el comportamiento de los parámetros que se describen 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 referencia Cualquier valor de cadena que consta de 5 caracteres (por ejemplo, ABCDE, JBPNL, etc.).

El valor del parámetro Referencia se utiliza en el widget [Mapa] (/manual/api/reference/dashboard/widget_fields/map) (referencia del widget vinculado) para vincular con el widget árbol de navegación del mapa.

Comportamiento de parámetros:
- obligatorio

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:

  • Elemento A
    • Elemento A1
    • Elemento A2
  • Elemento B
  • Elemento 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
                   }
               ]
           },
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "dashboardids": [
                   "3"
               ]
           },
           "id": 1
       }

Ver también