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

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

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

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

Este método permite actualizar los tableros existentes.

::: noteclassic
Este método está disponible para usuarios de cualquier tipo. Los permisos
para llamar al método se pueden revocar en la configuración de roles de usuario. Ver [Roles de usuario](/manual/web_interface/frontend_sections/administration/user_roles)
para más información.
:::

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

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

`(objeto/matriz)` Propiedades del panel que se actualizarán.

La propiedad `dashboardid` debe especificarse para cada tablero, todas las
otras propiedades son opcionales. Sólo las propiedades especificadas serán
actualizadas.

Además de las [propiedades estándar del tablero](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](object#dashboard_page) del tablero para reemplazar las páginas del tablero existentes.<br><br>Las páginas del tablero se actualizan mediante la propiedad `dashboard_pageid`. Se crearán nuevas páginas del tablero sin la propiedad `dashboard_pageid` y las páginas del tablero existentes se eliminarán si no se reutilizan. Las páginas del tablero se ordenarán en el mismo orden especificado. Solo se actualizarán las propiedades especificadas de las páginas del tablero. Se requiere al menos un objeto de página del tablero para la propiedad `pages`.|
|users|matriz|El [usuario](objeto#dashboard_user) que comparte el tablero para reemplazar los elementos existentes.|
|userGroups|matriz|El [grupo de usuarios](object#dashboard_user_group) que comparte el tablero para reemplazar los elementos existentes.|

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

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

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

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

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

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### Cambiar el nombre de un panel

Cambiar el nombre de un tablero a "Estado del servidor SQL".

Solicitud:

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

Respuesta:

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

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

[comment]: # ({891d2164-b8348b8a})
#### Actualización de las páginas del tablero

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

Solicitud:

```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
}
```

Respuesta:

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

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

[comment]: # ({d82abd77-e4a57dd3})
#### Cambiar propietario del tablero

Disponible solo para administradores y superadministradores.

Solicitud:

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

Respuesta:

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

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

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

- [Página del tablero](object#dashboard_page)
- [Widget del tablero] (object#dashboard_widget)
- [Campo del widget del tablero](object#dashboard_widget_field)
- [Usuario del tablero](object#dashboard_user)
- [Grupo de usuarios del tablero] (object#dashboard_user_group)

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

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

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

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