Отображение отчета
Информация |
В следствие того, что для панелей индикаторов (дашбордов) и отчетов используется одинаковый унифицированный формат шаблона MRT, методы для загрузки шаблона и работы с данными, то в тексте документации будет использоваться слово «отчет».
|
Примечание |
При присвоении отчета вьювер компоненту, происходит автоматическое построение отчета. Вызов метода report.render() необходим только в том случае, если требуется провести какие-либо действия с построенным отчетом перед его отображением во вьювере.
|
Для отображения отчета необходимо добавить скрипты, необходимые для компонента StiViewer, на HTML страницу проекта.
viewer.html |
... <script src="scripts/stimulsoft.reports.js" type="text/javascript"></script> <script src="scripts/stimulsoft.dashboards.js"></script> <script src="scripts/stimulsoft.viewer.js" type="text/javascript"></script> ... |
Затем необходимо добавить на HTML страницу JavaScript код загрузки отчета, и присвоить полученный объект вьюверу. В данном случае, вьювер будет развернут в текущем DOM элементе в том месте, где расположен скрипт.
viewer.html |
... <script type="text/javascript"> var report = new Stimulsoft.Report.StiReport(); report.loadFile("SimpleList.mrt"); //report.loadFile("Dashboard.mrt");
var viewer = new Stimulsoft.Viewer.StiViewer(); viewer.report = report; </script> ... |
Объект StiViewer можно создать при помощи конструктора Stimulsoft.Viewer.StiViewer(), который может принимать на вход указанные не обязательные аргументы:
options: представляет собой набор опций, находящихся в классе Stimulsoft.Viewer.StiViewerOptions. Все опции разделены на категории. Подробное описание категорий и опций находится в разделе Настройки вьювера.
viewerId: идентификатор вьювера, используется при развертывании компонента как DOM объекта, по умолчанию используется значение “StiViewer”
renderAfterCreate: определяет расположение вьювера. Если установлено значение true, то вьювер будет отображаться в том же месте DOM дерева, в котором располагается код создания объекта. Если установлено значение false, то вьювер будет располагаться в том месте где вызван метод renderHtml(). Например, инициализация вьювера в заголовке страницы.
viewer.html |
... <script type="text/javascript"> var viewer = new Stimulsoft.Viewer.StiViewer(null, "StiViewer", false); </script> ... |
И последующий вывод вьювера в текущий элемент DIV.
viewer.html |
... <div>Page content</div> <div> <script type="text/javascript"> // Render the report viewer in this place viewer.renderHtml(); </script> </div> ... |
В качестве аргумента метода вывода вьювера renderHtml(id) допускается указать идентификатор элемента HTML страницы, в котором необходимо вывести вьювер.
viewer.html |
... <script type="text/javascript" > var viewer = new Stimulsoft.Viewer.StiViewer(null, "StiViewer", false); viewer.renderHtml("content"); </script> ... |
Указанный элемент должен находиться на HTML странице, на которой используется вьювер отчетов.
viewer.html |
... <div id="content"></div> ... |