> Report object

The following objects are directly related to the report API.

Report

The report object has the following properties:

Property Type Description
reportid string (readonly) ID of the report.
userid
(required)
string ID of the user who created the report.
name
(required)
string Unique name of the report.
dashboardid
(required)
string ID of the dashboard that the report is based on.
period integer Period for which the report will be prepared.

Possible values:
0 - (default) previous day;
1 - previous week;
2 - previous month;
3 - previous year.
cycle integer Period repeating schedule.

Possible values:
0 - (default) daily;
1 - weekly;
2 - monthly;
3 - yearly.
start_time integer Time of the day, in seconds, when the report will be prepared for sending.

Default: 0.
weekdays integer Days of the week for sending the report.

Required for weekly reports only.

Days of the week are stored in binary form with each bit representing the corresponding week day. For example, 12 equals 1100 in binary and means that reports will be sent every Wednesday and Thursday.

Default: 0.
active_since string On which date to start.

Possible values:
empty string - (default) not specified (stored as 0);
specific date in YYYY-MM-DD format (stored as a timestamp of the beginning of a day (00:00:00)).
active_till string On which date to end.

Possible values:
empty string - (default) not specified (stored as 0);
specific date in YYYY-MM-DD format (stored as a timestamp of the end of a day (23:59:59)).
subject string Report message subject.
message string Report message text.
status integer Whether the report is enabled or disabled.

Possible values:
0 - Disabled;
1 - (default) Enabled.
description text Description of the report.
state integer (readonly) State of the report.

Possible values:
0 - (default) report was not yet processed;
1 - report was generated and successfully sent to all recipients;
2 - report generating failed; "info" contains error information;
3 - report was generated, but sending to some (or all) recipients failed; "info" contains error information.
lastsent timestamp (readonly) Unix timestamp of the last successfully sent report.
info string (readonly) Error description or additional information.

Users

The users object has the following properties:

Property Type Description
userid
(required)
string ID of user to send the report to.
access_userid string ID of user on whose behalf the report will be generated.

0 - (default) Generate report by recipient.
exclude integer Whether to exclude the user from mailing list.

Possible values:
0 - (default) Include;
1 - Exclude.

User groups

The user groups object has the following properties:

Property Type Description
usrgrpid
(required)
string ID of user group to send the report to.
access_userid string ID of user on whose behalf the report will be generated.

0 - (default) Generate report by recipient.