[comment]: # aside: 5

[comment]: # translation:outdated

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

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

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

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

Cette méthode permet de mettre à jour des tableaux de bord existants.

::: noteclassic
Cette méthode est disponible pour les utilisateurs de tout type. Les autorisations
d’appeler la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir [User
roles](/manual/web_interface/frontend_sections/users/user_roles)
pour plus d’informations.
:::

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

[comment]: # ({bf54b1f0-62947aa0})
### Paramètres

`(object/array)` Propriétés du tableau de bord à mettre à jour.

La propriété `dashboardid` doit être définie pour chaque tableau de bord, toutes les
autres propriétés sont facultatives. Seules les propriétés transmises seront
mises à jour, toutes les autres resteront inchangées.

En plus des [propriétés standard du tableau de bord](object#dashboard),
la méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|pages|array|[Pages du tableau de bord](object#dashboard-page) pour remplacer les pages existantes du tableau de bord.<br><br>Les pages du tableau de bord sont mises à jour à l’aide de la propriété `dashboard_pageid`. De nouvelles pages du tableau de bord seront créées pour les objets sans propriété `dashboard_pageid` et les pages existantes du tableau de bord seront supprimées si elles ne sont pas réutilisées. Les pages du tableau de bord seront ordonnées dans le même ordre que celui spécifié. Seules les propriétés spécifiées des pages du tableau de bord seront mises à jour.|
|users|array|Partages [d’utilisateur du tableau de bord](object#dashboard-user) pour remplacer les éléments existants.|
|userGroups|array|Partages de [groupe d’utilisateurs du tableau de bord](object#dashboard-user-group) pour remplacer les éléments existants.|

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

[comment]: # ({28e89b38-28e89b38})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des tableaux de bord mis à jour dans la propriété `dashboardids`.

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

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

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

[comment]: # ({d0eb0276-7fcf7de4})
#### Renommer un tableau de bord

Renommez un tableau de bord en « SQL server status ».

[Requête](/manual/api#performing-requests):

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

Réponse :

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

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

[comment]: # ({ed5d0499-b8348b8a})
#### Mise à jour des pages du tableau de bord

Renommez la première page du tableau de bord, remplacez les widgets de la deuxième
page du tableau de bord et ajoutez une nouvelle page en troisième position. Supprimez toutes les autres pages du tableau de bord.

[Requête](/manual/api#performing-requests) :

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

Réponse :

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

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

[comment]: # ({6990c258-e4a57dd3})
#### Changer le propriétaire du tableau de bord

Disponible uniquement pour les admins et les super admins.

[Requête](/manual/api#performing-requests) :

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

Réponse :

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

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

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

-   [Page de tableau de bord](object#dashboard-page)
-   [Widget de tableau de bord](object#dashboard-widget)
-   [Champ de widget de tableau de bord](object#dashboard-widget-field)
-   [Utilisateur du tableau de bord](object#dashboard-user)
-   [Groupe d'utilisateurs du tableau de bord](object#dashboard-user-group)

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

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

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

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