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

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

[comment]: # ({0d0c86e7-09d5359a})
### Description

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

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

[comment]: # ({/0d0c86e7-09d5359a})

[comment]: # ({934aa9de-3d848693})
### 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.

Outre les [propriétés standards de tableau de
bord](object#tableau_de_bord), la méthode accepte les paramètres
suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|widgets|tableau|[Widget de tableau de bord](object#widget_tableau_de_bord) pour remplacer les widgets de tableau de bord existants.<br><br>Les widgets de tableau de bord sont mis à jour par la propriété `widgetid`. Les widgets sans propriété `widgetid` seront créés.|
|users|tableau|[Utilisateur de tableau de bord](object#utilisateurs_du_tableau_de_bord) pour remplacer les éléments existants.|
|userGroups|tableau|[Groupe d'utilisateurs de tableau de bord](object#groupe_d_utilisateurs_du_tableau_de_bord) pour remplacer les éléments existants.|

[comment]: # ({/934aa9de-3d848693})

[comment]: # ({a568f2c6-28e89b38})
### Valeurs de retour

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

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

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

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

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

Renomme un tableau de bord en "Etat du serveur SQL".

Requête :

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

Réponse :

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

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

[comment]: # ({73131eb5-e4a57dd3})
#### Changer le propriétaire d'un tableau de bord

Disponible uniquement pour les administrateurs et les
super-administrateurs.

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "dashboard.update",
    "params": {
        "dashboardid": "2",
        "userid": "1"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 2
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "dashboardids": [
            "2"
        ]
    },
    "id": 2
}
```

[comment]: # ({/73131eb5-e4a57dd3})

[comment]: # ({fe3af735-5566cc54})
### Voir aussi

-   [Widget de tableau de bord](object#widget_tableau_de_bord)
-   [Champs de widget de tableau de
    bord](object#champ_de_widget_de_tableau_de_bord)
-   [Utilisateur de tableau de
    bord](object#utilisateurs_du_tableau_de_bord)
-   [Groupe d'utilisateurs de tableau de
    bord](object#groupe_d_utilisateurs_du_tableau_de_bord)

[comment]: # ({/fe3af735-5566cc54})

[comment]: # ({df13e237-8eb4c4d7})
### Source

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

[comment]: # ({/df13e237-8eb4c4d7})