Ресурсы

YouTube

 

Посмотрите наши видеоуроки по работе с ресурсами. Подписывайтесь на канал Stimulsoft и узнайте первыми о новых видеоуроках. Вопросы и предложения оставляйте в комментариях к видео.

 

 

 

Ресурсы это файлы, которые могут быть встроены в шаблон отчета. В ресурсы могут быть добавлены:

strel11 Файлы данных  CSV, Excel, JSON, XML, DBF;

strel11 Файлы изображений SVG, JPEG, JPG, PNG, BMP, GIF и другие файлы изображений.

strel11 Шаблоны отчетов (*.mrt, *.mrz) и построенные отчеты (*.mdc, *.mdz).

strel11 Файлы RTF.

 

Для того чтобы встроить файл в отчет, следует:
strel11 Выбрать команду Новый ресурс... (New Resource...) в меню Новый элемент (New Item) или контекстном меню Словаря данных (Dictionary) отчета.

strel11 Перетянуть из проводника в словарь данных файл. При перетаскивании файла с данными необходимо будет выбрать пункт Новый ресурс.

 

После выбора этой команды, будет отображено меню Новый ресурс:

 

 

 

img_1 В этом поле указывается Наименование (Name) ресурса.

img_2 В этом поле указывается Псевдоним (Alias) ресурса

img_3 В этом поле отображается выбранный файл, который будет загружен как ресурс, после нажатия кнопки ОК.

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

img_5 Команда удаления выбранного файла.

img_6 Команда просмотра выбранного файла.

img_7 Команда вызова текстового редактора для изменения выбранного файла. Однако, команда доступна только для тех файлов, которые можно отредактировать при помощи текстового редактора. Например, при выборе Excel файла данная команда будет недоступна.

img_8 Параметр Отображать во вьювере (Available in the Viewer) предоставляет возможность отображать встроенный файл на панели ресурсов во вьювере. При просмотре отчета во вьювере, можно включить панель ресурсов. Все представленные ресурсы на этой панели можно сохранить или просмотреть. Если параметр Отображать во вьювере недоступен в окне создания (редактирования) ресурса, значит файл этого типа невозможно отобразить на панели ресурсов во вьювере отчетов.
 
 

Информация

 

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

 

 

 

Сохранение ресурса из отчета

Для того чтобы сохранить ресурс из дизайнера отчетов, следует в словаре данных выделить ресурс и в контекстном меню выбрать команду Сохранить (Save). В этом случае, будет вызвано окно, в котором необходимо определить место для сохранения файла. После этого нажать кнопку Сохранить (Save) и ресурс будет сохранен в файл типа как у исходного файла. Иначе говоря, если в ресурс был добавлен *.mrt файл, то и сохранение этого ресурса будет в *.mrt файл.

 

 

Источник данных на основе ресурсов

При разработке отчетов нередко используются файлы с данными (CSV, Excel, JSON, XML, DBase). На основе этих файлов, в словаре данных можно создать источники данных, которые будут использованы при разработке шаблона отчета. В таком случае, источники данных не будут содержать реальных данных, являясь лишь описанием способов, параметров и методов доступа к реальным данным. Передача данных из файла в источники данных, а соответственно и заполнение реальными данными отчета, происходит в момент построения этого отчета.

 

При этом, следует всегда учитывать указанный путь в источнике данных к CSV, Excel, JSON, XML, DBase файлу, и при необходимости отредактировать его. Также, если необходимо передать шаблон отчета другому пользователю, то для корректного построения этого отчета, необходимо предоставить и файл с данными.

 

В таких случаях, при разработке отчетов можно добавить файлы с данными (CSV, Excel, JSON, XML, DBF) в Ресурсы отчета.

 

После того, как файл с данными добавлен в отчет как Ресурс и на его основе, можно создать источник данных:

strel11 Выбрать команду Новый источник данных... (New Data Source...) в меню Новый элемент или в контекстном меню словаря данных, определить соответствующий тип источника, указав путь к ресурсу или просто выбрав его из галереи ресурсов.

strel11 Выделить ресурс в словаре данных и в контекстном меню выбрать команду Новый источник данных [Имя ресурса] (New Data Source [Resource Name]).

 

Ниже представлено меню создания Excel источника данных:

 

 

img_1 В этом поле указывается Наименование (Name) источника данных.

img_2 В этом поле указывается Псевдоним (Alias) источника данных.

img_3 В этом указывается путь к файлу Excel, который содержит данные. В данном случае, указывается ссылка на ресурс в отчете. Ссылку можно указать в ручную по шаблону resource://file name или ссылка будет сгенерирована автоматически, при выборе ресурса из списка ресурсов.

img_4 Параметр использования первой строки в Excel файле как заголовок для данных. Если флажок установлен, то первая строка будет заголовком для данных.

img_5 Галерея ресурсов, на основе которых можно создать источник данных определенного типа.

 

После нажатия кнопки OK, созданный источник данных можно использовать при разработке отчетов.

 

 

Изображение из ресурсов

Изображения в отчетах могут быть получены из различных источников: загружены напрямую, из файла, из источника данных, по гиперссылке и т.д. Таким образом при передаче отчета иному лицу или перемещении отчета (или изображений) на другой носитель, придется передавать вместе с отчетом и изображения, редактируя путь к этим изображениям. Кроме случаев, когда изображение загружено напрямую в компонент Картинка (Image). Однако, каждый раз загружая изображение в компонент Картинка, размер файла отчета увеличивается на размер файла изображения.

 

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

 

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

 

 

 

Вложенные отчеты из ресурсов

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

 

Если отчет, который необходимо отобразить в компоненте Вложенный отчет, представляет собой другой файл (*.mrt, *.mrz, *.mdc, *.mdz), то его можно добавить в ресурсы отчета. После добавления в ресурсы можно:
strel11 Перетянуть ресурс на страницу отчета. В этом случае, будет создан компонент Вложенный отчет со ссылкой на этот ресурс.

strel11 Добавить компонент Вложенный отчет в шаблон отчета. При редактировании этого компонента указать ссылку на ресурс.

 

 

 

Также, в редакторе компонента Вложенный отчет можно передать параметр. Например, для фильтрации данных во вложенном отчете. Однако, это актуально только для не построенного отчета (*.mrt, *.mrz).

 

 

Rich-текст из ресурсов

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

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

 

 
Поэтому, один из вариантов - добавить файл с Rich-текстом в ресурсы отчета. Для того чтобы вывести Rich-текст из ресурсов можно:
strel11 Вытянуть ресурс в шаблон отчета;

strel11 В редакторе Rich-текста указать ссылку на ресурс или просто выбрать ресурс из галереи.

 

 

 

Также, в случае необходимости, текст, полученный из ресурсов, можно отредактировать в редакторе Rich-текст.