Sidebar

zh:manual:api:reference:templatescreen:create

创建

说明

object templatescreen.create(object/array templateScreens)

此方法允许创建新的聚合图形模板。

参数

(object/array)要创建的聚合图形模板。

standard template screen properties之外,该方法接受以下参数。

参数 类型 说明
screenitems array 聚合图形上要创建的聚合图形模板项。

返回值

(object)返回一个对象,该对象包含在screenids属性中已创建聚合图形模板ID,返回ID的顺序与传递聚合图形模板的顺序相匹配。

范例

创建聚合图形模板

创建一个2行3列名为“Graphs”的聚合图形模板,并添加一个图形到左上角的格子内。

Request 请求:

{
    "jsonrpc": "2.0",
    "method": "templatescreen.create",
    "params": {
        "name": "Graphs",
        "templateid": "10047",
        "hsize": 3,
        "vsize": 2,
        "screenitems": [
            {
                "resourcetype": 0,
                "resourceid": "410",
                "x": 0,
                "y": 0
            }
        ]
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}

Response 响应:

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

参考

源码

CTemplateScreen::create()方法可在ui/include/classes/api/services/CTemplateScreen.php中参考。