[comment]: # aside: 5

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

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

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

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

Este método permite actualizar paneles existentes.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método pueden ser revocados en la configuración del rol de usuario. Consulte [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para más información.
:::

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

[comment]: # ({bf54b1f0-62947aa0})
### Parámetros

`(objeto/array)` Propiedades del dashboard que se actualizarán.

La propiedad `dashboardid` debe definirse para cada dashboard, todas
las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas,
todas las demás permanecerán sin cambios.

Además de las [propiedades estándar del dashboard](object#dashboard),
el método acepta los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data-types)|Descripción|
|--|--|------|
|pages|array|[Páginas del dashboard](object#dashboard-page) para reemplazar las páginas existentes.<br><br>Las páginas del dashboard se actualizan por la propiedad `dashboard_pageid`. Se crearán nuevas páginas para los objetos sin la propiedad `dashboard_pageid` y las páginas existentes se eliminarán si no se reutilizan. Las páginas del dashboard se ordenarán en el mismo orden que se especifique. Sólo se actualizarán las propiedades especificadas de las páginas del dashboard.|
|users|array|[Usuarios del dashboard](object#dashboard-user) para reemplazar los elementos existentes.|
|userGroups|array|[Grupos de usuarios del dashboard](object#dashboard-user-group) para reemplazar los elementos existentes.|

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

[comment]: # ({28e89b38-28e89b38})
### Valores de retorno

`(object)` Devuelve un objeto que contiene los IDs de los tableros actualizados bajo la propiedad `dashboardids`.

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

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

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

[comment]: # ({d0eb0276-7fcf7de4})
#### Renombrar un panel

Renombrar un panel a "Estado del servidor SQL".

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

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

Respuesta:

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

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

[comment]: # ({ed5d0499-b8348b8a})
#### Actualización de páginas del panel

Cambie el nombre de la primera página del panel, reemplace los widgets en la segunda página del panel y agregue una nueva página como la tercera. Elimine todas las demás páginas del panel.

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

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

Respuesta:

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

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

[comment]: # ({6990c258-e4a57dd3})
#### Cambiar propietario del panel

Disponible solo para administradores y superadministradores.

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

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

Respuesta:

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

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

[comment]: # ({9c4ba6ce-299ae089})
### Ver también

-   [Página de dashboard](object#dashboard-page)
-   [Widget de dashboard](object#dashboard-widget)
-   [Campo de widget de dashboard](object#dashboard-widget-field)
-   [Usuario de dashboard](object#dashboard-user)
-   [Grupo de usuarios de dashboard](object#dashboard-user-group)

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

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

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

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