report.create

描述

object report.create(object/array reports)

此方法允许create新的定时报告.

此方法仅适用于AdminSuper admin 用户类型. 调用该方法的权限可在用户角色 设置中撤销. 更多信息请参阅User roles

参数

(object/array) 计划报告发送至 create.

除了 报告 外,该方法还接受以下参数。

参数 数据类型 描述
users object/array 发送报告的 用户
user_groups object/array 发送报告的 用户组

返回值

(object) 返回一个包含所创建计划报告ID的object,这些ID存储在reportids属性下。返回的ID顺序与传入的计划报告顺序一致。

示例

创建定时报告

创建一份每周报告,该报告将在2021-04-01至2021-08-31期间每周一至周五12:00为前一周生成。

请求:

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

响应:

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

另请参阅

来源

CReport::create() 位于 ui/include/classes/api/services/CReport.php 文件中。