创建

Description 描述

object screen.create(object/array screens)

This method allows to create new screens. 此方法允许创建新的聚合图形

Parameters 参数

(object/array) Screens to create. (object/array)创建聚合图形

Additionally to the standard screen properties, the method accepts the following parameters. 此外 standard screen properties，此方法接受以下参数：

Return values 返回值

(object) Returns an object containing the IDs of the created screens under the screenids property. The order of the returned IDs matches the order of the passed screens. (object) 返回一个对象，该对象包含在screenids属性下创建的聚合图形的id。返回的id的顺序与传递的聚合图形的顺序相匹配。

Examples 示例如下

Creating a screen 创建一个聚合图形

Create a screen named "Graphs" with 2 rows and 3 columns and add a graph to the upper-left cell. 创建一个2行3列名字叫"Graphs"的聚合图形，并且在表格的左上角添加一个图形。

Request:

{  "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 }

Response:

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

Screen sharing

Create a screen with two types of sharing (user and user group). 创建一个两种共享类型的聚合图形（用户和用户组）

Request:

{  "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 }

Response:

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

See also

• Screen item
• Screen user
• Screen user group

Source

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