[comment]: # ({66fb9690-66fb9690})
# dashboard.update

[comment]: # ({/66fb9690-66fb9690})

[comment]: # ({f235159f-f235159f})
### Descripció

`object dashboard.update(object/array dashboards)`

Aquest mètode permet actualitzar taulers ja existents.

::: noteclassic
Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles).
:::

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

[comment]: # ({e326f7c3-62947aa0})
### Paràmetres

`(object/array)` Propietats del tauler a actualitzar.

La propietat `dashboardid` s'ha de definir per tot tauler; totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.

A més de les [propietats estàndard del tauler de control](object#dashboard), el mètode accepta els paràmetres següents.

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|---------|---------------------------------------------------|-----------|
|pages|array|[Pages](object#dashboard_page) del tauler enlloc de les pàgines existents.<br><br>Les pàgines del tauler són actualitzades per la propietat `dashboard_pageid`. Les noves pàgines del tauler es crearan per els objectes sense la propietat `dashboard_pageid` i les pàgines del tauler existents s'esborraran si no es reutilitzen pas. Les pàgines del tauler es classifiquen en el mateix ordre que l'especificat. Només les propietats especificades de les pàgines del tauler s'actualitzaran. Com a mínim cal un objecte de pàgina de tauler a la propietat `pages`.|
|users|array|[Usuari](object#dashboard_user) del tauler enlloc de l'existent.|
|userGroups|array|[Grup d'usuaris](object#dashboard_user_group) del tauler enlloc de l'existent.|

[comment]: # ({/e326f7c3-62947aa0})

[comment]: # ({28e89b38-28e89b38})
### Valors de retorn

`(object)` Torna un objecte que contingui els IDs dels taulers actualitzats sota la propietat `dashboardids`.

[comment]: # ({/28e89b38-28e89b38})

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

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### Reanomenant un tauler

Reanomenar el tauler com a "Estat del servidor SQL".

Petició:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "name": "SQL server status"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Resposta:

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

[comment]: # ({/c1d3fbad-7fcf7de4})

[comment]: # ({891d2164-b8348b8a})
#### Actualitzar les pàgines del tauler

Reanomenar la primera pàgina del tauler, reemplaçar els ginys a la segona pàgina i afegir una nova pàgina com a tercera del tauler. Esborrar la resta de pàgines del tauler.

Petició:

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

Resposta:

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

[comment]: # ({/891d2164-b8348b8a})

[comment]: # ({d82abd77-e4a57dd3})
#### Canviar el propietari del tauler

Disponible només per a admins i super admins.

Petició:

```json
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}
```

Resposta:

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

[comment]: # ({/d82abd77-e4a57dd3})

[comment]: # ({299ae089-299ae089})
### Veieu tamé

-   [Pàgina del tauler](object#dashboard_page)
-   [Giny del tauler](object#dashboard_widget)
-   [Camp de giny del tauler](object#dashboard_widget_field)
-   [Usuari del tauler](object#dashboard_user)
-   [Grup d'usuaris del tauler](object#dashboard_user_group)

[comment]: # ({/299ae089-299ae089})

[comment]: # ({456ac32b-456ac32b})
### Font

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

[comment]: # ({/456ac32b-456ac32b})