[comment]: # translation:outdated

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

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

[comment]: # ({f235159f-f235159f})
### Описание

`object dashboard.update(объект/массив dashboards)`

Этот метод позволяет обновлять существующие панели.

::: noteclassic
Этот метод доступен пользователям любого типа.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/administration/user_roles).
:::

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

[comment]: # ({new-62947aa0})
### Параметры

`(объект/массив)` Свойства панели, которые будут обновлены.

Свойство `dashboardid` должно быть указано по каждой панели, все
остальные свойства опциональны. Будут обновлены только переданные
свойства, все остальные останутся неизменными.

В дополнение к [стандартным свойствам панели](object#панель), этот метод
принимает следующие параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|widgets|массив|[Виджеты панели](object#виджет_панели), которые заменят существующие виджеты панели.<br><br>Виджеты панели обновляются свойством `widgetid`. Виджеты без свойства `widgetid` будут создаваться.|
|users|массив|Общий доступ [пользователю панели](object#пользователь_панели), который заменит существующие элементы.|
|userGroups|массив|Общий доступ [группе пользователей панели](object#группа_пользователей_панели), которая заменит существующие элементы.|

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

[comment]: # ({28e89b38-28e89b38})
### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID обновленных панелей, указанных в свойстве `dashboardids`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### Переименование панели

Переименовать панель в "SQL server status".

Запрос:

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

Ответ:

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

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

[comment]: # ({new-b8348b8a})
#### Изменение владельца панели

Доступно только администраторам и супер администраторам.

Запрос:

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

Ответ:

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

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

[comment]: # ({d82abd77-e4a57dd3})
#### Сменить владельца панели

Доступно только для пользователей *Admin* и *Super admin*.

Запрос:

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

Ответ:

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

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

[comment]: # ({299ae089-299ae089})
### Смотрите также

-   [Виджет панели](object#виджет_панели)
-   [Поле виджета панели](object#поле_виджета_панели)
-   [Пользователь панели](object#пользователь_панели)
-   [Группа пользователей панели](object#группа_пользователей_панели)

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

[comment]: # ({456ac32b-456ac32b})
### Источник

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

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