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

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

Отчет

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

Property Type Description
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 имеет следующие свойства:

Property Type Description
userid ID ID пользователя, которому нужно отправить отчет.

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

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

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

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

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

Property Type Description
usrgrpid ID ID группы пользователей, которой будет отправлен отчет.

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

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