[comment]: # translation:outdated

[comment]: # ({6d5ea9cd-6d5ea9cd})
# templatedashboard.update

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

[comment]: # ({e82cca7f-3db870df})
### Descrizione

`object templatedashboard.update(object/array templateDashboards)`

Questo metodo consente di aggiornare dashboard di template esistenti.

::: noteclassic
Questo metodo è disponibile solo per i tipi di utente *Admin* e *Super admin*.
Le autorizzazioni per chiamare il metodo possono essere revocate nelle impostazioni del ruolo utente.
Per ulteriori informazioni, vedere [Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/e82cca7f-3db870df})

[comment]: # ({d6006aad-051bc982})
### Parametri

`(object/array)` Proprietà del dashboard del template da aggiornare.

La proprietà `dashboardid` deve essere specificata per ciascun dashboard, tutte
le altre proprietà sono facoltative. Verranno
aggiornate solo le proprietà specificate.

Oltre alle [proprietà standard del dashboard del
template](object#template-dashboard), il metodo accetta i seguenti
parametri.

|Parametro|[Type](/manual/api/reference_commentary#data-types)|Descrizione|
|--|--|------|
|pages|array|[Pagine del dashboard del template](object#template-dashboard-page) per sostituire le pagine del dashboard esistenti.<br><br>Le pagine del dashboard vengono aggiornate tramite la proprietà `dashboard_pageid`. Le nuove pagine del dashboard verranno create per gli oggetti senza la proprietà `dashboard_pageid` e le pagine del dashboard esistenti verranno eliminate se non riutilizzate. Le pagine del dashboard saranno ordinate nello stesso ordine in cui sono specificate. Verranno aggiornate solo le proprietà specificate delle pagine del dashboard. Per la proprietà `pages` è richiesto almeno un oggetto pagina del dashboard.|

[comment]: # ({/d6006aad-051bc982})

[comment]: # ({d8b2cba8-d8b2cba8})
### Valori restituiti
`(object)` Restituisce un oggetto contenente gli ID dei modelli dashboard aggiornati
sotto la proprietà `dashboardids`.

[comment]: # ({/d8b2cba8-d8b2cba8})

[comment]: # ({b41637d2-b41637d2})
### Esempi

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({7e85dec3-7b6290ef})
#### Rinominare una dashboard di template

Rinominare una dashboard di template in "Performance graphs".

[Richiesta](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "templatedashboard.update",
    "params": {
        "dashboardid": "23",
        "name": "Performance graphs"
    },
    "id": 1
}
```

Risposta:

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

[comment]: # ({/7e85dec3-7b6290ef})

[comment]: # ({12c7c5a0-cf0dcd1e})
#### Aggiornamento delle pagine della dashboard del template

Rinominare la prima pagina della dashboard, sostituire i widget nella seconda
pagina della dashboard e aggiungere una nuova pagina come terza. Eliminare tutte le altre
pagine della dashboard.

[Request](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "templatedashboard.update",
    "params": {
        "dashboardid": "2",
        "pages": [
            {
                "dashboard_pageid": 1,
                "name": "Renamed Page"
            },
            {
                "dashboard_pageid": 2,
                "widgets": [
                    {
                        "type": "clock",
                        "x": 0,
                        "y": 0,
                        "width": 12,
                        "height": 3
                    }
                ]
            },
            {
                "display_period": 60
            }
        ]
    },
    "id": 1
}
```

Risposta:

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

[comment]: # ({/12c7c5a0-cf0dcd1e})

[comment]: # ({7b2285ce-24de180a})
### Vedi anche

-   [Widget dashboard del template](object#template-dashboard-widget)
-   [Campo del widget dashboard del template](object#template-dashboard-widget-field)

[comment]: # ({/7b2285ce-24de180a})

[comment]: # ({fb185432-fb185432})
### Fonte

CTemplateDashboard::update() in
*ui/include/classes/api/services/CTemplateDashboard.php*.

[comment]: # ({/fb185432-fb185432})