report.create

描述

object report.create(object/array reports)

此方法允许创建新的定时报告。

此方法仅适用于管理员超级管理员用户类型。调用该方法的权限可在用户角色设置中撤销。更多信息请参阅User roles

参数

(object/array) 待创建的定时报告。

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

参数 数据类型 说明
users object/array 接收报告的用户
user_groups object/array 接收报告的用户组

返回值

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

示例

创建定时报告

创建每周报告,该报告将在2021年4月1日至2021年8月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 文件中。