[comment]: # aside: 5

[comment]: # translation:outdated

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

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

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

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

Met deze methode kunnen bestaande dashboards worden bijgewerkt.

::: noteclassic
Deze methode is beschikbaar voor gebruikers van elk type. Toestemmingen
om de methode aan te roepen kunnen worden ingetrokken in de instellingen voor gebruikersrollen. Zie [Gebruikersrollen](/manual/web_interface/frontend_sections/users/user_roles)
voor meer informatie.
:::

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

[comment]: # ({a1be8656-62947aa0})
### Parameters

`(object/array)` Dashboardeigenschappen die moeten worden bijgewerkt.

De eigenschap `dashboardid` moet worden gedefinieerd voor elk dashboard, alle
andere eigenschappen zijn optioneel. Alleen de doorgegeven eigenschappen worden
bijgewerkt, alle andere blijven ongewijzigd.

Naast de [standaard dashboard eigenschappen](object#dashboard), accepteert de methode de volgende parameters.

|Parameter|[Type](/manual/api/reference_commentary#data_types)|Beschrijving|
|--|--|------|
|pages|array|Dashboard [pagina's](object#dashboard_page) om de bestaande dashboardpagina's te vervangen.<br><br>Dashboardpagina's worden bijgewerkt aan de hand van de eigenschap `dashboard_pageid`. Nieuwe dashboardpagina's worden aangemaakt voor objecten zonder de eigenschap `dashboard_pageid`, en de bestaande dashboardpagina's worden verwijderd als ze niet opnieuw worden gebruikt. Dashboardpagina's worden in dezelfde volgorde gerangschikt als gespecificeerd. Alleen de gespecificeerde eigenschappen van de dashboardpagina's worden bijgewerkt.|
|users|array|Dashboard [gebruikers](object#dashboard_user) delen om de bestaande elementen te vervangen.|
|userGroups|array|Dashboard [gebruikersgroepen](object#dashboard_user_group) delen om de bestaande elementen te vervangen.|

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

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

`(object)` Geeft een object terug met de ID's van de bijgewerkte
dashboards onder de eigenschap `dashboardids`.

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

[comment]: # ({aa9a5ad3-b41637d2})
### Voorbeelden

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

[comment]: # ({d0eb0276-7fcf7de4})
#### Hernoemen van een dashboard

Hernoem een dashboard naar "SQL server status".

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

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

Reactie:

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

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

[comment]: # ({da48a540-b8348b8a})
#### Bijwerken van dashboardpagina's

Hernoem de eerste dashboardpagina, vervang widgets op de tweede dashboardpagina
en voeg een nieuwe pagina toe als de derde. Verwijder alle andere dashboardpagina's.

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

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

Reactie:

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

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

[comment]: # ({6990c258-e4a57dd3})
#### Eigenschapseigenaar van dashboard wijzigen

Alleen beschikbaar voor beheerders en superbeheerders.

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

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

Reactie:

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

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

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

-   [Dashboard pagina](object#dashboard_page)
-   [Dashboard widget](object#dashboard_widget)
-   [Dashboard widgetveld](object#dashboard_widget_field)
-   [Dashboard gebruiker](object#dashboard_user)
-   [Dashboard gebruikersgroep](object#dashboard_user_group)

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

[comment]: # ({1764520c-456ac32b})
### Bron

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

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