[comment]: # translation:outdated

[comment]: # ({9793e988-9793e988})
# 创建

[comment]: # ({/9793e988-9793e988})

[comment]: # ({ea36381d-a8301e64})
### 说明

`object report.create(object/array reports)`

该方法允许用户用于创建新的计划报表。

::: noteclassic
该方式仅对*管理员*和*超级管理员*类型的用户有效。 用户可以在用户角色设置中对该方式的使用权限进行设定修改。请参考 [用户角色](zh/manual/web_interface/frontend_sections/administration/user_roles)以获取更多信息。
:::

[comment]: # ({/ea36381d-a8301e64})

[comment]: # ({352998e1-869414cf})
### 参数

`(object/array)` 要创建的计划报告。

除了[标准计划报告属性](object#report)外，该方法还接受以下参数。

|参数|[类型](/manual/api/reference_commentary#data-types)|描述|
|--|--|------|
|users|object/array|要将报告发送给的[用户](object#users)。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果未设置 `user_groups`，则为*必填*|
|user\_groups|object/array|要将报告发送给的[用户组](object#user-groups)。<br><br>[参数行为](/manual/api/reference_commentary#parameter-behavior)：<br>- 如果未设置 `users`，则为*必填*|

[comment]: # ({/352998e1-869414cf})

[comment]: # ({05ef7a50-05ef7a50})
### 返回值

`(object)` 返回一个对象，其中包含 `reportids` 属性下已创建的计划报告的 ID。返回的 ID 的顺序与传递的计划报告的顺序相匹配。

[comment]: # ({/05ef7a50-05ef7a50})

[comment]: # ({b41637d2-b41637d2})
### 参考示例

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

[comment]: # ({05ea3a37-1cfccf99})
#### 创建计划报告

创建一个周报，从2021-04-01到2021-08-31，每周一到周五12:00，发送上一周的报告。

[请求](/manual/api#执行请求):

```json
{
	"jsonrpc": "2.0",
	"method": "report.create",
	"params": {
		"userid": "1",
		"name": "Weekly report",
		"dashboardid": "1",
		"period": "1",
		"cycle": "1",
		"start_time": "43200",
		"weekdays": "31",
		"active_since": "2021-04-01",
		"active_till": "2021-08-31",
		"subject": "Weekly report",
		"message": "Report accompanying text",
		"status": "1",
		"description": "Report description",
		"users": [{
				"userid": "1",
				"access_userid": "1",
				"exclude": "0"
			},
			{
				"userid": "2",
				"access_userid": "0",
				"exclude": "1"
			}
		],
		"user_groups": [{
			"usrgrpid": "7",
			"access_userid": "0"
		}]
	},
	"auth": "038e1d7b1735c6a5436ee9eae095879e",
	"id": 1
}
```

响应：

```json
{
	"jsonrpc": "2.0",
	"result": {
		"reportids": [
			"1"
		]
	},
	"id": 1
}
```

[comment]: # ({/05ea3a37-1cfccf99})

[comment]: # ({24bb6b3b-c52572c8})
### 另请参阅

-   [用户](object#users)
-   [用户组](object#user-groups)

[comment]: # ({/24bb6b3b-c52572c8})

[comment]: # ({f8046691-f8046691})
### 参考来源

CReport::create() in *ui/include/classes/api/services/CReport.php*.

[comment]: # ({/f8046691-f8046691})