[comment]: # aside: 1
[comment]: # ({057bb0ae-a79e0e24})
# Oggetto dashboard
I seguenti oggetti sono direttamente correlati all'API `dashboard`.
[comment]: # ({/057bb0ae-a79e0e24})
[comment]: # ({2f0cf290-63e4049e})
### Dashboard
L'oggetto dashboard ha le seguenti proprietà.
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|dashboardid|ID|ID della dashboard.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*
- *obbligatoria* per le operazioni di aggiornamento|
|name|string|Nome della dashboard.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria* per le operazioni di creazione|
|userid|ID|ID dell'utente proprietario della dashboard.|
|private|integer|Tipo di condivisione della dashboard.
Valori possibili:
0 - dashboard pubblica;
1 - *(predefinita)* dashboard privata.|
|display\_period|integer|Periodo di visualizzazione predefinito della pagina (in secondi).
Valori possibili: 10, 30, 60, 120, 600, 1800, 3600.
Predefinito: 30.|
|auto\_start|integer|Avvio automatico della presentazione.
Valori possibili:
0 - non avviare automaticamente la presentazione;
1 - *(predefinito)* avviare automaticamente la presentazione.|
[comment]: # ({/2f0cf290-63e4049e})
[comment]: # ({8068dbc3-b88f0a6a})
### Pagina della dashboard
L'oggetto pagina della dashboard ha le seguenti proprietà.
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|dashboard\_pageid|ID|ID della pagina della dashboard.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *sola lettura*|
|name|string|Nome della pagina della dashboard.
Predefinito: stringa vuota.|
|display\_period|integer|Periodo di visualizzazione della pagina della dashboard (in secondi).
Valori possibili: 0, 10, 30, 60, 120, 600, 1800, 3600.
Predefinito: 0 (verrà utilizzato il periodo di visualizzazione predefinito della pagina).|
|widgets|array|Array degli oggetti [widget della dashboard](object#dashboard-widget).|
[comment]: # ({/8068dbc3-b88f0a6a})
[comment]: # ({4605b3fa-2938b685})
#### Widget della dashboard
L'oggetto widget della dashboard ha le seguenti proprietà.
|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|widgetid|ID|ID del widget della dashboard.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *read-only*|
|type|string|Tipo del widget della dashboard.
Valori possibili:
actionlog - Registro azioni;
clock - Orologio;
discovery - Stato della discovery;
favgraphs - Grafici preferiti;
favmaps - Mappe preferite;
gauge - Indicatore;
geomap - Geomap;
graph - Grafico (classico);
graphprototype - Prototipo di grafico;
honeycomb - Honeycomb;
hostavail - Disponibilità dell'host;
hostcard - Scheda host;
hostnavigator - Navigatore host;
itemcard - Scheda item;
itemhistory - Cronologia item;
itemnavigator - Navigatore item;
item - Valore item;
map - Mappa;
navtree - Albero di navigazione della mappa;
piechart - Grafico a torta;
problemhosts - Host con problemi;
problems - Problemi;
problemsbysv - Problemi per gravità;
slareport - Report SLA;
svggraph - Grafico;
systeminfo - Informazioni di sistema;
tophosts - Host principali;
topitems - Item principali;
toptriggers - Trigger principali;
trigover - Panoramica trigger;
url - URL;
web - Monitoraggio web.
[Property behavior](/manual/api/reference_commentary#property-behavior):
- *required*|
|name|string|Nome personalizzato del widget.|
|x|integer|Una posizione orizzontale dal lato sinistro della dashboard.
I valori possibili vanno da 0 a 71.|
|y|integer|Una posizione verticale dalla parte superiore della dashboard.
I valori possibili vanno da 0 a 63.|
|width|integer|La larghezza del widget.
I valori possibili vanno da 1 a 72.|
|height|integer|L'altezza del widget.
I valori possibili vanno da 1 a 64.|
|view\_mode|integer|La modalità di visualizzazione del widget.
Valori possibili:
0 - *(default)* visualizzazione predefinita del widget;
1 - con intestazione nascosta;|
|fields|array|Array degli oggetti [campo del widget della dashboard](object#dashboard-widget-field).
[Property behavior](/manual/api/reference_commentary#property-behavior):
- vedere i singoli widget in [Campi del widget della dashboard](/manual/api/reference/dashboard/widget_fields)|
[comment]: # ({/4605b3fa-2938b685})
[comment]: # ({80d139ee-5b20bc04})
##### Campo del widget della dashboard
L'oggetto campo del widget della dashboard ha le seguenti proprietà.
|Proprietà|[Tipo](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|type|integer|Tipo del campo del widget.
Valori possibili:
0 - Intero;
1 - Stringa;
2 - Gruppo di host;
3 - Host;
4 - Item;
5 - Prototipo di item;
6 - Grafico;
7 - Prototipo di grafico;
8 - Mappa;
9 - Servizio;
10 - SLA;
11 - Utente;
12 - Azione;
13 - Tipo di supporto.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|name|string|Nome del campo del widget.
Valori possibili: vedere [Campi del widget della dashboard](/manual/api/reference/dashboard/widget_fields).
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
|value|mixed|Valore del campo del widget in base al tipo.
Valori possibili: vedere [Campi del widget della dashboard](/manual/api/reference/dashboard/widget_fields).
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatorio*|
[comment]: # ({/80d139ee-5b20bc04})
[comment]: # ({ef4c6e72-5c8b3411})
### Gruppo utenti della dashboard
Elenco delle autorizzazioni della dashboard in base ai gruppi utenti. Ha le seguenti
proprietà.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|usrgrpid|ID|ID del gruppo utenti.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|permission|integer|Tipo di livello di autorizzazione.
Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
[comment]: # ({/ef4c6e72-5c8b3411})
[comment]: # ({2e421fc3-d34afa0c})
### Utente dashboard
Elenco dei permessi della dashboard in base agli utenti. Ha le seguenti
proprietà.
|Proprietà|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|userid|ID|ID dell'utente.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
|permission|integer|Tipo di livello di permesso.
Valori possibili:
2 - sola lettura;
3 - lettura-scrittura.
[Comportamento della proprietà](/manual/api/reference_commentary#property-behavior):
- *obbligatoria*|
[comment]: # ({/2e421fc3-d34afa0c})