Работа с параметрами
Информация |
В следствие того, что для панелей индикаторов (дашбордов) и отчетов используется одинаковый унифицированный формат шаблона MRT, методы для загрузки шаблона и работы с данными, то в тексте документации будет использоваться слово «отчет».
|
Для работы с параметрами отчета в HTML5 Viewer реализована поддержка специальной панели параметров. Для добавления параметра на панель необходимо в отчете определить переменную, запрашиваемую у пользователя. При просмотре отчета во вьювере такая переменная будет автоматически добавлена на панель параметров. Поддерживаются все типы переменных отчета (обычные переменные, дата и время, границы, списки и др.).
Для работы отчетов с параметрами не требуется дополнительных настроек вьювера. Если необходимо провести какие-либо действия перед применением параметров, то можно определить специальное действие Interaction.
Index.cshtml |
... @Html.Stimulsoft().StiMvcViewer("MvcViewer1", new StiMvcViewerOptions() { Actions = { Interaction = "ViewerInteraction" } }) ... |
HomeController.cs |
... public ActionResult ViewerInteraction() { // Some code before any interaction // ...
return StiMvcViewer.InteractionResult(); } ... |
Данное действие вызывается при любых интерактивных действиях вьювера. При необходимости выполнить какие-либо действия только при применении параметров отчета, можно воспользоваться параметрами вьювера. Параметры вьювера представлены в виде объекта класса StiRequestParams, они передаются при любом запросе на сторону сервера, и содержат все необходимые сведения и состояния клиентской части вьювера. Для определения типа действия вьювера достаточно проверить свойство Action у параметров вьювера.
HomeController.cs |
... public ActionResult ViewerInteraction() { StiRequestParams requestParams = StiMvcViewer.GetRequestParams(); if (requestParams.Action == StiAction.Variables) { // Some code before apply parameters }
return StiMvcViewer.InteractionResult(); } ... |
Если работа с параметрами не требуется, то можно полностью отключить данную возможность. Для этого предназначено свойство ShowParametersButton в разделе свойств Toolbar, для которого необходимо установить значение false.
Index.cshtml |
... @Html.Stimulsoft().StiMvcViewer("MvcViewer1", new StiMvcViewerOptions() { Toolbar = { ShowParametersButton = false } }) ... |
Информация |
При такой конфигурации вьювера панель параметров не будет показана даже в том случае, если параметры присутствуют в отображаемом отчете.
|