[comment]: # translation:outdated

[comment]: # ({6d5ea9cd-6d5ea9cd})
# templatedashboard.update

[comment]: # ({/6d5ea9cd-6d5ea9cd})

[comment]: # ({e82cca7f-3db870df})
### Opis

`object templatedashboard.update(object/array templateDashboards)`

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

::: noteclassic
Ta metoda jest dostępna tylko dla typów użytkowników *Admin* i *Super admin*.
Uprawnienia do wywoływania tej metody mogą zostać cofnięte w ustawieniach roli użytkownika.
Więcej informacji można znaleźć w sekcji [Role
użytkowników](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/e82cca7f-3db870df})

[comment]: # ({d6006aad-051bc982})
### Parametry

`(object/array)` Właściwości pulpitu nawigacyjnego szablonu do zaktualizowania.

Właściwość `dashboardid` musi być określona dla każdego pulpitu nawigacyjnego, wszystkie
pozostałe właściwości są opcjonalne. Zaktualizowane zostaną tylko
określone właściwości.

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

|Parametr|[Typ](/manual/api/reference_commentary#data-types)|Opis|
|--|--|------|
|pages|array|[Strony pulpitu nawigacyjnego szablonu](object#template-dashboard-page), które zastąpią istniejące strony pulpitu nawigacyjnego.<br><br>Strony pulpitu nawigacyjnego są aktualizowane za pomocą właściwości `dashboard_pageid`. Nowe strony pulpitu nawigacyjnego zostaną utworzone dla obiektów bez właściwości `dashboard_pageid`, a istniejące strony pulpitu nawigacyjnego zostaną usunięte, jeśli nie zostaną ponownie użyte. Strony pulpitu nawigacyjnego zostaną uporządkowane w tej samej kolejności, w jakiej zostały określone. Zaktualizowane zostaną tylko określone właściwości stron pulpitu nawigacyjnego. Dla właściwości `pages` wymagany jest co najmniej jeden obiekt strony pulpitu nawigacyjnego.|

[comment]: # ({/d6006aad-051bc982})

[comment]: # ({d8b2cba8-d8b2cba8})
### Wartości zwracane

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

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

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

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

[comment]: # ({7e85dec3-7b6290ef})
#### Zmiana nazwy dashboardu szablonu

Zmień nazwę dashboardu szablonu na „Performance graphs”.

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

```json
{
    "jsonrpc": "2.0",
    "method": "templatedashboard.update",
    "params": {
        "dashboardid": "23",
        "name": "Performance graphs"
    },
    "id": 1
}
```

Odpowiedź:

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

[comment]: # ({/7e85dec3-7b6290ef})

[comment]: # ({12c7c5a0-cf0dcd1e})
#### Aktualizowanie stron pulpitu nawigacyjnego szablonu

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

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

```json
{
    "jsonrpc": "2.0",
    "method": "templatedashboard.update",
    "params": {
        "dashboardid": "2",
        "pages": [
            {
                "dashboard_pageid": 1,
                "name": "Renamed Page"
            },
            {
                "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]: # ({/12c7c5a0-cf0dcd1e})

[comment]: # ({7b2285ce-24de180a})
### Zobacz także

-   [Widżet pulpitu szablonu](object#template-dashboard-widget)
-   [Pole widżetu pulpitu szablonu](object#template-dashboard-widget-field)

[comment]: # ({/7b2285ce-24de180a})

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

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

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