# 更新

### Description 说明

`object templatescreen.update(object/array templateScreens)`

This method allows to update existing template screens.
此方法允许更新现有的聚合图形模板。

### Parameters 参数

`(object/array)` Template screen properties to be updated.
`(object/array)`需要更新的聚合图形模板属性。 The `screenid` property
must be defined for each template screen, all other properties are
optional. Only the passed properties will be updated, all others will
remain unchanged.
必须为每个聚合图形模板定义`screenid`属性，所有其他属性为可选项。只有通过的属性会被更新，所有其他属性将保持不变。
Additionally to the [standard template screen
properties](object#template_screen), the method accepts the following
parameters. 除[standard template screen
properties](object#template_screen)之外，该方法接受以下参数。

|Parameter 参数   T|pe 类型    Des|ription 说明|
|--------------------|----------------|--------------|
|screenitems|array 数组   S|reen items to replace existing screen items. 用来替换现有内容的聚合图形项。<br><br>Screen items are updated by coordinates, so each screen item must have the `x` and `y` properties defined. 聚合图形项通过坐标轴更新，因此每个聚合图形项必须定义`x`和`y`属性。|

### Return values 返回值

`(object)` Returns an object containing the IDs of the updated template
screens under the `screenids` property.
`(object)`返回一个对象，该对象包含在`screenids`属性中已更新聚合图形模板的ID。

### Examples 范例

#### Rename a template screen 重命名聚合图形模板

Rename the template screen to "Performance graphs".
将聚合图形模板重命名为"Performance graphs"。

Request 请求:

``` {.java}
{
    "jsonrpc": "2.0",
    "method": "templatescreen.update",
    "params": {
        "screenid": "3",
        "name": "Performance graphs"
    },
    "auth": "038e1d7b1735c6a5436ee9eae095879e",
    "id": 1
}
```

Response 响应:

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

### Source 源码

CTemplateScreen::update() in
*frontends/php/include/classes/api/services/CTemplateScreen.php*.
CTemplateScreen::update()方法可在*frontends/php/include/classes/api/services/CTemplateScreen.php*中参考。