Создание нового отчета
Информация |
В следствие того, что для панелей индикаторов (дашбордов) и отчетов используется одинаковый унифицированный формат шаблона MRT, методы для загрузки шаблона и работы с данными, то в тексте документации будет использоваться слово «отчет».
|
Для запуска дизайнера с новым (пустым) отчетом не требуется никаких действий, при загрузке компонента новый отчет будет создан автоматически. При необходимости, можно создать новый объект отчета и предварительно загрузить для него данные, либо выполнить какие-либо другие необходимые действия.
designer.html |
... var report = new Stimulsoft.Report.StiReport(); //var newDashboard = Stimulsoft.Report.StiReport.createNewDashboard();
report.reportName = "MyNewReport"; //newDashboard.reportName = "MyDashboard"; ... |
Для хранения данных используется специальный объект DataSet, который имеет набор методов для загрузки данных из различных форматов. Для подключения данных к отчету используется метод regData(), в аргументах которого указывается подготовленный объект DataSet.
designer.html |
... report.regData(dataSet); ... |
Данные добавляются в специальную коллекцию объекта отчета, и используются для его построения. Для того, чтобы отобразить структуру зарегистрированных данных в словаре отчета, требуется синхронизация структуры данных. Для этого используется метод synchronize().
designer.html |
... report.dictionary.synchronize(); ... |
Также новый отчет можно создать, используя главное меню дизайнера. Для предварительной загрузки данных для нового отчета, либо выполнения какие-либо других необходимых действий, предназначено событие onCreateReport. Данное событие будет вызвано при создании нового пустого отчета из главного меню, либо при создании отчета с использованием мастера.
designer.html |
... designer.onCreateReport = function (args) { var dataSet = new Stimulsoft.System.Data.DataSet("SimpleDataSet"); dataSet.readJsonFile("Data/Demo.json");
args.report.regData(dataSet.dataSetName, "", dataSet); args.report.dictionary.synchronize(); } ... |
Также можно предварительно создать подключение к источнику данных выбранного типа, и добавить его в коллекцию подключений в шаблоне отчета. Данный способ аналогичен созданию подключения в словаре отчета при помощи интерфейса дизайнера.
designer.html |
... var report = new Stimulsoft.Report.StiReport(); //var newDashboard = Stimulsoft.Report.StiReport.createNewDashboard();
var xmlDataBase = new Stimulsoft.Report.Dictionary.StiXmlDatabase("Demo", "Demo.xsd", "Demo.xml");
report.loadFile("SimpleList.mrt"); //newDashboard.loadFile("Dashboard.mrt"); report.dictionary.databases.clear(); //newDashboard.dictionary.databases.clear(); report.dictionary.databases.add(xmlDataBase); //newDashboard.dictionary.databases.add(xmlDataBase); ... |
Таким образом, можно добавить необходимое количество источников данных различных типов.