报告 object

以下 objects 直接与 report API 相关。

报告

报告对象具有以下属性:

Property Type Description
reportid ID 报告的 ID。

Property behavior:
- 只读
- 更新操作中必需
userid ID 创建报告的用户的 ID。

Property behavior:
- 创建操作中必需
name string 报告的唯一名称。

Property behavior:
- 创建操作中必需
dashboardid ID 报告所基于的仪表板的 ID。

Property behavior:
- 创建操作中必需
period integer 准备报告的周期。

可能的值:
0 - (默认)前一天;
1 - 前一周;
2 - 前一个月;
3 - 前一年。
cycle integer 周期性重复计划。

可能的值:
0 - (默认)每天;
1 - 每周;
2 - 每月;
3 - 每年。
start_time integer 准备报告并发送的时间,以当天经过的秒数表示。

默认值:0。
weekdays integer 发送报告的星期。

可能的位图值:
1 - 星期一;
2 - 星期二;
4 - 星期三;
8 - 星期四;
16 - 星期五;
32 - 星期六;
64 - 星期日。

这是一个位掩码字段;可以使用任意可能位图值的总和(例如,21 表示星期一、星期三和星期五)。

默认值:0。

Property behavior:
- 当 cycle 设置为 "weekly" 时必需。
active_since string 开始日期。

可能的值:
空字符串 - (默认)未指定(存储为 0);
YYYY-MM-DD 格式的特定日期(存储为当天开始时间(00:00:00)的时间戳)。
active_till string 结束日期。

可能的值:
空字符串 - (默认)未指定(存储为 0);
YYYY-MM-DD 格式的特定日期(存储为当天结束时间(23:59:59)的时间戳)。
subject string 报告消息主题。
message string 报告消息文本。
status integer 报告是否启用。

可能的值:
0 - (默认)已启用;
1 - 已禁用。
description text 报告的描述。
state integer 报告的状态。

可能的值:
0 - (默认)报告尚未处理;
1 - 报告已生成并成功发送给所有收件人;
2 - 报告生成失败;"info" 包含错误信息;
3 - 报告已生成,但发送给部分(或全部)收件人失败;"info" 包含错误信息。

Property behavior:
- 只读
lastsent timestamp 上次成功发送报告的 Unix 时间戳。

Property behavior:
- 只读
info string 错误描述或其他信息。

Property behavior:
- 只读

用户

users 对象具有以下属性:

Property Type Description
userid ID 要向其发送报告的用户 ID。

属性行为:
- required
access_userid ID 用于生成报告的用户 ID。

0 - (default) 由接收者生成报告。
exclude integer 是否将该用户从邮件列表中排除。

可能的值:
0 - (default) 包含;
1 - 排除。

用户组

user groups 对象具有以下属性:

Property Type Description
usrgrpid ID 要向其发送报告的用户组 ID。

属性行为:
- required
access_userid ID 用于生成报告的用户 ID。

0 - (default) 由接收者生成报告。