[comment]: # translation:outdated

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

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

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

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

Mit dieser Methode können vorhandene Vorlagen-Dashboards aktualisiert werden.

::: noteclassic
Diese Methode ist nur für die Benutzertypen *Admin* und *Super admin*
verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den
Benutzerrolleneinstellungen entzogen werden. Weitere Informationen finden Sie unter [User
roles](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Eigenschaften der Vorlagen-Dashboards.

Die Eigenschaft `dashboardid` muss für jedes Dashboard angegeben werden, alle
anderen Eigenschaften sind optional. Nur die angegebenen Eigenschaften werden
aktualisiert.

Zusätzlich zu den [standardmäßigen Eigenschaften von Vorlagen-Dashboards](object#template-dashboard)
akzeptiert die Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|pages|array|[Vorlagen-Dashboard-Seiten](object#template-dashboard-page) zum Ersetzen der vorhandenen Dashboard-Seiten.<br><br>Dashboard-Seiten werden über die Eigenschaft `dashboard_pageid` aktualisiert. Neue Dashboard-Seiten werden für Objekte ohne die Eigenschaft `dashboard_pageid` erstellt, und vorhandene Dashboard-Seiten werden gelöscht, wenn sie nicht wiederverwendet werden. Dashboard-Seiten werden in derselben Reihenfolge angeordnet, wie sie angegeben sind. Nur die angegebenen Eigenschaften der Dashboard-Seiten werden aktualisiert. Für die Eigenschaft `pages` ist mindestens ein Dashboard-Seitenobjekt erforderlich.|

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

[comment]: # ({d8b2cba8-d8b2cba8})
### Rückgabewerte

`(object)` Gibt ein Objekt zurück, das die IDs der aktualisierten Vorlage-Dashboards unter der Eigenschaft `dashboardids` enthält.

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

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

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

[comment]: # ({7e85dec3-7b6290ef})
#### Umbenennen eines Vorlagen-Dashboards

Benennen Sie ein Vorlagen-Dashboard in „Performance graphs“ um.

[Anfrage](/manual/api#performing-requests):

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

Antwort:

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

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

[comment]: # ({12c7c5a0-cf0dcd1e})
#### Aktualisieren von Vorlagen-Dashboard-Seiten

Benennen Sie die erste Dashboard-Seite um, ersetzen Sie die Widgets auf der zweiten Dashboard-Seite und fügen Sie als dritte eine neue Seite hinzu. Löschen Sie alle anderen Dashboard-Seiten.

[Anfrage](/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
}
```

Antwort:

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

[comment]: # ({/12c7c5a0-cf0dcd1e})

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

-   [Vorlagen-Dashboard-Widget](object#template-dashboard-widget)
-   [Feld des Vorlagen-Dashboard-Widgets](object#template-dashboard-widget-field)

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

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

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

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