# dashboard.create

### Описание

`объект dashboard.create(объект/массив панелей)`

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

### Параметры

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

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

|Параметр|Тип|Описание|
|----------------|------|----------------|
|widgets|массив|Создаваемые [виджеты панели](object#виджет_панели) для панели.|
|users|массив|Создаваемый общий доступ [пользователю панели](object#пользователь_панели) для панели.|
|userGroups|массив|Создаваемый общий доступ [группе пользователей панели](object#группа_пользователей_панели) для панели.|

### Возвращаемые значения

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

### Примеры

#### Создание панели

Создание панели с именем "Моя панель" с одним виджетом Проблемы с тегами
и с использованием двух типов общего доступа (группа пользователей и
пользователь).

Запрос:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "dashboard.create",
    "params": {
        "name": "Моя панель",
        "widgets": [
            {
                "type": "problems",
                "x": 0,
                "y": 0,
                "width": 6,
                "height": 5,
                "fields": [
                    {
                        "type": 1,
                        "name": "tags.tag.0",
                        "value": "service"
                    },
                    {
                        "type": 1,
                        "name": "tags.value.0",
                        "value": "zabbix_server"
                    }
                ]
            }
        ],
        "userGroups": [
            {
                "usrgrpid": "7",
                "permission": "2"
            }
        ],
        "users": [
            {
                "userid": "4",
                "permission": "3"
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Ответ:

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

### Смотрите также

-   [Виджет панели](object#виджет_панели)
-   [Поле виджета панели](object#поле_виджета_панели)
-   [Пользователь панели](object#пользователь_панели)
-   [Группа пользователей панели](object#группа_пользователей_панели)

### Исходный код

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