Как пользоваться Конфигуратором в FastReport Desktop

В этой статье я хочу рассмотреть работу с Конфигуратором, одной из программ комплекса FastReport Desktop. Эта программа предназначена для создания специальных конфигурационных файлов. Они представляют собой инструкции для построителя отчетов, они задают действия с отчетом. А именно: экспорт отчета в различные форматы, сохранение отчета на локальном диски или удаленном сервере, отправка отчета через email.

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

Давайте рассмотрим процесс создания файла конфигурации. Запускаем Конфигуратор:

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

Следующая опция – «Параметры отчета». Она позволяет задавать значения параметров отчета, если таковые есть.

Нажимаем кнопку «Настройки», и видим форму – список параметров:

Мы можем добавлять и удалять параметры соответствующими кнопками.

Опция «Настроить источник данных» позволяет добавить несколько источников данных для отчета:

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

Для удаления подключения, выбираем его в списке и нажимаем кнопку «Удалить подключение».

Далее, мы можем включить опцию «Экспорт». При этом отчет будет экспортирован в выбранном формате. Если не отмечать эту опцию, то отчет будет сохранен, или отправлен по email (в зависимости от выбранных действий) в формате fpx.

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

Если вы планируете сохранять отчет с помощью конфигурации, то включите опцию «Сохранить в» и выберите место сохранения:

В настройках опции задается путь или настройки соединения, если вы выбрали облачный сервис или FTP.

Например, настройки сохранения в папку:

Интересная опция «Добавлять метку времени к имени файла». Будет приписаны дата и время. Это полезно, если вы храните множество отчетов в одной папке.

На следующем шаге можно задать настройки отправки электронного письма:

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

Для тех, кто имел дело с отправкой электронных писем в FastReport .Net - все стандартно. Настройки аккаунта для отправки:

И само сообщение:

Файл отчета (экспорта, если выбран) будет автоматически прикреплен к письму.

Ну и последняя опция не нуждается в описании:

Настроив нужные вам опции нажимаем кнопку «Сохранить» внизу главной формы. Будет показано стандартное диалоговое окно сохранения файла.  Рядом с кнопкой сохранения есть еще одна – «Запустить».  С помощью нее вы можете запустить конфигурацию немедленно, не создавая задание в планировщике.

Файл конфигурации имеет расширение fcx, но по сути представляет собой xml документ, который можно открыть любым текстовым редактором:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

<?xml version="1.0" encoding="utf-8"?>
<Config>
 <Report
 Path="C:\Documents\Complex (Master-detail + Group).fpx" />
 <Parameters />
 <Connections />
 <Export
 As="pdf" />
 <Save
 To="folder"
 Path="C:\Documents"
 Timestamp="True" />
 <SendEmail
 Address="gromozekaster@yandex.ru"
 CC=""
 Subject="Test"
 MessageBody=""
 AccountAddress="gromozekaster@gmail.com"
 AccountName="Mail"
 AccountHost="smtp.gmail.com"
 AccountPort="465"
 AccountUserName="gromozekaster"
 AccountPassword="******"
 AccountMessageTemplate=""
 AccountEnableSSL="false" />
 <OpenAfter />
</Config>

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

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

1)      Ручной запуск из Конфигуратора. Тут все просто, создаем новый или открываем существующий конфигурационный файл и запускаем с помощью кнопки ;

2)      Запуск из командной строки Построителя отчетов (входит в состав FR Desktop) с конфигурационным файлом, который мы создали:

"Builder.exe path/to/config.fcx"

Тут мы передаем в Построитель единственный параметр – путь к файлу конфигурации;

3)      Запуск файла конфигурации по заданию в Планировщике (входит в состав FR Desktop).

Если первые два варианта не должны вызвать вопросов, то третий нуждается в рассмотрении:

Планировщик представляет собой типичную программу планирования заданий, выполняемых по расписанию. На рисунки показаны основные параметры задачи: имя, конфиг и триггер. В зависимости от значения триггера меняются настройки времени. Если это задача для однократного выполнения, то устанавливается дата и время срабатывания. Также задается время и для периодических задач, ежедневных или еженедельных. А для триггеров «При запуске компьютера» и «При входе в систему» никакие параметры не нужны. Вот и все. Когда задача отработает, то будет проставлено время последнего запуска:

Можно запустить задачу немедленно. Правый клик по задаче и из контекстного меню выбираем «Выполнить задачу сейчас».

При этом запуститься построитель:

Результаты работы построителя отражены в командной строке.

 Мы рассмотрели типовую задачу по созданию файла конфигурации и его выполнения. По сути в этом и заключается работа с FR Desktop, кроме непосредственно создания отчетов, конечно.

И напоследок. Если вы хотите изменить локализацию Конфигуратора, откройте в текстовом редакторе файл C:\Program Files (x86)\FastReports\FastReport.Desktop\settings.xml. Замените двух символьное обозначение локализации на нужное:

1
2
3
4

<?xml version="1.0" ?>
<settings>
 <language>EN</language>
</settings>