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

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

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

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

Цей метод дозволяє оновити наявні інформаційні панелі.

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

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

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

`(object/array)` властивості інформаційної панелі, які потрібно оновити.

Для кожної інформаційної панелі необхідно вказати властивість `dashboardid`, усі інші властивості необов’язкові. Буде оновлено лише вказані властивості.

Окрім [стандартних властивостей інформаційної панелі](object#dashboard), метод приймає такі параметри.

|Параметр|[Тип](/manual/api/reference_commentary#data_types)|Опис|
|--|--|------|
|pages|array|Інформаційна панель [сторінки](object#dashboard_page) для заміни існуючих сторінок інформаційної панелі.<br><br>Сторінки інформаційної панелі оновлюються за допомогою властивості `dashboard_pageid`. Буде створено нові сторінки інформаційної панелі для об’єктів без властивості `dashboard_pageid`, а наявні сторінки інформаційної панелі буде видалено, якщо вони не будуть використані повторно. Сторінки інформаційної панелі будуть упорядковані в тому ж порядку, що й указано. Буде оновлено лише вказані властивості сторінок інформаційної панелі. Для властивості `pages` потрібен принаймні один об’єкт сторінки приладної панелі.|
|users|масив|Інформаційна панель [користувач](object#dashboard_user) ділиться для заміни існуючих елементів.|
|userGroups|масив|Інформаційна панель [група користувачів](object#dashboard_user_group) ділиться для заміни існуючих елементів.|

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

[comment]: # ({28e89b38-28e89b38})
### Повернуті значення

`(object)` Повертає об’єкт, що містить ідентифікатори оновлених інформаційних панелей у властивості `dashboardids`.

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

[comment]: # ({b41637d2-b41637d2})
### Приклади

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### Перейменування інформаційної панелі

Перейменуйте інформаційну панель на «Стан сервера SQL».

Запит:

```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]: # ({891d2164-b8348b8a})
#### Оновлення сторінок панелі інструментів

Перейменуйте першу сторінку інформаційної панелі, замініть віджети на другій сторінці інформаційної панелі та додайте нову сторінку як третю. Видаліть усі інші сторінки інформаційної панелі.

Запит:

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

Відповідь:

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

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

[comment]: # ({d82abd77-e4a57dd3})
#### Змінити власника інформаційної панелі

Доступно лише для адміністраторів і суперадміністраторів.

Запит:

```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#dashboard_page)
- [Віджет інформаційної панелі](object#dashboard_widget)
- [Поле віджета інформаційної панелі](object#dashboard_widget_field)
- [Користувач інформаційної панелі](object#dashboard_user)
- [Група користувачів панелі інструментів](object#dashboard_user_group)

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

[comment]: # ({456ac32b-456ac32b})
### Джерело

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

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