[comment]: # ({5102e8bb-5102e8bb})
# screen.update

[comment]: # ({/5102e8bb-5102e8bb})

[comment]: # ({8bb0a0b4-ff6dac41})
### Description

`object screen.update(object/array screens)`

Cette méthode permet de mettre à jour les écran existants.

[comment]: # ({/8bb0a0b4-ff6dac41})

[comment]: # ({bd4f21bf-6da273d1})
### Paramètres

`(object/array)` Propriétés d'écran à mettre à jour.

La propriété `screenid` doit être définie pour chaque écran, 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 de l'objet écran
standard](/fr/manual/api/reference/screen/object#ecran), la méthode
accepte les paramètres suivants.

|Paramètre|Type|Description|
|----------|----|-----------|
|screenitems|array|Éléments d'écran qui remplaceront les éléments d'écran existants.<br><br>Les éléments d'écran sont mis à jour par les coordonnées, de sorte que chaque propriété d'écran doit avoir les propriétés `x` et `y` définies.|
|users|array|Utilisateurs d'écran en remplacement des éléments existants.|
|userGroups|array|Groupes d'utilisateurs d'écran en remplacement des éléments existants.|

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

[comment]: # ({a798f84f-a7d28486})
### Valeurs retournées

`(object)` Retourne un objet contenant les identifiants des déclencheurs
créés sous la propriété `screenids`.

[comment]: # ({/a798f84f-a7d28486})

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

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

[comment]: # ({917876c1-136c04cc})
#### Renommer un écran

Renommer un écran en "CPU Graphs".

Requête :

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screen.update",
    "params": {
        "screenid": "26",
        "name": "CPU Graphs"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Réponse :

``` {.java}
{
    "jsonrpc": "2.0",
    "result": {
        "screenids": [
            "26"
        ]
    },
    "id": 1
}
```

[comment]: # ({/917876c1-136c04cc})

[comment]: # ({e53053f1-770bf5d2})
#### Modification du propriétaire de l'écran

Disponible uniquement pour les administrateurs et super administrateurs.

Requête :

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

Réponse :

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

[comment]: # ({/e53053f1-770bf5d2})

[comment]: # ({b6f1d769-60031f32})
### Voir également

-   [Élément
    d'écran](/fr/manual/api/reference/screenitem/object#element_d_ecran)
-   [screenitem.create](/fr/manual/api/reference/screenitem/create)
-   [screenitem.update](/fr/manual/api/reference/screenitem/update)
-   [screenitem.updatebyposition](/fr/manual/api/reference/screenitem/updatebyposition)
-   [Utilisateur
    d'écran](/fr/manual/api/reference/screen/object#utilisateurd_d_ecran)
-   [Groupe utilisateurs
    d'écran](/fr/manual/api/reference/screen/object#groupe_utilisateurs_d_ecran)

[comment]: # ({/b6f1d769-60031f32})

[comment]: # ({e29feea8-c7ef95ff})
### Source

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

[comment]: # ({/e29feea8-c7ef95ff})