Список параметров, передаваемых в отчет, зависит от контекста отчета и настроенных для отчета фильтров. Общий список параметров отчета формируется следующим образом:
1.Во все отчеты в качестве параметра передается ID пользователя, который открыл отчет для просмотра (CurrentUserID) — это необходимо для проверки прав пользователя, поскольку ему должна отображаться только та информация, которую он уполномочен просматривать.
Контроль прав пользователя при работе с отчетом возложен на разработчиков отчета! |
---|
2.Параметры контекста. Контекст описывает место в системе, откуда вызывается отчет, и позволяет адаптировать отчет под конкретное окружение. Например, если отчет вызывается из профиля пользователя, то в отчет будут отобраны данные именно по этому пользователю. Параметры контекста формируются автоматически при вызове отчета и передаются в отчет.
Контекст |
Параметры, которые передаются в отчет |
---|---|
Задача |
TaskID — номер задачи SubcatID — ID категории |
Категория |
SubcatID — ID категории |
Пользователь |
UserID — ID пользователя |
Контекст задается в интерфейсе администратора для каждого отчета отдельно:
Контекст вызова отчета, определяемый в интерфейсе администратора.
3.Параметры, определяемые фильтром. Фильтры — это пользовательский инструмент для управления отбором данных в отчете. В пользовательском режиме окно фильтров отображается при нажатии на иконку на панели инструментов отчета:
Параметры отчета, отображаемые в интерфейсе пользователя.
Сами фильтры настраиваются в режиме администратора, а значения этих фильтров меняет пользователь в процессе работы с отчетом. Например, администратор настраивает для отчета фильтр для отбора данных за период, а пользователь при работе с отчетом указывает нужный ему период времени.
Фильтр задается в интерфейсе администратора для каждого отчета отдельно. Каждый фильтр описывает определенный набор параметров отбора (например, период и группу). Один и тот же фильтр может использоваться несколько раз для разных отчетов, если данные в них отбираются по одним и тем же критериям.
Фильтры отчетов в интерфейсе администратора.
Настройка фильтров для отчета аналогична настройке фильтров портального блока. Название параметра, определяемого фильтром и передаваемого в отчет, формируется из двух частей — слова Filter и имени параметра, заданного при настройке фильтра. Для фильтров с типом "Период" создаются два параметра, определяющие начало и окончание периода, поэтому их названия дополняются словами From и To:
Контекст вызова отчета.
Тип фильтра |
Пример |
|
---|---|---|
имя параметра, заданное в настройках фильтра |
имя параметра в отчете |
|
Строка, Число, Выпадающий список, Пользователь, Группа, Категория, Огрструктура |
Name MaxAmount Detail Performers |
FilterName FilterMaxAmount FilterDetail FilterPerformers |
Период |
Period |
FilterPeriodFrom FilterPeriodTo |
Все параметры отчета используются совместно, не отменяя друг друга и не имея преимуществ.
Фильтр по категориям учитывает права пользователя: пользователь видит в фильтре только те категории, в которых ему предоставлено хотя бы одно из прав "Просматривать все задачи", "Создавать задачи", "Исполнять", "Администратор задач", Администратор категории". Если пользователь выбирает раздел, то в отчет будет передан список тех категорий раздела, на которые пользователь имеет право. Однако если фильтр по категориям не используется (даже если он настроен, но пользователь не отметил ни одну из категорий или разделов), то контроль прав пользователя на категории полностью возлагается на разработчика отчета. |
---|
Полезные ссылки