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