Объект отчёта

Следующие объекты напрямую связаны с API report.

Отчет

Объект отчета имеет следующие свойства:

Свойство Тип Описание
reportid ID ID отчета.

Поведение свойства:
- только для чтения
- обязательно для операций обновления
userid ID ID пользователя, создавшего отчет.

Поведение свойства:
- обязательно для операций создания
name string Уникальное имя отчета.

Поведение свойства:
- обязательно для операций создания
dashboardid ID ID панели, на основе которой создается отчет.

Поведение свойства:
- обязательно для операций создания
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.

Поведение свойства:
- обязательно, если 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" содержит информацию об ошибке.

Поведение свойства:
- только для чтения
lastsent timestamp Unix timestamp последнего успешно отправленного отчета.

Поведение свойства:
- только для чтения
info string Описание ошибки или дополнительная информация.

Поведение свойства:
- только для чтения

Пользователи

Объект users имеет следующие свойства:

Свойство Тип Описание
userid ID ID пользователя, которому будет отправлен отчет.

Поведение свойства:
- обязательно
access_userid ID ID пользователя, от имени которого будет сформирован отчет.

0 - (по умолчанию) Сформировать отчет получателем.
exclude integer Следует ли исключить пользователя из списка рассылки.

Возможные значения:
0 - (по умолчанию) Включить;
1 - Исключить.

Группы пользователей

Объект групп пользователей имеет следующие свойства:

Свойство Тип Описание
usrgrpid ID ID группы пользователей, которой будет отправлен отчет.

Поведение свойства:
- обязательно
access_userid ID ID пользователя, от имени которого будет сгенерирован отчет.

0 - (по умолчанию) Сгенерировать отчет от имени получателя.