Информация

 

В следствие того, что для панелей индикаторов (дашбордов) и отчетов используется одинаковый унифицированный формат шаблона MRT, методы для загрузки шаблона и работы с данными, то в тексте документации будет использоваться слово «отчет».

 

 

 

Компонент HTML5 Viewer позволяет экспортировать отображаемый отчет в три десятка различных форматов, таких как PDF, HTML, Word, Excel, XPS, RTF, изображения, текст и другие. Экспорт дашборда возможен в PDF, Excel, файлы изображений. Для работы функции экспорта не требуется дополнительных настроек вьювера.

 

 

 

События экспорта

 

Для проведения каких-либо действий перед экспортированием отчета предназначено специальное событие OnExportReport. В данном событии можно узнать тип экспорта отчета, получить сам отчет, а также получить настройки экспорта отчета и при необходимости изменить их.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

OnExportReport="StiWebViewer1_ExportReport">

</cc1:StiWebViewer>

...

 

Default.aspx.cs

...

protected void StiWebViewer1_ExportReport(object sender, StiExportReportEventArgs e)

{

StiExportFormat format = e.Format;

StiReport report = e.Report;

StiExportSettings settings = e.Settings;

}

...

 

 

Для выполнения каких-либо действий с уже экспортированным отчетом предназначено событие OnExportReportResponse, которое будет вызвано непосредственно перед сохранением файла. В данном событии можно получить формат экспорта, тип Web контента и имя файла для сохранения. Так же, можно получить, и при необходимости изменить, байтовый поток итогового файла экспорта.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

OnExportReportResponse="StiWebViewer1_ExportReportResponse">

</cc1:StiWebViewer>

...

 

Default.aspx.cs

...

protected void StiWebViewer1_ExportReportResponse(object sender, StiExportReportResponseEventArgs e)

{

StiExportFormat format = e.Format;

string contentType = e.ContentType;

string fileName = e.FileName;

Stream stream = e.Stream;

}

...

 

 

Настройки экспорта

 

Каждый формат экспорта отчета компонента HTML5 Viewer имеет множество настроек, и каждая настройка имеет свои значения по умолчанию. Иногда требуется установить другие значения по умолчанию. Для этого предназначено специальное свойство вьювера DefaultExportSettings, которое представляет собой контейнер всех настроек экспортов, используемых по умолчанию.

 

Default.aspx.cs

...

protected void Page_Load(object sender, EventArgs e)

{

StiWebViewer1.DefaultExportSettings.ExportToPdf.ImageQuality = 0.75f;

StiWebViewer1.DefaultExportSettings.ExportToPdf.ImageFormat = StiImageFormat.Color;

StiWebViewer1.DefaultExportSettings.ExportToHtml.ExportMode = StiHtmlExportMode.Div;

}

...

 

 

При вызове требуемого экспорта через меню вьювера, будет отображено диалоговое окно настроек экспорта. Значения элементов диалогового окна будут соответствовать настройкам экспортов по умолчанию. При изменении настроек в диалоговом окне и подтверждении экспорта отчета, настройки будут сохранены в cookies браузера, и при последующем вызове экспорта будут восстановлены. Вьювер позволяет отключить сохранение настроек экспорта, если требуется всегда восстанавливать настройки по умолчанию. Для этого достаточно установить значение false для свойства StoreExportSettings.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

StoreExportSettings="false">

</cc1:StiWebViewer>

...

 

 

Так же, если требуется, можно полностью убрать отображение диалоговых окон экспорта, экспортирование всегда будет осуществляться с настройками по умолчанию. Для этого достаточно установить значение false для свойства ShowExportDialog.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

ShowExportDialog="false">

</cc1:StiWebViewer>

...

 

 

Компонент HTML5 Viewer содержит порядка 30 различных форматов экспорта, и иногда требуется отключить не используемые форматы. Это позволяет разгрузить интерфейс и упростить использование вьювера. Для отключения не используемых форматов экспортов достаточно установить значение false для соответствующих свойств вьювера, представленных в списке ниже.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

ShowExportToDocument="true"

ShowExportToPdf="true"

ShowExportToXps="true"

ShowExportToPowerPoint="true"

ShowExportToHtml="true"

ShowExportToHtml5="true"

ShowExportToMht="true"

ShowExportToText="true"

ShowExportToRtf="true"

ShowExportToWord="true"

ShowExportToOpenDocumentWriter="true"

ShowExportToExcel="true"

ShowExportToExcelXml="true"

ShowExportToExcelBiff="true"

ShowExportToOpenDocumentCalc="true"

ShowExportToCsv="true"

ShowExportToDbf="true"

ShowExportToXml="true"

ShowExportToDif="true"

ShowExportToSylk="true"

ShowExportToImageBmp="true"

ShowExportToImageGif="true"

ShowExportToImageJpeg="true"

ShowExportToImagePcx="true"

ShowExportToImagePng="true"

ShowExportToImageTiff="true"

ShowExportToImageMetafile="true"

ShowExportToImageSvg="true"

ShowExportToImageSvgz="true">

</cc1:StiWebViewer>

...

 

 

Компонент HTML5 Viewer имеет возможность полностью отключить меню экспорта отчета, если оно не требуется. Для этого необходимо установить значение false для свойства ShowSaveButton.

 

Default.aspx

...

<cc1:StiWebViewer ID="StiWebViewer1" runat="server"

ShowSaveButton="false">

</cc1:StiWebViewer>

...