[comment]: # translation:outdated

[comment]: # ({new-3a1fae82})
# screen.create

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

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

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

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

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

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

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

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

|Параметр|Тип|Описание|
|----------------|------|----------------|
|screenitems|массив|Создаваемые элементы комплексного экрана для комплексного экрана.|
|users|массив|Пользователь комплексного экрана, которому будет предоставлен общий доступ к комплексному экрану.|
|userGroups|массив|Группа пользователей комплексного экрана, которой будет предоставлен общий доступ к комплексному экрану.|

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

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

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

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

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

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

[comment]: # ({new-7c7479e9})
#### Создание комплексного экрана

Создание комплексного экрана с именем "Graphs" и размером в 2 строки и 3
колонки и добавление графика в верхнюю левую ячейку.

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screen.create",
    "params": {
        "name": "Graphs",
        "hsize": 3,
        "vsize": 2,
        "screenitems": [
            {
                "resourcetype": 0,
                "resourceid": "612",
                "rowspan": 1,
                "colspan": 1,
                "x": 0,
                "y": 0
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

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

[comment]: # ({new-f2722f29})
#### Общий доступ к комплексному экрану

Создание комплексного экрана с двумя типами общего доступа (пользователю
и группе пользователей).

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "screen.create",
    "params": {
        "name": "Screen sharing",
        "hsize": 3,
        "vsize": 2,
        "users": [
            {
                "userid": "4",
                "permission": "3"
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": "2"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

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

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

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

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

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

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

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