[comment]: # translation:outdated

[comment]: # aside:5

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

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

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

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

Ta metoda umożliwia aktualizację istniejących pulpitów.

::: noteclassic
Ta metoda jest dostępna dla użytkowników dowolnego typu. Uprawnienia
do wywołania tej metody mogą zostać cofnięte w ustawieniach ról użytkowników. Więcej informacji można znaleźć w [User
roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Właściwości dashboardu do zaktualizowania.

Właściwość `dashboardid` musi być zdefiniowana dla każdego dashboardu, wszystkie
pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko przekazane
właściwości, wszystkie pozostałe pozostaną bez zmian.

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

|Parametr|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|pages|array|[Strony dashboardu](object#dashboard-page), które zastąpią istniejące strony dashboardu.<br><br>Strony dashboardu są aktualizowane za pomocą właściwości `dashboard_pageid`. Nowe strony dashboardu zostaną utworzone dla obiektów bez właściwości `dashboard_pageid`, a istniejące strony dashboardu zostaną usunięte, jeśli nie zostaną ponownie użyte. Strony dashboardu zostaną uporządkowane w tej samej kolejności, w jakiej zostały podane. Zaktualizowane zostaną tylko określone właściwości stron dashboardu.|
|users|array|Udostępnienia [użytkownikom dashboardu](object#dashboard-user), które zastąpią istniejące elementy.|
|userGroups|array|Udostępnienia [grupom użytkowników dashboardu](object#dashboard-user-group), które zastąpią istniejące elementy.|

[comment]: # ({/bf54b1f0-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]: # ({d0eb0276-7fcf7de4})
#### Zmienianie nazwy pulpitu

Zmień nazwę pulpitu na „SQL server status”.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({ed5d0499-b8348b8a})
#### Aktualizowanie stron pulpitu

Zmień nazwę pierwszej strony pulpitu, zastąp widgety na drugiej stronie pulpitu
i dodaj nową stronę jako trzecią. Usuń wszystkie pozostałe strony
pulpitu.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({6990c258-e4a57dd3})
#### Zmień właściciela pulpitu

Dostępne tylko dla administratorów i super administratorów.

[Żądanie](/manual/api#performing-requests):

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

Odpowiedź:

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

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

[comment]: # ({9c4ba6ce-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]: # ({/9c4ba6ce-299ae089})

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

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

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