Вьювер отчетов поддерживает события, которые предоставляют возможность выполнить необходимые операции перед определенными действиями - как на стороне JavaScript клиента, так и на стороне PHP сервера. Подробное описание работы событий находится в разделе События генератора отчетов.

 

Вьювер поддерживает следующие события:

•onDatabaseConnect
•onBeginProcessData
•onEndProcessData
•onPrepareVariables
•onOpenReport
•onOpenedReport
•onPrintReport
•onBeginExportReport
•onEndExportReport
•onInteraction
•onEmailReport
•onDesignReport

 

 

onDatabaseConnect

[-] JavaScript  [+] PHP

 

Событие вызывается перед подключением к базе данных после получения всех параметров. Подробное описание и примеры использования находятся в разделе Подключение SQL адаптеров данных. Список аргументов события находится в разделе События генератора отчетов.

 

 

onBeginProcessData

[+] JavaScript  [+] PHP

 

Событие вызывается перед запросом данных, необходимых для построения отчета. Подробное описание и примеры использования находятся в разделах Подключение файловых данных и Подключение SQL адаптеров данных. Список аргументов события находится в разделе События генератора отчетов..

 

 

onEndProcessData

[+] JavaScript  [+] PHP

 

Событие вызывается после загрузки данных перед построением отчета. Подробное описание и примеры использования находятся в разделах Подключение файловых данных и Подключение SQL адаптеров данных. Список аргументов события находится в разделе События генератора отчетов..

 

 

onPrepareVariables

[+] JavaScript  [+] PHP

 

Событие вызывается перед построением отчета после подготовки переменных отчета. Подробное описание и примеры использования находятся в разделе Работа с переменными отчета. Список аргументов события находится в разделе События генератора отчетов..

 

 

onOpenReport

[+] JavaScript  [-] PHP

 

Событие вызывается перед открытием отчета после нажатия кнопки на панели инструментов. В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "OpenReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета, в аргументах данного события будет передано значение null.

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события вьювером. По умолчанию установлено значение false.

 

 

onOpenedReport

[+] JavaScript  [+] PHP

 

Событие вызывается после открытия файла отчета до его передачи вьюверу. В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "OpenedReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события вьювером. По умолчанию установлено значение false.

 

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне PHP сервера, аргументы имеют тип StiReportEventArgs:

 

Наименование

Описание

event

Идентификатор текущего события, для данного события имеет значение StiEventType::OpenedReport

sender

Компонент, который инициировал данное событие, может иметь следующие типы:

•StiViewer
•StiDesigner

report

Текущий объект отчета.

 

 

onPrintReport

[+] JavaScript  [+] PHP

 

Событие вызывается перед печатью отчета. Подробное описание и примеры использования находятся в разделе Печать отчета.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "PrintReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

printAction

Тип печати отчета. Может принимать следующие значения:

•"PrintPdf" - печать в PDF формат;
•"PrintWithoutPreview" - печать в HTML формат непосредственно на принтер, будет отображен системный диалог печати;
•"PrintWithPreview" - печать в HTML формат с предварительным просмотром во всплывающем окне.

pageRange

Объект, содержащий настройки диапазона страниц для печати.

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события вьювером. По умолчанию установлено значение false.

 

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне PHP сервера, аргументы имеют тип StiPrintEventArgs:

 

Наименование

Описание

event

Идентификатор текущего события, для данного события имеет значение StiEventType::PrintReport

sender

Компонент, который инициировал данное событие, может иметь следующие типы:

•StiViewer
•StiDesigner

report

Текущий объект отчета.

printAction

Тип печати отчета. Может принимать следующие значения:

•StiPrintAction::PrintPdf - печать в PDF формат;
•StiPrintAction::PrintWithoutPreview - печать в HTML формат непосредственно на принтер, будет отображен системный диалог печати;
•StiPrintAction::PrintWithPreview - печать в HTML формат с предварительным просмотром во всплывающем окне.

fileName

Имя файла отчета для сохранения.

pageRange

Объект, содержащий настройки диапазона страниц для печати.

 

 

onBeginExportReport

[+] JavaScript  [+] PHP

 

Событие вызывается перед экспортированием отчета после диалога настроек экспорта. Подробное описание и примеры использования находятся в разделе Экспорт отчета.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "BeginExportReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

action

Действие, которое вызвало событие экспорта, может принимать следующие значения перечисления Stimulsoft.Viewer.StiExportAction:

•StiExportAction.ExportReport
•StiExportAction.SendEmail

format

Выбранный формат экспорта отчета. Может принимать следующие значения перечисления Stimulsoft.Report.StiExportFormat:

•StiExportFormat.Document
•StiExportFormat.Pdf
•StiExportFormat.Xps
•StiExportFormat.PowerPoint
•StiExportFormat.Html
•StiExportFormat.Html5
•StiExportFormat.Text
•StiExportFormat.Word
•StiExportFormat.Excel
•StiExportFormat.Odt
•StiExportFormat.Ods
•StiExportFormat.Rtf
•StiExportFormat.Csv
•StiExportFormat.Json
•StiExportFormat.Xml
•StiExportFormat.Dbf
•StiExportFormat.Sylk
•StiExportFormat.ImagePng
•StiExportFormat.ImageJpeg
•StiExportFormat.ImageGif
•StiExportFormat.ImageTiff
•StiExportFormat.ImageSvg
•StiExportFormat.ImageSvgz
•StiExportFormat.ImagePcx
•StiExportFormat.ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

settings

Настройки выбранного формата экспорта. Тип объекта настроек и список доступных свойств будет зависеть от выбранного типа экспорта.

fileName

Имя файла отчета для сохранения после завершения экспорта.

openAfterExport

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

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события вьювером. По умолчанию установлено значение false.

 

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне PHP сервера, аргументы имеют тип StiExportEventArgs:

 

Наименование

Описание

event

Идентификатор текущего события, для данного события имеет значение StiEventType::BeginExportReport.

sender

Компонент, который инициировал данное событие, может иметь следующие типы:

•StiViewer
•StiDesigner

action

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

•StiExportAction::ExportReport
•StiExportAction::SendEmail

format

Выбранный формат экспорта отчета. Может принимать следующие значения:

•StiExportFormat::Document
•StiExportFormat::Pdf
•StiExportFormat::Xps
•StiExportFormat::PowerPoint
•StiExportFormat::Html
•StiExportFormat::Html5
•StiExportFormat::Text
•StiExportFormat::Word
•StiExportFormat::Excel2007
•StiExportFormat::Odt
•StiExportFormat::Ods
•StiExportFormat::Rtf
•StiExportFormat::Csv
•StiExportFormat::Json
•StiExportFormat::Xml
•StiExportFormat::Dbf
•StiExportFormat::Sylk
•StiExportFormat::ImagePng
•StiExportFormat::ImageJpeg
•StiExportFormat::ImageGif
•StiExportFormat::ImageTiff
•StiExportFormat::ImageSvg
•StiExportFormat::ImageSvgz
•StiExportFormat::ImagePcx
•StiExportFormat::ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

fileName

Имя файла отчета для сохранения после завершения экспорта.

settings

Настройки выбранного формата экспорта. Тип объекта настроек и список доступных свойств будет зависеть от выбранного типа экспорта.

openAfterExport

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

 

 

onEndExportReport

[+] JavaScript  [+] PHP

 

Событие вызывается после экспортирования отчета до его сохранения в виде файла. Подробное описание и примеры использования находятся в разделе Экспорт отчета.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "EndExportReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

format

Выбранный формат экспорта отчета. Может принимать следующие значения перечисления Stimulsoft.Report.StiExportFormat:

•StiExportFormat.Document
•StiExportFormat.Pdf
•StiExportFormat.Xps
•StiExportFormat.PowerPoint
•StiExportFormat.Html
•StiExportFormat.Html5
•StiExportFormat.Text
•StiExportFormat.Word
•StiExportFormat.Excel
•StiExportFormat.Odt
•StiExportFormat.Ods
•StiExportFormat.Rtf
•StiExportFormat.Csv
•StiExportFormat.Json
•StiExportFormat.Xml
•StiExportFormat.Dbf
•StiExportFormat.Sylk
•StiExportFormat.ImagePng
•StiExportFormat.ImageJpeg
•StiExportFormat.ImageGif
•StiExportFormat.ImageTiff
•StiExportFormat.ImageSvg
•StiExportFormat.ImageSvgz
•StiExportFormat.ImagePcx
•·StiExportFormat.ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

data

Байтовые данные экспортированного отчета, подготовленные для сохранения в файл.

fileName

Имя файла отчета для сохранения после завершения экспорта.

openAfterExport

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

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события вьювером. По умолчанию установлено значение false.

 

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне PHP сервера, аргументы имеют тип StiExportEventArgs:

 

Наименование

Описание

 

Идентификатор текущего события, для данного события имеет значение StiEventType::EndExportReport.

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•StiViewer
•StiDesigner

format

Выбранный формат экспорта отчета. Может принимать следующие значения:

•StiExportFormat::Document
•StiExportFormat::Pdf
•StiExportFormat::Xps
•StiExportFormat::PowerPoint
•StiExportFormat::Html
•StiExportFormat::Html5
•StiExportFormat::Text
•StiExportFormat::Word
•StiExportFormat::Excel2007
•StiExportFormat::Odt
•StiExportFormat::Ods
•StiExportFormat::Rtf
•StiExportFormat::Csv
•StiExportFormat::Json
•StiExportFormat::Xml
•StiExportFormat::Dbf
•StiExportFormat::Sylk
•StiExportFormat::ImagePng
•StiExportFormat::ImageJpeg
•StiExportFormat::ImageGif
•StiExportFormat::ImageTiff
•StiExportFormat::ImageSvg
•StiExportFormat::ImageSvgz
•StiExportFormat::ImagePcx
•StiExportFormat::ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

data

Байтовые данные экспортированного отчета, подготовленные для сохранения в файл. Данные находятся в формате Base64.

fileName

Имя файла отчета для сохранения после завершения экспорта.

fileExtension

Расширение файла отчета для сохранения после завершения экспорта, соответствует типу выбранного формата.

mimeType

MIME тип для выбранного формата экспортирования.

openAfterExport

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

 

 

onInteraction

[+] JavaScript  [-] PHP

 

Событие вызывается в момент интерактивного действия вьювера (динамическая сортировка, сворачивание, детализация, применение параметров) до обработки значений генератором отчетов. Подробное описание и примеры использования находятся в разделе Динамическая сортировка, сворачивание и детализация.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "Interaction".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

action

Идентификатор текущего интерактивного действия, может принимать следующие значения:

•"InitVars" - действие происходит при инициализации переменных отчета, запрашиваемых у пользователя;
•"Variables" - действие происходит при применении значений переменных, запрашиваемых у пользователя;
•"Sorting" - действие происходит при использовании сортировки колонок;
•"DrillDown" - действие происходит при детализации отчета;
•"Collapsing" - действие происходит при использовании сворачивания блоков отчета;
•"DashboardFiltering" - действие происходит при использовании фильтров внутри элемента дашборда;
•"DashboardSorting" - действие происходит при использовании сортировки внутри элемента дашборда;
•"DashboardResetAllFilters" - действие происходит при сбросе сортировки и фильтров внутри элемента дашборда на значения, заданные в шаблоне;
•"DashboardElementDrillDown" - действие происходит при использовании детализации элемента дашборда;
•"DashboardElementDrillUp" - действие происходит при использовании детализации элемента дашборда.

variables

Коллекция переменных отчета и их значений, заданных на панели параметров.

sortingParameters

Коллекция параметров, необходимых для динамической сортировки отчета.

collapsingParameters

Коллекция параметров, необходимых для динамического сворачивания элементов отчета.

drillDownParameters

Коллекция параметров, необходимых для детализации отчета.

filteringParameters

Коллекция параметров, необходимых для сортировки, фильтрации и детализации элементов дашборда.

preventDefault

Данный флаг предоставляет возможность остановить дальнейшую обработку события. По умолчанию установлено значение false.

 

 

onEmailReport

[+] JavaScript  [+] PHP

 

Событие вызывается после экспортирования отчета перед его отправкой по Email. Подробное описание и примеры использования находятся в разделе Отправка отчета по Email.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "EmailReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"
•"Designer"

report

Текущий объект отчета.

format

Выбранный формат экспорта отчета. Может принимать следующие значения перечисления Stimulsoft.Report.StiExportFormat:

•StiExportFormat.Document
•StiExportFormat.Pdf
•StiExportFormat.Xps
•StiExportFormat.PowerPoint
•StiExportFormat.Html
•StiExportFormat.Html5
•StiExportFormat.Text
•StiExportFormat.Word
•StiExportFormat.Excel
•StiExportFormat.Odt
•StiExportFormat.Ods
•StiExportFormat.Rtf
•StiExportFormat.Csv
•StiExportFormat.Json
•StiExportFormat.Xml
•StiExportFormat.Dbf
•StiExportFormat.Sylk
•StiExportFormat.ImagePng
•StiExportFormat.ImageJpeg
•StiExportFormat.ImageGif
•StiExportFormat.ImageTiff
•StiExportFormat.ImageSvg
•StiExportFormat.ImageSvgz
•StiExportFormat.ImagePcx
•·StiExportFormat.ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

data

Байтовые данные экспортированного отчета, подготовленные для отправки по Email.

fileName

Имя файла отчета для отправки по Email.

settings

Объект, содержащий параметры, заполненные в диалоге вьювера отправки отчета по Email. Описание всех параметров находится в отдельной таблице ниже.

 

 

В таблице ниже представлен список параметров отправки Email на стороне JavaScript клиента:

 

Наименование

Описание

email

Email адрес, на который будет отправлен экспортированный отчет.

subject

Тема письма.

message

Текст письма.

 

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне PHP сервера, аргументы имеют тип StiEmailEventArgs:

 

Наименование

Описание

 

Идентификатор текущего события, для данного события имеет значение StiEventType::EmailReport.

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•StiViewer
•StiDesigner

format

Выбранный формат экспорта отчета. Может принимать следующие значения:

•StiExportFormat::Document
•StiExportFormat::Pdf
•StiExportFormat::Xps
•StiExportFormat::PowerPoint
•StiExportFormat::Html
•StiExportFormat::Html5
•StiExportFormat::Text
•StiExportFormat::Word
•StiExportFormat::Excel2007
•StiExportFormat::Odt
•StiExportFormat::Ods
•StiExportFormat::Rtf
•StiExportFormat::Csv
•StiExportFormat::Json
•StiExportFormat::Xml
•StiExportFormat::Dbf
•StiExportFormat::Sylk
•StiExportFormat::ImagePng
•StiExportFormat::ImageJpeg
•StiExportFormat::ImageGif
•StiExportFormat::ImageTiff
•StiExportFormat::ImageSvg
•StiExportFormat::ImageSvgz
•StiExportFormat::ImagePcx
•StiExportFormat::ImageBmp

formatName

Название выбранного формата экспорта отчета, соответствует названию констант в перечислении форматов.

data

Байтовые данные экспортированного отчета, подготовленные для отправки по Email. Данные находятся в формате Base64.

fileName

Имя файла отчета для отправки по Email.

settings

Объект, содержащий параметры отправки Email на стороне сервера. Описание всех параметров находится в отдельной таблице ниже.

 

 

В таблице ниже представлен список параметров отправки Email на стороне PHP сервера, объект параметров имеет тип StiEmailSettings:

 

Наименование

Описание

from

Email адрес отправителя письма.

name

Имя и фамилия отправителя письма.

to

Email адрес, на который будет отправлен экспортированный отчет, передается из диалогового окна вьювера.

subject

Тема письма, передается из диалогового окна вьювера.

message

Текст письма, передается из диалогового окна вьювера.

attachmentName

Имя отчета во вложении, по умолчанию используется имя файла отчета.

charset

Кодировка, используемая для текста письма, по умолчанию используется "UTF-8".

host

Адрес SMTP сервера. Является обязательным для заполнения.

port

Порт SMTP сервера, по умолчанию используется 465.

secure

Тип шифрования соединения с почтовым сервером, может использоваться "ssl" (по умолчанию) либо "tls" шифрование.

login

Логин для подключения к почтовому серверу. Является обязательным для заполнения.

password

Пароль для подключения к почтовому серверу. Является обязательным для заполнения.

cc

Массив CC (Carbon Copy) адресов вторичных получателей письма.

bcc

Массив BCC (Blind Carbon Copy) адресов скрытых получателей письма.

 

 

onDesignReport

[+] JavaScript  [-] PHP

 

Событие вызывается при нажатии на кнопку Дизайн (Design) на панели вьювера. Подробное описание и примеры использования находятся в разделе Вызов дизайнера из вьювера.

 

В таблице ниже представлен список свойств, передаваемых в аргументах события на стороне JavaScript клиента:

 

Наименование

Описание

event

Идентификатор текущего события, имеет значение "DesignReport".

sender

Идентификатор компонента, который инициировал данное событие, может принимать следующие значения:

•"Viewer"

report

Текущий объект отчета.

fileName

Имя файла текущего отчета.