[comment]: # ({4f11bfeb-0ca55492})
# 21 Grafico a torta

[comment]: # ({/4f11bfeb-0ca55492})

[comment]: # ({a2d27881-732288b3})
### Descrizione

Questi parametri e i possibili valori delle proprietà per i rispettivi oggetti campo del widget dashboard consentono di configurare il widget [*Grafico a torta*](/manual/web_interface/frontend_sections/dashboards/widgets/pie_chart) nei metodi `dashboard.create` e `dashboard.update`.

::: noteimportant
Le proprietà `fields` del widget non vengono validate durante la creazione o l'aggiornamento di una dashboard.
Ciò consente agli utenti di modificare i [widget integrati](/manual/web_interface/frontend_sections/dashboards/widgets) e creare [widget personalizzati](/devel/modules/tutorials/widget), ma introduce anche il rischio di creare o aggiornare i widget in modo errato.
Per garantire la corretta creazione o il corretto aggiornamento del widget *Grafico a torta*, fare riferimento al comportamento dei parametri descritto nelle tabelle seguenti.
:::

[comment]: # ({/a2d27881-732288b3})

[comment]: # ({cec6505f-26d25426})
### Parametri

I seguenti parametri sono supportati per il widget *Grafico a torta*.

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Intervallo di aggiornamento*|0|rf_rate|0 - Nessun aggiornamento;<br>10 - 10 secondi;<br>30 - 30 secondi;<br>60 - *(predefinito)* 1 minuto;<br>120 - 2 minuti;<br>600 - 10 minuti;<br>900 - 15 minuti.|

[comment]: # ({/cec6505f-26d25426})

[comment]: # ({85a8987c-4242ce63})
#### Set di dati

I seguenti parametri sono supportati per configurare un *Set di dati*.

::: noteclassic
Il primo numero nel nome della proprietà (ad esempio ds.0.hosts.0, ds.0.items.0) rappresenta lo specifico set di dati, mentre il secondo numero, se presente, rappresenta l'host o l'item configurato.
:::

|Parametro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Tipo di set di dati*|<|0|ds.0.dataset_type|0 - Elenco item;<br>1 - *(predefinito)* Modelli di item.|
|<|*Item*|4|ds.0.itemids.0|ID [Item](/manual/api/reference/item/get).<br>Quando si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object), devono essere impostati solo gli item configurati sul template.<br><br>Nota: Per configurare più item, creare un oggetto campo widget della dashboard per ciascun item con un numero incrementato nel nome della proprietà.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Tipo di set di dati* è impostato su "Elenco item" e *Item (Widget)* non è impostato|
|^|*Item (Widget)*|1|ds.0.itemids.0.\_reference|Invece dell'ID [Item](/manual/api/reference/item/get):<br>`ABCDE._itemid` - 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 item.<br><br>Nota: Per configurare più widget, creare un oggetto campo widget della dashboard per ciascun widget con un numero incrementato nel nome della proprietà.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Tipo di set di dati* è impostato su "Elenco item" e *Item* non è impostato|
|^|*Colore*|1|ds.0.color.0|Codice colore esadecimale (ad esempio `FF0000`).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Tipo di set di dati* è impostato su "Elenco item"|
|^|*Tipo di item*|0|ds.0.type.0|0 - *(predefinito)* Normale;<br>1 - Totale.<br><br>Il valore "Totale" può essere impostato solo per un item nell'intero grafico.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo di set di dati* è impostato su "Elenco item"|
|^|*Modelli di host*|1|ds.0.hosts.0|Nome o modello di [Host](/manual/api/reference/host/get) (ad esempio, "Zabbix\*").<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Tipo di set di dati* è impostato su "Modelli di item"<br><br>Questo parametro non è supportato se si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object).|
|^|*Modelli di item*|1|ds.0.items.0|Nome o modello di [Item](/manual/api/reference/item/get) (ad esempio, "\*: Number of processed \*values per second").<br><br>Quando si configura il widget in una [dashboard template](/manual/api/reference/templatedashboard/object), devono essere impostati solo i modelli per gli item configurati sul template.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se *Tipo di set di dati* è impostato su "Modelli di item"|
|^|*Colore*|1|ds.0.color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo di set di dati* è impostato su "Modelli di item" e *Tavolozza colori* non è impostata|
|^|*Tavolozza colori*|0|ds.0.color_palette|Indice della tavolozza colori.<br><br>I valori possibili vanno da 0 a 11.<br><br>Predefinito: 0.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo di set di dati* è impostato su "Modelli di item" e *Colore* non è impostato|
|*Funzione di aggregazione*|<|0|ds.0.aggregate_function|1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - *(predefinito)* last.|
|*Aggregazione del set di dati*|<|0|ds.0.dataset_aggregation|0 - *(predefinito)* nessuna;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Tipo di item* è impostato su "Totale"|
|*Etichetta del set di dati*|<|1|ds.0.data_set_label|Qualsiasi valore stringa.<br><br>Predefinito: `""` (vuoto).|
|*Tag item*|<|<|<|<|
|<|*Tipo di valutazione*|0|ds.0.item_tags_evaltype|0 - *(predefinito)* And/Or;<br>2 - Or.|
|^|*Nome tag*|1|ds.0.item_tags.0.tag|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configurano i *Tag item*|
|^|*Operatore*|0|ds.0.item_tags.0.operator|0 - Contiene;<br>1 - Uguale a;<br>2 - Non contiene;<br>3 - Diverso da;<br>4 - Esiste;<br>5 - Non esiste.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configurano i *Tag item*|
|^|*Valore tag*|1|ds.0.item_tags.0.value|Qualsiasi valore stringa.<br><br>Nota: Il numero nel nome della proprietà fa riferimento all'ordine del tag nell'elenco di valutazione dei tag.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *obbligatorio* se si configurano i *Tag item*|

[comment]: # ({/85a8987c-4242ce63})

[comment]: # ({de5a8634-0a101fc7})
#### Opzioni di visualizzazione

I seguenti parametri sono supportati per configurare le *Opzioni di visualizzazione*.

|Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Selezione dei dati storici*|<|0|source|0 - *(predefinito)* Auto;<br>1 - Storico;<br>2 - Trend.|
|*Disegno*|<|0|draw_type|0 - *(predefinito)* Torta;<br>1 - Ciambella.|
|<|*Larghezza*|0|width|20 - 20% del raggio;<br>30 - 30% del raggio;<br>40 - 40% del raggio;<br>50 - *(predefinito)* 50% del raggio.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Disegno* è impostato su "Ciambella"|
|^|*Larghezza del bordo*|0|stroke|I valori possibili vanno da 0 a 10.<br><br>Predefinito: 0.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Disegno* è impostato su "Ciambella"|
|^|*Mostra valore totale*|0|total_show|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Disegno* è impostato su "Ciambella"|
|^|*Dimensione*|0|value_size_type|0 - *(predefinito)* Auto;<br>1 - Personalizzata.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|^|*Dimensione* (valore per dimensione personalizzata)|0|value_size|I valori possibili vanno da 1 a 100.<br><br>Predefinito: 20.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|^|*Posizioni decimali*|0|decimal_places|I valori possibili vanno da 0 a 6.<br><br>Predefinito: 2.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|^|*Unità* (casella di controllo)|0|units_show|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|^|*Unità* (valore)|1|units|Qualsiasi valore stringa.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unità* (casella di controllo) è impostato su "Abilitato"|
|^|*Grassetto*|0|value_bold|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|^|*Colore*|1|value_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra valore totale* è impostato su "Abilitato"|
|*Spazio tra i settori*|<|0|space|I valori possibili vanno da 0 a 10.<br><br>Predefinito: 1.|
|*Unisci i settori più piccoli di N%* (casella di controllo)|<|0|merge|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.|
|*Unisci i settori più piccoli di N%* (valore)|<|0|merge_percent|I valori possibili vanno da 1 a 10.<br><br>Predefinito: 1.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unisci i settori più piccoli di N%* (casella di controllo) è impostato su "Abilitato"|
|*Unisci i settori più piccoli di N%* (colore)|<|1|merge_color|Codice colore esadecimale (ad esempio `FF0000`).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Unisci i settori più piccoli di N%* (casella di controllo) è impostato su "Abilitato"|

[comment]: # ({/de5a8634-0a101fc7})

[comment]: # ({5ed444e7-eaf18233})
#### Periodo di tempo

I seguenti parametri sono supportati per la configurazione di *Periodo di tempo*.

|Parametro|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-|--------|--|--------|-------------------------------|
|*Periodo di tempo*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - imposta il [selettore del periodo di tempo](/manual/web_interface/time_period_selector) della dashboard come origine dati;<br>`ABCDE._timeperiod` - imposta un [widget compatibile](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (con il parametro *Reference* impostato su "`ABCDE`") come origine dati.<br><br>Predefinito: `DASHBOARD._timeperiod`<br><br>In alternativa, è possibile impostare il periodo di tempo solo nei parametri *Da* e *A*.|
|<|*Da*|1|time_period.from|Stringa temporale valida in sintassi temporale assoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, ecc.).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Periodo di tempo* non è impostato<br>- *obbligatorio* se `time_period.to` è impostato|
|^|*A*|1|time_period.to|Stringa temporale valida in sintassi temporale assoluta (`YYYY-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, ecc.).<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Periodo di tempo* non è impostato<br>- *obbligatorio* se `time_period.from` è impostato|

[comment]: # ({/5ed444e7-eaf18233})

[comment]: # ({374045cf-14fe7001})
#### Legenda

I seguenti parametri sono supportati per la configurazione della *Legenda*.

|Parametro|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value|
|-----|-|-----|-------------------|
|*Mostra legenda*|0|legend|0 - Disabilitato;<br>1 - *(predefinito)* Abilitato.|
|*Mostra valore*|0|legend_value|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra legenda* è impostato su "Abilitato"|
|*Mostra funzione di aggregazione*|0|legend_aggregation|0 - *(predefinito)* Disabilitato;<br>1 - Abilitato.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra legenda* è impostato su "Abilitato"|
|*Righe*|0|legend_lines_mode|0 - *(predefinito)* Fisso;<br>1 - Variabile.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra legenda* è impostato su "Abilitato"|
|*Numero di righe/*<br>*Numero massimo di righe*|0|legend_lines|I valori possibili vanno da 1 a 10.<br><br>Predefinito: 1.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra legenda* è impostato su "Abilitato"|
|*Numero di colonne*|0|legend_columns|I valori possibili vanno da 1 a 4.<br><br>Predefinito: 4.<br><br>[Comportamento del parametro](/manual/api/reference_commentary#parameter-behavior):<br>- *supportato* se *Mostra legenda* è impostato su "Abilitato" e *Mostra valore* è impostato su "Disabilitato"|

[comment]: # ({/374045cf-14fe7001})

[comment]: # ({fe51a06c-6e39aeb1})
### Esempi

Gli esempi seguenti hanno lo scopo di descrivere solo la configurazione degli oggetti campo del widget del widget *Grafico a torta*.
Per ulteriori informazioni sulla configurazione di una dashboard, vedere [`dashboard.create`](/manual/api/reference/dashboard/create).

[comment]: # ({/fe51a06c-6e39aeb1})

[comment]: # ({965cf4d2-87f20d96})
#### Configurazione di un widget *Grafico a torta*

Configurare un widget *Grafico a torta* nel modo seguente:

-   2 set di dati per un totale di 9 item su 1 host.
-   Il primo set di dati è di tipo "Elenco item" ed è composto da 3 item, tutti di tipo "Normale" e rappresentati da un colore diverso.
-   Il secondo set di dati è di tipo "Pattern di item", è composto da 6 item, ha un'aggregazione configurata per ciascun item ed è rappresentato da un colore personalizzato.
-   Il secondo set di dati ha anche un'etichetta del set di dati personalizzata.
-   I dati nel grafico a torta sono visualizzati come grafico ad anello con una larghezza personalizzata e il valore totale con unità al centro.
-   I dati nel grafico a torta sono visualizzati e aggregati per un periodo di tempo personalizzato delle ultime 3 ore.
-   La legenda del grafico a torta visualizza gli item configurati in 4 righe.

[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": "piechart",
                        "name": "Pie chart",
                        "x": 0,
                        "y": 0,
                        "width": 24,
                        "height": 5,
                        "view_mode": 0,
                        "fields": [
                            {
                                "type": 0,
                                "name": "ds.0.dataset_type",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.0",
                                "value": 23264
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.0",
                                "value": "FF0000"
                            },
                            {
                                "type": 0,
                                "name": "ds.0.type.0",
                                "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.1",
                                "value": 23269
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.1",
                                "value": "BF00FF"
                            },
                            {
                              "type": 0,
                              "name": "ds.0.type.1",
                              "value": 0
                            },
                            {
                                "type": 4,
                                "name": "ds.0.itemids.2",
                                "value": 23257
                            },
                            {
                                "type": 1,
                                "name": "ds.0.color.2",
                                "value": "0040FF"
                            },
                            {
                              "type": 0,
                              "name": "ds.0.type.2",
                              "value": 0
                            },
                            {
                                "type": 1,
                                "name": "ds.1.hosts.0",
                                "value": "Zabbix server"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.items.0",
                                "value": "*: Number of processed *values per second"
                            },
                            {
                                "type": 1,
                                "name": "ds.1.color",
                                "value": "000000"
                            },
                            {
                                "type": 0,
                                "name": "ds.1.aggregate_function",
                                "value": 3
                            },
                            {
                                "type": 1,
                                "name": "ds.1.data_set_label",
                                "value": "Number of processed values per second"
                            },
                            {
                                "type": 0,
                                "name": "draw_type",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "width",
                                "value": 30
                            },
                            {
                                "type": 0,
                                "name": "total_show",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "units_show",
                                "value": 1
                            },
                            {
                                "type": 0,
                                "name": "graph_time",
                                "value": 1
                            },
                            {
                                "type": 1,
                                "name": "time_period.from",
                                "value": "now-3h"
                            },
                            {
                                "type": 1,
                                "name": "time_period.to",
                                "value": "now"
                            },
                            {
                                "type": 0,
                                "name": "legend_lines",
                                "value": 4
                            }
                        ]
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": 7,
                "permission": 2
            }
        ],
        "users": [
            {
                "userid": 1,
                "permission": 3
            }
        ]
    },
    "id": 1
}
```

Risposta:

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

[comment]: # ({/965cf4d2-87f20d96})

[comment]: # ({e9d30322-f3cd71ca})
### 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-f3cd71ca})