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

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

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

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

Metoda pozwala na aktualizację istniejącego pulpitu.

::: noteclassic
Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia 
do wywoływania metody można odebrać w ustawieniach roli użytkownika. Zobacz [Role 
użytkownika](/manual/web_interface/frontend_sections/administration/user_roles) 
po więcej informacji.
:::

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

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

`(object/array)` Właściwości pulpitu do aktualizacji.

Właściwość `dashboardid` pmusi zostać określona dla wszyskich pulpitów, wszystkie
inne właściwości są opcjonalne. Tylko określone właściwości zostaną
zaktualizowane.

Oprócz [standardowych właściwości pulpitu](object#dashboard),
metoda akceptuje następujące parametry.

|Parametr|[Typ](/manual/api/reference_commentary#data_types)|Opis|
|--|--|------|
|pages|array|[Strony](object#dashboard_page) pulpitu do zastąpienia istniejących stron pulpitu.<br><br>Strony pulpitu są aktualizowane przez właściwość `dashboard_pageid`. Nowe strony pulpitu zostaną stworzone dla obiektów bez właściwości `dashboard_pageid`, natomiast istniejące strony pulpitu zostaną usunięte, jeśli nie zostaną ponownie użyte. Strony pulpitu zostaną uporządkowane w takiej samej kolejności, jak określono. Tylko określone właściwości pulpitu zostaną zaktualizowane. Przynajmniej jedna strona pulpitu jest wymagana dla właściwości `pages`.|
|users|array|Współdzieleni [użytkownicy](object#dashboard_user) pulpitu do zastąpienia istniejących.|
|userGroups|array|Współdzielone [grupy użytkowników](object#dashboard_user_group) pulpitu do zastąpienia istniejących.|

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

[comment]: # ({28e89b38-28e89b38})
### Zwracane wartości

`(object)` Zwraca obiekt zawierający identyfikatory zaktualizowanych
pulpitów pod właściwością `dashboardids`.

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

[comment]: # ({b41637d2-b41637d2})
### Przykłady

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

[comment]: # ({c1d3fbad-7fcf7de4})
#### Zmiana nazwy pulpitu

Zmień nazwę pulpitu na "SQL server status".

Zapytanie:

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

Odpowiedź:

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

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

[comment]: # ({891d2164-b8348b8a})
#### Aktualizacja stron pulpitu

Zmień nazwę pierwszej strony pulpitu, zamień widżety na drugiej stronie
pulpitu oraz dodaj nową stronę jako trzecią. Usuń wszystkie inne strony
pulpitu.

Zapytanie:

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

Odpowiedź:

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

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

[comment]: # ({d82abd77-e4a57dd3})
#### Zmiana właściciela pulpitu

Dostępne tylko dla Adminów i Super Adminów.

Zapytanie:

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

Odpowiedź:

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

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

[comment]: # ({299ae089-299ae089})
### Zobacz także

-   [Strona Pulpitu](object#dashboard_page)
-   [Widżet Pulpitu](object#dashboard_widget)
-   [Pole widżetu Pulpitu](object#dashboard_widget_field)
-   [Użytkownik pulpitu](object#dashboard_user)
-   [Grupa użytkowników Pulpitu](object#dashboard_user_group)

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

[comment]: # ({456ac32b-456ac32b})
### Źródło

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

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