Глобализация отчетов

При разработке отчетов, могут возникать ситуации, когда пользователи, просматривающие построенный отчет, являются носителями разных языковых культур. В этом случае, можно сделать необходимое количество копий отчета, каждую из которых локализовать на определенный язык. Однако, при редактировании одного шаблона отчета, придется вносить правки во все его копии. Таким образом, каждое изменение шаблона отчета, будет увеличивать временные затраты на подготовку отчета и существенно повышает вероятность появления ошибок в копиях этого отчета.

Наш генератор отчетов предоставляет возможность локализации отчета в зависимости от выбранной культуры отчета. Для этого предназначен инструмент Редактор культур (Globalization Strings), при помощи которого можно определить список культур, в случае совпадения которых, будет осуществляться перевод элементов отчета. К элементам, для которых можно настроить локализацию относятся:

- Свойства отчета: Псевдоним отчета, Автор отчета, Описание отчета;
- Текстовый компонент, текст в ячейках, Rich текст;
- Каждую ячейку компонентов Таблица и Кросс-таблица;
- Переменные в отчете;
- Текстовые поля компонента Диаграмма (Заголовки осей, легенды, рядов, диаграммы, а также можно переопределить значения свойств текст до и текст после этих элементов диаграммы).

Стоит отметить, что для каждого текстового компонента, а также для каждой ячейки Таблицы и Кросс-таблицы, можно переопределить несколько свойств этого компонента. Например, если в отчете используется текстовый компонент Text1, то:

- В свойстве Text1.Hyperlink можно задать гиперссылку (или выражение) при выборе определенной культуры. Например, на локализованную web страницу вашего сайта.
- В свойстве Text1.Tag можно задать метку (или выражение) данного текстового компонента при выборе определенной культуры. Метки в отчете используются для обращения к определенному компоненту отчета.
- В свойстве Text1.Text можно задать текст (или выражение) текстового компонента, который будет обработан при построении отчета и отображен пользователю, при выборе определенной культуры.
- В свойстве Text1.Tooltip можно задать подсказку (или выражение) этого текстового компонента, при выборе определенной культуры.

Если какое-либо свойство будет не заполнено, то при выборе определенной культуры, результат будет пусто. Например, если в свойстве Text1.Text ничего не указать для определенной культуры, то при выборе этой культуры, текстовый компонент будет напечатан без какого-либо содержимого.

Примечание
Культура отчета не зависит от установленной локализации GUI дизайнера отчетов. Культура отчета зависит от значения свойства Культура (Culture). Список значений у данного свойства зависит от списка поддерживаемых культур операционной системы. По умолчанию, в отчете используется текущая культура операционной системы.

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



И на панели свойств, у свойства Редактор культур нажать кнопку Обзор (Browse). Ниже представлен Редактор культур.



1. Нажмите эту кнопку, чтобы добавить новую культуру. Добавленные культуры будут отображаться в списке культур.
2. Выделите культуру в списке, и нажмите эту кнопку, чтобы удалить культуру из списка.

3. Кнопки управления культурами:
- Получить настройки культуры из отчета, т.е. в этом случае, для элементов выбранной культуры будут установлены значения, которые используются в отчете.
- Передать настройки культуры в отчет, т.е. в этом случае, для элементов отчета будут установлены значения из выделенной культуры.

4. Если параметр Автоперевод отчета при старте (Auto Localize Report on Run) включен, то в момент построения отчета, генератор отчетов проверит культуру отчета и представлены ли они в списке. Если идентичные культуры найдены, то выражения элементов отчета будут заменены.

5. Список культур, при установлении которых, будет происходить локализация элементов отчета, т.е. замена выражений, которые указаны в определенной культуре.
6. Список элементов отчета, локализацию которых можно настроить.
7. Выражение элемента, которое будет присвоено выделенному элементу отчета, при выборе определенной культуры.

После определения списка культур в редакторе культур, и их настройки, для того чтобы осуществлялась автоматическая локализация отчета, необходимо задать культуру для отчета. Для этого в свойстве отчета Культура (Culture), следует выбрать необходимое значение. И тогда, в момент построения отчета, генератор отчетов проверит культуру отчета и их присутствие в списке редактора культур. Если идентичные культуры найдены, то выражения элементов отчета будут заменены.

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

Информация

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

Для локализации отчета в Reports.Net, Reports.Wpf, Reports.Web, Reports.Java, Reports.UWP, Reports.Silverlight:

StiReport report = new StiReport();
string cultureName = "en-US";
...
report.LocalizeReport(cultureName);
report.Render(false);

//report.LocalizeReport(cultureName);
//report.Show();
  

Для глобализации отчетов в Reports.JS, Reports.PHP (JS):

var report = new Stimulsoft.Report.StiReport();
var cultureName = "en-US";
report.localizeReport(cultureName);
report.render();

Для глобализации отчетов в Reports.Flex:

var report: StiReport = new StiReport();
var cultureName: String = "en";
...
report.localizeReport(cultureName);
report.render(false);
...
//report.localizeReport(cultureName);
//report.show();

Для локализации отчетов в Reports.PHP (Flash) необходимо установить значение глобализации для запроса GET или POST при просмотре отчета:

http://localhost/stimulsoft/index.php?
	stimulsoft_client_key=ViewerFx&stimulsoft_report_key=Report.mrt&globalization=en-US

Для локализации отчетов в Report.Java (Flash) вы должны установить параметр локализации при просмотре отчета:

<stiviewerfx:button value="Show Report" report="Report.mrt" variableStr="globalization=en-US" />

Параметр globalization - определяет, какая культура будет использоваться в отчете.