[comment]: # aside: 5

[comment]: # translation:outdated

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

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

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

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

Mit dieser Methode können vorhandene Dashboards aktualisiert werden.

::: noteclassic
Diese Methode ist für Benutzer aller Typen verfügbar. Die Berechtigungen
zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter [Benutzerrollen](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

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

`(object/array)` Zu aktualisierende Dashboard-Eigenschaften.

Die Eigenschaft `dashboardid` muss für jedes Dashboard definiert sein, alle
anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden
aktualisiert, alle anderen bleiben unverändert.

Zusätzlich zu den [Standard-Dashboard-Eigenschaften](object#dashboard)
akzeptiert die Methode die folgenden Parameter.

|Parameter|[Type](/manual/api/reference_commentary#data-types)|Beschreibung|
|--|--|------|
|pages|array|[Dashboard-Seiten](object#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 angegeben. Nur die angegebenen Eigenschaften der Dashboard-Seiten werden aktualisiert.|
|users|array|[Dashboard-Benutzer](object#dashboard-user) Freigaben zum Ersetzen der vorhandenen Elemente.|
|userGroups|array|[Dashboard-Benutzergruppen](object#dashboard-user-group) Freigaben zum Ersetzen der vorhandenen Elemente.|

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

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

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

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

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

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

[comment]: # ({d0eb0276-7fcf7de4})
#### Umbenennen eines Dashboards

Benennen Sie ein Dashboard in „SQL server status“ um.

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

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

Antwort:

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

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

[comment]: # ({ed5d0499-b8348b8a})
#### Dashboard-Seiten aktualisieren

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": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "pages": [
            {
                "dashboard_pageid": 1,
                "name": "Umbenannte Seite"
            },
            {
                "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]: # ({/ed5d0499-b8348b8a})

[comment]: # ({6990c258-e4a57dd3})
#### Dashboard-Eigentümer ändern

Nur für Admins und Super-Admins verfügbar.

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

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

Antwort:

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

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

[comment]: # ({9c4ba6ce-299ae089})
### Siehe auch

-   [Dashboard-Seite](object#dashboard-page)
-   [Dashboard-Widget](object#dashboard-widget)
-   [Dashboard-Widget-Feld](object#dashboard-widget-field)
-   [Dashboard-Benutzer](object#dashboard-user)
-   [Dashboard-Benutzergruppe](object#dashboard-user-group)

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

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

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

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