20 Albero di navigazione della mappa
Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget Albero di navigazione della mappa nei metodi dashboard.create e dashboard.update.
Le proprietà fields del widget non vengono convalidate durante la creazione o l'aggiornamento di una dashboard.
Questo consente agli utenti di modificare i widget built-in e creare widget personalizzati, ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget Albero di navigazione della mappa, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
Parametri
I seguenti parametri sono supportati per il widget Albero di navigazione mappe.
| Parametro | type | name | value |
|---|---|---|---|
| Intervallo di aggiornamento | 0 | rf_rate | 0 - Nessun aggiornamento; 10 - 10 secondi; 30 - 30 secondi; 60 - 1 minuto; 120 - 2 minuti; 600 - 10 minuti; 900 - (predefinito) 15 minuti. |
| Mostra mappe non disponibili | 1 | show_unavailable | 0 - (predefinito) Disabilitato; 1 - Abilitato. |
| Riferimento | 1 | reference | Qualsiasi valore stringa composto da 5 caratteri (ad esempio, ABCDE o JBPNL). Questo valore deve essere univoco all'interno della dashboard a cui appartiene il widget.Comportamento del parametro: - obbligatorio |
I seguenti parametri sono supportati per la configurazione degli elementi dell'albero di navigazione mappe.
| Parametro | type | name | value |
|---|---|---|---|
| Nome | 1 | navtree.1.name | Qualsiasi valore stringa. Nota: Il numero nel nome della proprietà imposta il numero dell'elemento. |
| Mappa collegata | 8 | navtree.1.sysmapid | ID della mappa. Nota: Il numero nel nome della proprietà fa riferimento all'elemento a cui è collegata la mappa. |
| Parametri per la creazione della gerarchia degli elementi | 0 | navtree.1.parent | Numero dell'elemento padre. Nota: Il numero nel nome della proprietà fa riferimento all'elemento figlio. Il valore della proprietà fa riferimento all'elemento padre. |
| 0 | navtree.1.order | Posizione dell'elemento nell'albero di navigazione mappe. Nota: Il numero nel nome della proprietà fa riferimento al numero dell'elemento. Il valore della proprietà fa riferimento alla posizione dell'elemento nell'albero di navigazione mappe. La posizione dell'elemento padre è determinata all'interno dell'intero albero di navigazione mappe. La posizione dell'elemento figlio è determinata all'interno dell'elemento padre. |
Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget Map navigation tree.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere dashboard.create.
Configurazione di un widget Albero di navigazione mappa
Configurare un widget Albero di navigazione mappa che visualizzi il seguente albero di navigazione della mappa:
- Elemento A
- Elemento A1
- Elemento A2
- Elemento B
- Elemento B1 (contiene la mappa collegata "1" che può essere visualizzata in un widget Mappa collegato)
- Elemento B2
- Elemento 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
}Risposta:
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}