В прошедшем релизе мы усовершенствовали работу параметра Max (Строки данных). Этот параметр влияет на количество строк данных в элементах дашборда при его открытии в дизайнере отчетов. Ограничение, установленное при помощи параметра Max (Строки данных) не распространяется на элементы дашборда при его просмотре во вьювере или на вкладке Просмотр (Preview). Настройка параметра осуществляется на вкладке Дизайн (Design) в меню Параметры (Options) дизайнера отчетов. Но обо всем по порядку.

---

Зачем вообще нужен параметр Max (Строки данных)?

Элементы дашборда могут содержать неограниченное количество строк данных. И если в случае с отчетом заполнение шаблона данными осуществляется в момент построения отчета, то в случае с дашбордами процесс построения как таковой отсутствует. При открытии дашборда в дизайнере отчетов выполняются все запросы данных, и результаты их выполнения отображаются в элементах дашборда. Соответственно, при больших объемах данных для дашборда, все они будут получены. Однако, в этом случае процесс редактирования дашборда может быть затруднен. Это зависит от вычислительных мощностей ПК, его ПО и окружения. Тем не менее, после глубокого анализа ситуации мы решили добавить параметр Max (Строки данных).

---

Как параметр работал раньше?

В предыдущих версиях продуктов Stimulsoft параметр Max (Строки данных) работал по следующим правилам:

• Отображался в меню Параметры, только если в шаблоне присутствует дашборд;
• По сути, мог быть в двух состояниях: без ограничений (если флажок снят) и с ограничением количества строк (если флажок установлен), где необходимое количество строк указывалось как значение параметра Max (Строки данных). Запросы к источникам данных выполняются, однако при получении результата генератор отчетов накладывает ограничение для строк данных.

Таким образом, открытие дашборда с миллионами строк, например, для изменения его дизайна, стало достижимо даже на маломощных ПК. Достаточно установить параметр Max (Строки данных) в значение 1, и дашборд в режиме редактирования загружается только с одной строкой данных. Однако, по просьбе наших клиентов, мы решили усовершенствовать работу этого параметра.

---

Как параметр работает теперь?

Во-первых, параметр Max (Строки данных) всегда отображается в меню Параметры дизайнера отчетов, независимо от наличия дашборда в шаблоне. Во-вторых, добавилось третье состояние параметра, когда флажок установлен, и задано значение 0. В этом случае, при открытии дашборда запросы данных не выполняются. В остальных случаях, если флажок снят или установлен со значением больше 0, поведение остаётся прежним.

---

Установка параметра из кода

Определить ограничение строк данных встраиваемых компонентов StiDesigner можно также из кода. Для этого если установить опцию MaxDataRowsOfDashboardElementInDesigner в одно из следующих значений:

• null, т.е. без ограничений;
• 0, т.е. данные в режиме редактирования дашборда не запрашиваются, и в элементах дашборда не отображаются;
• Целое число, которое является количеством строк данных отображаемых в элементах дашборда.

Для C#:

//StiOptions.Designer.MaxDataRowsOfDashboardElementInDesigner = null;
//StiOptions.Designer.MaxDataRowsOfDashboardElementInDesigner = 0;
StiOptions.Designer.MaxDataRowsOfDashboardElementInDesigner = 500;

Для JS:

//StiOptions.Designer.maxDataRowsOfDashboardElementInDesigner = null;
//StiOptions.Designer.maxDataRowsOfDashboardElementInDesigner = 0;
StiOptions.Designer.maxDataRowsOfDashboardElementInDesigner = 500;

---

Итог

1. Параметр Max (Строки данных) предназначен для дашбордов и работает только в дизайнере отчетов;
2. Параметр быть в трех состояниях - без ограничений, с ограничением строк данных, без выполнения запросов к хранилищу данных;
3. Установленные настройки не распространяются на элементы дашборда при его просмотре.