Table of Contents
Report object
The following objects are directly related to the report API.
Report
The report object has the following properties:
| Property | Type | Description |
|---|---|---|
| reportid | ID | ID of the report. Property behavior: - read-only - required for update operations |
| userid | ID | ID of the user who created the report. Property behavior: - required for create operations |
| name | string | Unique name of the report. Property behavior: - required for create operations |
| dashboardid | ID | ID of the dashboard that the report is based on. Property behavior: - required for create operations |
| 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. 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. Property behavior: - required if cycle is set to "weekly". |
| 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 | 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. Property behavior: - read-only |
| lastsent | timestamp | Unix timestamp of the last successfully sent report. Property behavior: - read-only |
| info | string | Error description or additional information. Property behavior: - read-only |
Users
The users object has the following properties:
| Property | Type | Description |
|---|---|---|
| userid | ID | ID of user to send the report to. Property behavior: - required |
| access_userid | ID | 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 | ID | ID of user group to send the report to. Property behavior: - required |
| access_userid | ID | ID of user on whose behalf the report will be generated. 0 - (default) Generate report by recipient. |