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

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

[comment]: # ({becba6de-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/users/user_roles).
:::

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

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

`(object/array)` Tauler a actualitzar.

La propietat `dashboardid` s'ha de definir per a cada tauler, totes les altres propietats són opcionals. Només s'actualitzaran les propietats facilitades.

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

|Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció|
|--|--|------|
|pages|taula|[Pàgines del tauler](object#dashboard_page) substituint les pàgines del tauler de control existents.<br><br>Les pàgines del tauler de control s'actualitzen mitjançant la `propietat dashboard_pageid`. Es crearan pàgines de tauler noves per als objectes sense una propietat `dashboard_pageid` i les pàgines de tauler existents s'esborraran si no es reutilitzen. Les pàgines del tauler s'ordenaran en el mateix ordre especificat. Només s'actualitzaran les propietats especificades de les pàgines del tauler.|
|users|taula|Taulers d'[usuari](object#dashboard_user) per substituir els elements existents.|
|userGroups|taula|Tauler de [grup d'usuaris](object#dashboard_user_group) per substituir els elements existents.|

[comment]: # ({/38323bbf-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]: # ({d0eb0276-7fcf7de4})
#### Reanomenant un tauler

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

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

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

Resposta:

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

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

[comment]: # ({da48a540-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ó](/manual/api#performing-requests):

```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
            }
        ]
    },
    "id": 1
}
```

Resposta:

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

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

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

Disponible només per a admins i super admins.

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

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

Resposta:

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

[comment]: # ({/6990c258-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})