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

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

Отчет

Объект 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 последней успешно отправленной версии отчета.

Поведение свойства:
- только для чтения
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 - (по умолчанию) Сгенерировать отчет от имени получателя.