Нашей командый был выполнен полный рефакторинг компонентов WebViewer, MobileViewer, MvcViewer. В результате, полностью обновлен компонент для просмотра отчетов - WebViewer. Теперь этот компонент является универсальным полнофункциональным инструментом для просмотра отчетов. В то же время, компонент WebViewer обладает рядом преимуществ по сравнению со старыми версиями. Увеличена скорость обработки отчетов и улучшена работа с кэшем, оптимизирована работа с большими отчетами (big reports). WebViewer разработан с использованием технологий HTML5 и CSS3 и поддерживается в любом браузере. Также этот компонент адаптирован для мобильных устройств.
Начиная с релиза 2016.2 генератор отчетов может запрашивать только те данные, которые необходимы для построения отчета. Для этого необходимо изменить значение только одного свойства отчета - Получить только используемые данные установить в значение true. И тогда в момент построения отчета, реальными данными будут заполняться только источники данных, которые используются в отчете. Описание данного функционала появится в документации вместе с новой версией.
В настоящее время мы делаем последние шаги для завершения грандиозного шестимесячного обновления и, через одну-две недели, мы выпустим версию 2016.2. Мы улучшили и добавили много функциональных возможностей, которые будут описаны в последующих новостях.
Следите за нашими новостями.
Следите за нашими новостями.
В продуктах компании Stimulsoft добавлена поддержка формата электронных инвойсов ZUGFeRD.
Счета в формате ZUGFeRD передают как человекочитаемые счета-фактуры, так и его структурированное машиночитаемое XML-представление. Человекочитаемое представление кодируется в виде одной или нескольких PDF-страниц формата PDF/A. XML-представление встроено в PDF-документ в качестве вложенного объекта в соответствии со спецификациями формата PDF/A-3. Иными словами, счета-фактуры формата ZUGFeRD содержат два отдельных представления, при этом человекочитаемое представление в формате PDF/A-3 служит также контейнером для XML-представления.
На данный момент использовать формат ZUGFeRD можно только из кода. Для этого следует в настройках экспорта в PDF включить опцию ZUGFeRDCompliance (это включит формат PDF/A-3 и добавит необходимую мета-информацию), а также добавить заранее приготовленный XML-файл в коллекцию EmbeddedFiles. Обращаем внимание, что имя XML-файла обязательно должно быть "ZUGFeRD-invoice.xml".
Ниже представлен пример кода для экспорта отчета с использованием формата ZUGFeRD:
Счета в формате ZUGFeRD передают как человекочитаемые счета-фактуры, так и его структурированное машиночитаемое XML-представление. Человекочитаемое представление кодируется в виде одной или нескольких PDF-страниц формата PDF/A. XML-представление встроено в PDF-документ в качестве вложенного объекта в соответствии со спецификациями формата PDF/A-3. Иными словами, счета-фактуры формата ZUGFeRD содержат два отдельных представления, при этом человекочитаемое представление в формате PDF/A-3 служит также контейнером для XML-представления.
На данный момент использовать формат ZUGFeRD можно только из кода. Для этого следует в настройках экспорта в PDF включить опцию ZUGFeRDCompliance (это включит формат PDF/A-3 и добавит необходимую мета-информацию), а также добавить заранее приготовленный XML-файл в коллекцию EmbeddedFiles. Обращаем внимание, что имя XML-файла обязательно должно быть "ZUGFeRD-invoice.xml".
Ниже представлен пример кода для экспорта отчета с использованием формата ZUGFeRD:
FileStream fileStream = new FileStream(@"d:\test.pdf", FileMode.Create);
byte[] buf = File.ReadAllBytes(@"d:\ZUGFeRD-invoice.xml");
StiPdfExportSettings pdfExportSettings = new StiPdfExportSettings();
pdfExportSettings.EmbeddedFiles.Add(new StiPdfEmbeddedFileData("ZUGFeRD-invoice.xml", "ZUGFeRD Rechnung", buf));
pdfExportSettings.ZUGFeRDCompliance = true;
report.ExportDocument(StiExportFormat.Pdf, fileStream, pdfExportSettings);
fileStream.Close();Одной из главных проблем при прочтении отчета является перегруженность информацией страниц отчета, однотонность и неразборчивость текста. Это приводит к тому, что в отчете невозможно отделить важную информацию от второстепенной. Одним из способов решения этой проблемы является удаление второстепенной информации. Однако это не всегда уместно выполнить, т.к. второстепенная информация может нести в себе косвенную нагрузку. Например, ко второстепенной информации можно отнести контактные данные организации, заголовки данных, пояснения. Поэтому, вариант удаления информации - это крайний случай.
Для того,чтобы отчет сделать легким в восприятии, предать ему презентабельный, подчеркнуть индивидуальность, отделить важную информацию от второстепенной, рекомендуется в отчете применять графические элементы и цветовое оформление. Например, изменение цвета шрифта, изменение фона заливки компонента, включение границ компонентов и т.д.. Все эти элементы в совокупности формируют стиль отчета. На рисунке ниже представлена страница отчета без стиля и с примененными стилями.
Во всех продуктах компании Stimulsoft есть встроенный инструмент для создания стилей. Этот инструмент называется дизайнер стилей. Для того, чтобы вызвать дизайнер стилей, следует, в дизайнере отчетов, на вкладке Главная нажать кнопку Дизайнер стилей. На рисунке ниже представлен дизайнер стилей.
Как видно из рисунка, дизайнер стилей состоит из панели инструментов и перечня стилей. Из перечня стилей можно сделать коллекцию стилей. Для это необходимо у стиля в свойстве Коллекции указать наименование коллекции стилей. Одна и таже коллекция стилей может быть создана единожды и применяться к различным отчетам. В тоже время, созданную коллекцию стилей, как и каждый стиль в отдельности, в любой момент можно отредактировать.
Прежде, чем перейти к практике и создать стили, рассмотрим панель инструментов дизайнера стилей.
Меню Добавить стиль (Add Style) содержит перечень элементов отчета, для которых можно создать стили. На рисунке снизу представлено данное меню.
Некоторые элементы в этом меню, могу отсутствовать. Например, в Reports.Web отсутствуют Report Control.
Кнопка удаления выделенного стиля из перечня стилей.
Кнопки перемещения вверх-вниз выделенного стиля в перечне стилей.
Кнопка Применить стили содержит выпадающий список с именами коллекций стилей. При выборе той или иной коллекции, она будет применена к отчету.
Кнопка добавления коллекции стилей. В этом случае, не требуется создавать каждый стиль в ручную. Достаточно определить основной цвет, выбрать элементы отчета для которых следует создать стиль, определить уровень иерархии в отчете и нажать кнопку ОК. Коллекция стилей будет сформирована автоматически.
Кнопка создания дубликата выделенного стиля. Дубликат будет расположен ниже своего прототипа в перечне стилей.
Кнопка копирования стиля компонента. Выделите компонент, стиль которого следует добавить в коллекцию стилей. Вызовите дизайнер стилей, не снимая выделения этого компонента. Нажмите данную кнопку. Стиль выделенного компонента будет добавлен в перечень стилей.
Команды управления буфером обмена: копировать выделенный стиль в буфер обмена, вырезать в буфер обмена, вставить стиль из буфера обмена.
Кнопка Открыть сохраненную коллекцию стилей. Предварительно, следует сохранить коллекцию стилей.
Кнопка сохранения коллекции стилей. При нажатии, необходимо определить место сохранения и имя файла.
Кнопка закрытия дизайнера стилей.
Теперь создадим стиль компонента.
- Для этого вызовем дизайнер стилей, нажав кнопку Дизайнер стилей на вкладке Главная в дизайнере отчетов;
- В дизайнере стилей нажмем кнопку Добавить стиль и выберем элемент. В данном примере, Компонент.
На панели элементов появится новый стиль
При помощи свойств элемента, для которого создается стиль, следует определить настройки оформления. Поскольку стили могут создаваться для разных элементов отчета, то и свойства оформления будут отличаться. Например, стиль для диаграмм обладает такими свойствами, как фон области, цвет заголовков, заливка рядов и т.д. В данном примере, рассматривается создание стиля для компонента отчета (бэнд, текстовый компонент и прочие элементы, которые расположены в группе Компоненты). При помощи свойств компонента определим следующие настройки.
- Цвет заливки;
- Цвет шрифта, его стиль и размер;
- Тип границ и их цвет.
После того как стиль создан, его следует применить к элементу отчета. Это можно выполнить следующими способами.
- Выделить элемент отчета и назначит стиль через свойство Стиль Компонента или Меню стилей.
- В дизайнере стилей нажать кнопку Применить коллекцию стилей.
В случае, если нажать кнопку Применить коллекцию стилей, то у стиля должно быть указаны.
- Имя коллекции, к которой он относится. Задается при помощи свойства стиля Имя коллекции;
- Условие применения стиля указывается, в случае, когда коллекция стилей содержит больше одного элемента, или стиль должен быть применен только к определенным элементам отчета.
Условие применения стиля задается при помощи редактора. Для того чтобы вызвать этот редактор, следует в дизайнере стилей выделить стиль и нажать кнопку
свойства Условия. Ниже представлен редактор Условия.
Как видно из рисунка, условия по применению стиля могут задаваться по различным критериям.
По размещению, т.е. в зависимости от того, где расположен компонент. При этом, выбирается тип операции равно или не равно, т.е. размещен компонент на Заголовке отчета или не размещен. Также следует отметить, что в поле значений можно выбрать несколько компонентов. При этом можно задать также и уровень вложенности. Например, в 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). При выборе данной операции, стиль будет применяться ко всем компонентам, у которых наименование заканчивается на текст указанное в поле значений.
Также, допустимо комбинирование разных видов условий. В этом случае, стиль будет применен, если сработают все условия. Иными словами, если используются условия видов Размещение и Наименование компонента, то стиль будет применен только в том случае, если эти условия выполняются. Кроме этого, возможно использование мульти-условий, т.е. когда задействовано два и более блока условий. В этом случае, к компоненту будут применены стили только в том случае, если все виды условий во всех блоках будут выполнены. Выполнение условий начинается после нажатия на кнопку Применить стили.
После того, как стиль создан и все его настройки определены, следует нажать кнопку Сохранить на панели инструментов в дизайнере стилей. Определите место хранения файла со стилями и его имя. Один раз создав стили, и применяя их к отчетам, вы тем самым подчеркиваете фирменный стиль вашей компании. При этом, для изменения корпоративного стиля отчетов, вам потребуется отредактировать только необходимые стили.
Также, посмотрите наши видеоуроки по работе с дизайнером стилей:
Создание стилей для диаграмм
Использование инструмента Копировать стиль
Использование границ в отчете
Создание отчета и его стилей
Для того,чтобы отчет сделать легким в восприятии, предать ему презентабельный, подчеркнуть индивидуальность, отделить важную информацию от второстепенной, рекомендуется в отчете применять графические элементы и цветовое оформление. Например, изменение цвета шрифта, изменение фона заливки компонента, включение границ компонентов и т.д.. Все эти элементы в совокупности формируют стиль отчета. На рисунке ниже представлена страница отчета без стиля и с примененными стилями.
Во всех продуктах компании Stimulsoft есть встроенный инструмент для создания стилей. Этот инструмент называется дизайнер стилей. Для того, чтобы вызвать дизайнер стилей, следует, в дизайнере отчетов, на вкладке Главная нажать кнопку Дизайнер стилей. На рисунке ниже представлен дизайнер стилей.
Как видно из рисунка, дизайнер стилей состоит из панели инструментов и перечня стилей. Из перечня стилей можно сделать коллекцию стилей. Для это необходимо у стиля в свойстве Коллекции указать наименование коллекции стилей. Одна и таже коллекция стилей может быть создана единожды и применяться к различным отчетам. В тоже время, созданную коллекцию стилей, как и каждый стиль в отдельности, в любой момент можно отредактировать.
Прежде, чем перейти к практике и создать стили, рассмотрим панель инструментов дизайнера стилей.
Меню Добавить стиль (Add Style) содержит перечень элементов отчета, для которых можно создать стили. На рисунке снизу представлено данное меню. Некоторые элементы в этом меню, могу отсутствовать. Например, в Reports.Web отсутствуют Report Control.
Кнопка удаления выделенного стиля из перечня стилей. Кнопки перемещения вверх-вниз выделенного стиля в перечне стилей. Кнопка Применить стили содержит выпадающий список с именами коллекций стилей. При выборе той или иной коллекции, она будет применена к отчету. Кнопка добавления коллекции стилей. В этом случае, не требуется создавать каждый стиль в ручную. Достаточно определить основной цвет, выбрать элементы отчета для которых следует создать стиль, определить уровень иерархии в отчете и нажать кнопку ОК. Коллекция стилей будет сформирована автоматически. Кнопка создания дубликата выделенного стиля. Дубликат будет расположен ниже своего прототипа в перечне стилей. Кнопка копирования стиля компонента. Выделите компонент, стиль которого следует добавить в коллекцию стилей. Вызовите дизайнер стилей, не снимая выделения этого компонента. Нажмите данную кнопку. Стиль выделенного компонента будет добавлен в перечень стилей. Команды управления буфером обмена: копировать выделенный стиль в буфер обмена, вырезать в буфер обмена, вставить стиль из буфера обмена. Кнопка Открыть сохраненную коллекцию стилей. Предварительно, следует сохранить коллекцию стилей. Кнопка сохранения коллекции стилей. При нажатии, необходимо определить место сохранения и имя файла. Кнопка закрытия дизайнера стилей. Теперь создадим стиль компонента.
- Для этого вызовем дизайнер стилей, нажав кнопку Дизайнер стилей на вкладке Главная в дизайнере отчетов;
- В дизайнере стилей нажмем кнопку Добавить стиль и выберем элемент. В данном примере, Компонент.
На панели элементов появится новый стиль
При помощи свойств элемента, для которого создается стиль, следует определить настройки оформления. Поскольку стили могут создаваться для разных элементов отчета, то и свойства оформления будут отличаться. Например, стиль для диаграмм обладает такими свойствами, как фон области, цвет заголовков, заливка рядов и т.д. В данном примере, рассматривается создание стиля для компонента отчета (бэнд, текстовый компонент и прочие элементы, которые расположены в группе Компоненты). При помощи свойств компонента определим следующие настройки.
- Цвет заливки;
- Цвет шрифта, его стиль и размер;
- Тип границ и их цвет.
После того как стиль создан, его следует применить к элементу отчета. Это можно выполнить следующими способами.
- Выделить элемент отчета и назначит стиль через свойство Стиль Компонента или Меню стилей.
- В дизайнере стилей нажать кнопку Применить коллекцию стилей.
В случае, если нажать кнопку Применить коллекцию стилей, то у стиля должно быть указаны.
- Имя коллекции, к которой он относится. Задается при помощи свойства стиля Имя коллекции;
- Условие применения стиля указывается, в случае, когда коллекция стилей содержит больше одного элемента, или стиль должен быть применен только к определенным элементам отчета.
Условие применения стиля задается при помощи редактора. Для того чтобы вызвать этот редактор, следует в дизайнере стилей выделить стиль и нажать кнопку
свойства Условия. Ниже представлен редактор Условия. Как видно из рисунка, условия по применению стиля могут задаваться по различным критериям.
По размещению, т.е. в зависимости от того, где расположен компонент. При этом, выбирается тип операции равно или не равно, т.е. размещен компонент на Заголовке отчета или не размещен. Также следует отметить, что в поле значений можно выбрать несколько компонентов. При этом можно задать также и уровень вложенности. Например, в 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). При выборе данной операции, стиль будет применяться ко всем компонентам, у которых наименование заканчивается на текст указанное в поле значений.
Также, допустимо комбинирование разных видов условий. В этом случае, стиль будет применен, если сработают все условия. Иными словами, если используются условия видов Размещение и Наименование компонента, то стиль будет применен только в том случае, если эти условия выполняются. Кроме этого, возможно использование мульти-условий, т.е. когда задействовано два и более блока условий. В этом случае, к компоненту будут применены стили только в том случае, если все виды условий во всех блоках будут выполнены. Выполнение условий начинается после нажатия на кнопку Применить стили.
После того, как стиль создан и все его настройки определены, следует нажать кнопку Сохранить на панели инструментов в дизайнере стилей. Определите место хранения файла со стилями и его имя. Один раз создав стили, и применяя их к отчетам, вы тем самым подчеркиваете фирменный стиль вашей компании. При этом, для изменения корпоративного стиля отчетов, вам потребуется отредактировать только необходимые стили.
Также, посмотрите наши видеоуроки по работе с дизайнером стилей:
Создание стилей для диаграмм
Использование инструмента Копировать стиль
Использование границ в отчете
Создание отчета и его стилей