[comment]: # ({d052d97c-b1d00045})
# 17 Navigatore item
[comment]: # ({/d052d97c-b1d00045})
[comment]: # ({8f5d8398-a8620fa9})
### Descrizione
Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget della dashboard consentono di configurare
il widget [*Navigatore di elementi*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator) nei metodi `dashboard.create` e `dashboard.update`.
::: noteimportant
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](/manual/web_interface/frontend_sections/dashboards/widgets) e creare [widget personalizzati](/devel/modules/tutorials/widget), ma comporta anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o l'aggiornamento del widget *Navigatore di elementi*, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
:::
[comment]: # ({/8f5d8398-a8620fa9})
[comment]: # ({773e7746-43b2c246})
### Parametri
I seguenti parametri sono supportati per il widget *Item navigator*.
|Parametro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Intervallo di aggiornamento*|<|0|rf_rate|0 - Nessun aggiornamento;
10 - 10 secondi;
30 - 30 secondi;
60 - *(predefinito)* 1 minuto;
120 - 2 minuti;
600 - 10 minuti;
900 - 15 minuti.|
|*Gruppi di host*|<|2|groupids.0|ID del [gruppo di host](/manual/api/reference/hostgroup/get).
Nota: Per configurare più gruppi di host, creare un oggetto campo widget dashboard per ciascun gruppo di host con un numero incrementato nel nome della proprietà.
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Gruppi di host (Widget)*|1|groupids.\_reference|Invece dell'ID del [gruppo di host](/manual/api/reference/hostgroup/get):
`ABCDE._hostgroupids` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati per i gruppi di host.
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Host*|<|3|hostids.0|ID dell'[host](/manual/api/reference/host/get).
Nota: Per configurare più host, creare un oggetto campo widget dashboard per ciascun host con un numero incrementato nel nome della proprietà. Per più host, il parametro *Gruppi di host* non deve essere configurato affatto oppure deve essere configurato con almeno un gruppo di host a cui appartengono gli host configurati.
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|<|*Host (Widget/Dashboard)*|1|hostids.\_reference|Invece dell'ID dell'[host](/manual/api/reference/host/get):
`DASHBOARD.hostid` - imposta il [selettore host](/manual/web_interface/frontend_sections/dashboards/widgets#override-host) della dashboard come origine dati per gli host;
`ABCDE._hostid` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati per gli host.
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Tag host*|<|<|<|<|
|<|*Tipo di valutazione*|0|host_tags_evaltype|0 - *(predefinito)* And/Or;
2 - Or.
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Nome tag*|1|host_tags.0.tag|Qualsiasi valore stringa.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag host*
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Operatore*|0|host_tags.0.operator|0 - Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag host*
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Valore tag*|1|host_tags.0.value|Qualsiasi valore stringa.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag host*
Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|*Pattern item*|<|1|items.0|Nome o pattern dell'[item](/manual/api/reference/item/get).
Nota: Per configurare più pattern item, creare un oggetto campo widget dashboard per ciascun pattern item con un numero incrementato nel nome della proprietà.|
|*Tag item*|<|<|<|<|
|<|*Tipo di valutazione*|0|item_tags_evaltype|0 - *(predefinito)* And/Or;
2 - Or.|
|^|*Nome tag*|1|item_tags.0.tag|Qualsiasi valore stringa.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag item*|
|^|*Operatore*|0|item_tags.0.operator|0 - Contiene;
1 - Uguale a;
2 - Non contiene;
3 - Diverso da;
4 - Esiste;
5 - Non esiste.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag item*|
|^|*Valore tag*|1|item_tags.0.value|Qualsiasi valore stringa.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Tag item*|
|*Stato*|<|0|state|-1 - *(predefinito)* Tutti;
0 - Normale;
1 - Non supportato.|
|*Mostra problemi*|<|0|show_problems|0 - Tutti;
1 - *(predefinito)* Non soppressi;
2 - Nessuno.|
|*Raggruppa per*|<|<|<|<|
|<|*Attributo*|0|group_by.0.attribute|0 - Gruppo di host;
1 - Nome host;
2 - Valore del tag host;
3 - Valore del tag item.
Nota: Il numero nel nome della proprietà fa riferimento all'ordine dell'attributo nell'elenco degli attributi di raggruppamento.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Raggruppa per*|
|^|*Valore*|1|group_by.0.tag_name|Qualsiasi valore stringa.
Nota: Il numero nel nome della proprietà fa riferimento all'attributo di raggruppamento impostato nel parametro *Attributo*.
[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio* se si configura *Raggruppa per* e *Attributo* è impostato su "Valore del tag host" o "Valore del tag item"|
|*Limite item*|<|0|show_lines|I valori possibili vanno da 1 a 9999.
Predefinito: 100.|
|*Reference*|<|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](/manual/api/reference_commentary#parameter-behavior):
- *obbligatorio*|
[comment]: # ({/773e7746-43b2c246})
[comment]: # ({ffdf4230-d96958ab})
### Esempi
Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget della dashboard per il widget *Item navigator*.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere [`dashboard.create`](/manual/api/reference/dashboard/create).
[comment]: # ({/ffdf4230-d96958ab})
[comment]: # ({437d3f78-ae3ed50a})
#### Configurazione di un widget *Navigatore item*
Configurare un widget *Navigatore item* che visualizzi fino a 1000 item raggruppati per host e poi per il valore del tag item "component".
[Richiesta](/manual/api#performing-requests):
```json
{
"jsonrpc": "2.0",
"method": "dashboard.create",
"params": {
"name": "My dashboard",
"display_period": "30",
"auto_start": "1",
"pages": [
{
"widgets": [
{
"type": "itemnavigator",
"name": "Item navigator",
"x": "0",
"y": "0",
"width": "12",
"height": "5",
"view_mode": "0",
"fields": [
{
"type": 0,
"name": "group_by.0.attribute",
"value": 0
},
{
"type": 0,
"name": "group_by.1.attribute",
"value": 3
},
{
"type": 1,
"name": "group_by.1.tag_name",
"value": "component"
},
{
"type": 0,
"name": "show_lines",
"value": 1000
},
{
"type": 1,
"name": "reference",
"value": "DFNLK"
}
]
}
]
}
],
"userGroups": [
{
"usrgrpid": 7,
"permission": 2
}
],
"users": [
{
"userid": 1,
"permission": 3
}
]
},
"id": 1
}
```
Risposta:
```json
{
"jsonrpc": "2.0",
"result": {
"dashboardids": [
"3"
]
},
"id": 1
}
```
[comment]: # ({/437d3f78-ae3ed50a})
[comment]: # ({e9d30322-813ec286})
### Vedi anche
- [Campo del widget della dashboard](/manual/api/reference/dashboard/object#dashboard-widget-field)
- [`dashboard.create`](/manual/api/reference/dashboard/create)
- [`dashboard.update`](/manual/api/reference/dashboard/update)
[comment]: # ({/e9d30322-813ec286})