[comment]: # translation:outdated

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

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

[comment]: # ({new-ff6dac41})
### Описание

`объект screen.update(объект/массив комплексныеЭкраны)`

Этот метод позволяет обновлять существующие комплексные экраны.

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

[comment]: # ({new-6da273d1})
### Параметры

`(объект/массив)` Свойства комплексных экранов, которые будут обновлены.

Свойство `screenid` должно быть указано по каждому комплексному экрану,
все остальные свойства опциональны. Будут обновлены только переданные
свойства, все остальные останутся неизменными.

В дополнение к [стандартным свойствам комплексного
экрана](object#комплексный_экран), этот метод принимает следующие
параметры.

|Параметр|Тип|Описание|
|----------------|------|----------------|
|screenitems|массив|Элементы комплексного эркана, которые заменят существующие элементы комплексного экрана.<br><br>Элементы комплексного экрана обновляются по координатам, у каждого элемента должны быть заданы свойства `x` и `y`.|
|users|массив|Пользователь комплексного экрана, который заменит существующие разрешения на общий доступ к комплексному экрану.|
|userGroups|массив|Группа пользователей комплексного экрана, которая заменит существующие разрешения на общий доступ к комплексному экрану.|

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

[comment]: # ({new-a7d28486})
### Возвращаемые значения

`(объект)` Возвращает объект, который содержит ID обновленных
комплексных экранов под свойством `screenids`.

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

[comment]: # ({new-b41637d2})
### Примеры

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

[comment]: # ({new-136c04cc})
#### Переименование комплексного экрана

Переименование комплексного экрана на "CPU Graphs".

Запрос:

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

Ответ:

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

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

[comment]: # ({new-770bf5d2})
#### Изменение владельца комплексного экрана

Доступно только администраторам и супер-администраторам.

Запрос:

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

Ответ:

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

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

[comment]: # ({new-60031f32})
### Смотрите также

-   [Элемент комплексного
    экрана](/ru/manual/api/reference/screenitem/object#элемент_комплексного_экрана)
-   [screenitem.create](/ru/manual/api/reference/screenitem/create)
-   [screenitem.update](/ru/manual/api/reference/screenitem/update)
-   [screenitem.updatebyposition](/ru/manual/api/reference/screenitem/updatebyposition)
-   [Пользователь комплексного
    экрана](object#пользователь_комплексного_экрана)
-   [Группа пользователей комплексного
    экрана](object#группа_пользователей_комплексного_экрана)

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

[comment]: # ({new-c7ef95ff})
### Исходный код

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

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