By using this site you agree to the use of cookies for analytics and personalized content.
I agree Learn More

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

Articles
Опубликовано 28 Март 2018

Share this post

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

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

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

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

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

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

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

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

Globalizaion Editor

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

Globalizaion Editor

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.

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

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

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

JavaScript

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

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

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 при просмотре отчета.

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

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

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

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

Share this post

Submit to FacebookSubmit to FacebookSubmit to TwitterSubmit to TwitterSubmit to GoogleSubmit to GoogleSubmit to LinkedInSubmit to LinkedInSubmit to VKSubmit to VK
Одной из главных проблем при прочтении отчета является перегруженность информацией страниц отчета, однотонность и неразборчивость текста. Это приводит к тому, что в отчете невозможно отделить важную информацию от второстепенной. Одним из способов решения этой проблемы является удаление второстепенной информации. Однако это не всегда уместно выполнить, т.к. второстепенная информация может нести в себе косвенную нагрузку. Например, ко второстепенной информации можно отнести контактные данные организации, заголовки данных, пояснения. Поэтому, вариант удаления информации - это крайний случай.

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

Invoice Without Style

Invoice With Style

Во всех продуктах компании Stimulsoft есть встроенный инструмент для создания стилей. Этот инструмент называется дизайнер стилей. Для того, чтобы вызвать дизайнер стилей, следует, в дизайнере отчетов, на вкладке Главная нажать кнопку Дизайнер стилей. На рисунке ниже представлен дизайнер стилей.

Style Designer

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

Прежде, чем перейти к практике и создать стили, рассмотрим панель инструментов дизайнера стилей.

Style Designer Toolbar

  Меню Добавить стиль (Add Style) содержит перечень элементов отчета, для которых можно создать стили. На рисунке снизу представлено данное меню.

Add Style Menu

Некоторые элементы в этом меню, могу отсутствовать. Например, в Reports.Web отсутствуют Report Control.

  Кнопка удаления выделенного стиля из перечня стилей.

  Кнопки перемещения вверх-вниз выделенного стиля в перечне стилей.

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

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

  Кнопка создания дубликата выделенного стиля. Дубликат будет расположен ниже своего прототипа в перечне стилей.

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

  Команды управления буфером обмена: копировать выделенный стиль в буфер обмена, вырезать в буфер обмена, вставить стиль из буфера обмена.

  Кнопка Открыть сохраненную коллекцию стилей. Предварительно, следует сохранить коллекцию стилей.

  Кнопка сохранения коллекции стилей. При нажатии, необходимо определить место сохранения и имя файла.

  Кнопка закрытия дизайнера стилей.

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

На панели элементов появится новый стиль

New Style

При помощи свойств элемента, для которого создается стиль, следует определить настройки оформления. Поскольку стили могут создаваться для разных элементов отчета, то и свойства оформления будут отличаться. Например, стиль для диаграмм обладает такими свойствами, как фон области, цвет заголовков, заливка рядов и т.д. В данном примере, рассматривается создание стиля для компонента отчета (бэнд, текстовый компонент и прочие элементы, которые расположены в группе Компоненты). При помощи свойств компонента определим следующие настройки.
- Цвет заливки;
- Цвет шрифта, его стиль и размер;
- Тип границ и их цвет.

После того как стиль создан, его следует применить к элементу отчета. Это можно выполнить следующими способами.
- Выделить элемент отчета и назначит стиль через свойство Стиль Компонента или Меню стилей.
- В дизайнере стилей нажать кнопку Применить коллекцию стилей.

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

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

Style Conditions

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

img 1  По размещению, т.е. в зависимости от того, где расположен компонент. При этом, выбирается тип операции равно или не равно, т.е. размещен компонент на Заголовке отчета или не размещен. Также следует отметить, что в поле значений можно выбрать несколько компонентов. При этом можно задать также и уровень вложенности. Например, в Master-Detail отчете, необходимо чтобы стиль применялся к детальному бэнду. В этом случае, следует выбрать тип операции равно и установить значение 2. Максимальный уровень вложенности равен 100. Доступные следующие операции.
- Равно (equal to), при данной операции, стиль будет применяется, когда уровень вложенности контейнеров будет равен указанному уровню в поле значений;
- Не равно (not equal to), при выборе данной операции, стиль будет применяться ко всем компонентам в контейнерах, уровень вложенности которых не будет равен указанному уровню в поле значений;
- Операция Больше чем (greater than) выбирается, если необходимо чтобы стиль применялся к компонентам в контейнерах, уровень вложенности которых больше, чем уровень указанный в поле значений;
- Операция Больше чем или равно (greater than or equal to), выбирается если необходимо, чтобы стиль применялся к компонентам в контейнерах, уровень вложенности которых равен или больше указанного уровня в поле значений;
- Меньше чем (less than), при выборе данной операции, стиль будет применяться к компонентам в контейнерах, уровень вложенности которых будет меньше указанного уровня в поле значений;
- Меньше чем или равно (less than or equal to) выбирается, если необходимо, чтобы стиль применялся к компонентам в контейнерах, уровень вложенности которых будет равен или меньше указанного уровня в поле значений.

  Условие по типу компонентов. Этот вид условия задается, когда необходимо применять или не применять (в зависимости от типа операции - равно или не равно) стиль для компонентов определенного типа.

  Условие по расположению компонента Расположение (Location). Данный вид условия предоставляет возможность применять или не применять в зависимости от его расположения в контейнере. Также следует отметить, что в поле значений можно одновременно выбирать несколько расположений.

  По наименованию компонента. Этот вид условия предоставляет возможность применить стиль по имени или его части. Например, если установить операцию Содержит, а в поле значений указать Text, то стиль будет применен ко всем компонентам в наименовании, которых есть Text. Допустим, Text24, 1Text, Text_on и т.д. При использовании условия данного вида доступны следующие виды операций.
- Равно (equal to). При данной операции стиль будет применен к компоненту с наименованием идентичным тому, которое указано в поле значений.
- Не равно (not equal to). Если необходимо, применить стиль ко всем компонентам, кроме того, у которого наименование совпадает с указанным в поле значений, следует выбрать это значение.
- Содержит (containing). Если выбрана данная операция, то стиль будет применяться ко всем компонентам, которые в своем наименовании содержат текст указанный в поле значений.
- Не содержит (not containing). Стиль будет применяться ко всем компонентам, которые в своем наименовании не содержат текст указанный в поле значений.
- Начинается (beginning with). При выборе данной операции, стиль будет применяться ко всем компонентам, у которых наименование начинается с текста указанного в поле значений.
- Заканчивается на (ending with). При выборе данной операции, стиль будет применяться ко всем компонентам, у которых наименование заканчивается на текст указанное в поле значений.

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

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

Invoice Peach Puff

Invoice Black

Invoice Lime

Invoice Red

Также, посмотрите наши видеоуроки по работе с дизайнером стилей:
Создание стилей для диаграмм
Использование инструмента Копировать стиль
Использование границ в отчете
Создание отчета и его стилей

Share this post

Submit to FacebookSubmit to FacebookSubmit to TwitterSubmit to TwitterSubmit to GoogleSubmit to GoogleSubmit to LinkedInSubmit to LinkedInSubmit to VKSubmit to VK
We are constantly improving our products for web, providing all the necessary set of components to build reports. Today we will talk about the differences between the Flash designer

Flash designer
and HTML5 designer

HTML5 designer
Despite the similarities in terms of functionality, the designers of these reports have some differences. Flash and HTML5 report designers available in the following products – Reports Ultimate, Reports.Web, Reports.Java, Reports.PHP, Reports.Flex. However, the HTML5 report designer is also part of Stimulsoft Reports.JS.

It all starts with the system requirements for the design. The Flash report designer requires Adobe Flash Player version 11 and later. The HTML5 report designer requires only a web browser.

Integration of report designers in the project go the following way.
The Flash designer. Stimulsoft assemblies should be added to the project. Place the StiWebDesigner component on the project page and call the report designer.

OnSaveReport="StiWebDesigner1_SaveReport"
ongetpreviewdataset="StiWebDesigner1_GetPreviewDataSet" />

The HTML5 designer. Stimulsoft assemblies should be added to the project. Place the StiMobileDesigner component on the project page and call the report designer.

OnPreviewReport="StiMobileDesigner1_Preview"
OnCreateReport="StiMobileDesigner1_CreateReport"
OnGetReport="StiMobileDesigner1_GetReport"
OnExit="StiMobileDesigner1_Exit"
InterfaceType="Auto" GlobalizationFile="Localization/en.xml" Theme="Office2013WhiteTeal"

Now let's talk about the design differences in functionality, interface and tools to create reports. Below is a comparison list.

Functionality HTML5 Flash
Support for Touch UI check  
Selecting UI Localization Only from code In designer
Data Source Wizard check  
Support for OData and REST Requests check  
Data Source Type Table, Stored procedure Table
Data Dictionary Preview check  
Retrieve Column check check
Retrieve Columns and Parameters check  
Retrieve Parameters check  
Allow Run Stored Proc check  
Using Variable as SQL Parameter check  
Data from Business Objects check Without ability to create new ones
Files from Which Data Can Be Exported XML, JSON, Excel, CSV, DBase XML, JSON, CSV, DBase
Report Wizards Standard, Master-Detail Standard, Master-Detail, Label Report
Copy Style Tool Present in the Home tab  
Horizontal and Vertical Primitives In the development phase  
Shape Component check check
Report Tree   check
Interaction Editor check  
New Chart Editor check  
New Cross-Tab Editor check  
Gauges In the development phase  
Report Checker   check
Animation in Preview check  

It is worth noting that the development of the HTML5 designer is not stopping and to the end of summer 2016 this designer will have full functionality. Aslo we recommend you watch video tutorials on working with the HTML5 designer.

Customizing Email Template in Stimulsoft Reports.Server

Articles
Опубликовано 03 Август 2015

Share this post

Submit to FacebookSubmit to FacebookSubmit to TwitterSubmit to TwitterSubmit to GoogleSubmit to GoogleSubmit to LinkedInSubmit to LinkedInSubmit to VKSubmit to VK
Sometimes it is necessary to predefine the subject and text in the email. But what if you need to specify your company contact details, a subject and text in every email you send? This can be easily done using email templates. There are four templates in Stimulsoft Reports.Server. Each template is used for a certain action in the report server.

· Register an account.
· Password recovery.
· An email with the link to the file.
· An email with an attached file.

Each of these templates can be edited. Click the Administration button on the Home tab. In the window that opens, click the Templates Email tab, select the required template and click Edit.

Email Templates

In this article we will discuss an example of editing the Item Send Email Attachment template. For those who know HTML there will be no issues in editing that template. But for those who are not familiar with HTML we will try to explain, as simple as possible, how to edit the template. Users often ask about how to change the details of Stimulsoft Report on your own? It is easy to out your details.

1. To change the subject, you should change the text between the tags <title> and </title>. For example, type Your Theme.

Email Templates

2. In order to change the title Stimulsoft Reports on your own, then change the following variable {PRODUCTS} between the tags
and, to your text. For example – YOUR COMPANY NAME.

Email Templates

3. Change URL, replacing the variable {HOME-URL} to the desired URL. For example, replace it to http://YourSite.com

Email Templates

4. In addition to the URL you should specify the link text. For example, this is Click Here.

Email Templates

Notice: After changes done, click the Save button.

The email template will looks like on the picture below.

Email Templates

As you can see, all the details have changed. Thus other text of the email template can be edited. For example, you need to change the phrase "In the attachment to this message you can find following files", you need to find this text in the code of the email template and edit this.

Email Templates

Notice: Just above the text "In the attachment to this message you can find following files", you can see a variable {MESSAGE} using what the message is transmitted when the Send action in the viewer is executed.

It remains only to change the text of the email "List of Products-8/1/2015 6:19:04 AM". It is not hard to guess that here is the name of the document and the date-time of its change. There are several options to change this line.

· Replace in the variable {FORMATED-FILE-NAME} by the corresponding text.
· Or to set up the Result name leaving the {FORMATED-FILE-NAME} variable unchanged.

Here is such a brief educational program how to edit the email templates. You can cancel all changes and return the pattern to its original state, by setting all the default values by clicking the Reset button.

We have reviewed editing template Item Send Email Attachment. If you have any questions about editing email templates, you can post your questions here or send comments to technical support. We also have a corresponding section in the forum.

Stimulsoft Reports.JS. So simple.

Articles
Опубликовано 27 Июль 2015

Share this post

Submit to FacebookSubmit to FacebookSubmit to TwitterSubmit to TwitterSubmit to GoogleSubmit to GoogleSubmit to LinkedInSubmit to LinkedInSubmit to VKSubmit to VK
How to create a report having only a web-browser at hand? And, at the same time, the report should be dynamic, and its creation should be as simple as possible? We are preparing a solution for you – Stimulsoft Reports.JS. It is a platform for creating reports using JavaScript and HTML5, including designer and report viewer. The viewer is already here.


js.stimulsoft.com


After the announcement of Stimulsoft Reports.JS, most users ask us one question – what are the advantages of this reporting tool? A we are answering you).
  • No need to install additional .NET and Java applications and add-ons.
  • You can use the software in any JavaScript application.
  • A wide range of devices on which it can run – from the desktop computers to mobile devices (there is support for touch interface).
  • Does not require any servers. It works on the client side.
  • It has all the components, and tools for creating reports. From the simplest to the most complex lists, dynamic reports.
  • Compatibility of products. Reports designed for Stimulsoft Reports.JS can be viewed and edited in our other products, and vice versa.
  • Source code is available.

And the most important advantage of this product is that only a web browser with support for HTML5 and JavaScript is required.

Another issue of concern to some users is whether it is possible to have Stimulsoft Reports.JS on the server side? The answer is – yes, it is possible. In this case, the main thing is to choose the right platform. For example, Stimulsoft Reports.JS will work perfectly with node.js.

Perhaps you have your own ideas and suggestions? We will be glad to consider them. Leave your comments below or contact us through our web form. Also you may discuss the product on our forum.
TwitterTwitterFacebookFacebookRSSRSSLinked inLinked inYoutubeYoutubeStimulsoft BlogStimulsoft BlogViberViberWhatsAppWhatsAppSkypeSkypeTelegramTelegram