В этой статье я хочу рассмотреть работу с Конфигуратором, одной из программ комплекса FastReport.Desktop. Эта программа предназначена для создания специальных конфигурационных файлов. Они представляют собой инструкции для построителя отчетов, они задают действия с отчетом. А именно: экспорт отчета в различные форматы, сохранение отчета на локальном диски или удаленном сервере, отправка отчета через email.
Вы можете создавать такие конфигурации и запускать их вручную или при помощи специального планировщика заданий.
Давайте рассмотрим процесс создания файла конфигурации. Запускаем Конфигуратор.
Главная форма позволяет только создать новый конфигурационный файл или открыть существующий. Создаем новый. Запускается "Мастер создания конфигурационного файла", который за 4 шага создаст нужный нам конфиг. Итак, первый шаг:
Выбираем файл отчета. Это может быть, как шаблон в формате frx, так и файл предварительного просмотра отчета fpx. Далее нам предлагается выбрать экспорт отчета:
Если не отмечать флажок, то экспорт производиться не будет. Всего доступно 20 формата файлов экспорта: PDF, RTF, HTML, MHT, XML, Excel 2007, Microsoft Word 2007, PowerPoint 2007, OpenOffice Calc, OpenOffice Writer, Microsoft XPS, CSV, DBF, Txt, XAML, SVG, PPML, PostScript, Json. То есть все те же форматы, что и в FastReport.Net. Также параметры файла экспорта можно настроить с помощью соответствующей кнопки.
Далее нужно выбрать место сохранения отчета:
Тут есть тонкость. Если вы не выбрали экспорт, то сохранится файл отчета в формате предварительного просмотра fpx. Существует множество вариантов места сохранения отчета:
Это может быть локальный диск, FTP сервер или одно из популярных web-хранилищ. Я хочу сохранять файл на локальный диск. Выбираю "Папка" и открываю настройки, чтобы задать путь:
Интересная опция "Добавлять метку времени к имени файла". Будет приписаны дата и время. Это полезно, если вы храните множество отчетов в одной папке.
На следующем шаге можно задать настройки отправки электронного письма:
Тут все стандартно. Настройки аккаунта для отправки:
И само сообщение:
Файл отчета (экспорта, если выбран) будет автоматически прикреплен к письму.
Вот и все. Нажимаем кнопку "Создать". Все настройки конфигурационного файла показаны в главной форме:
Сохраняем файл конфигурации. Он имеет расширение 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 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | <?xml version="1.0" encoding="utf-16"?> <Config> <Report Path="K:\Мои документы\Complex (Master-detail + Group).fpx" /> <Export As="pdf" PageRange="All" PageNumbers="" OpenAfterExport="false" PdfA="false" Compressed="true" Background="true" EmbeddingFonts="true" TextInCurves="false" PrintOptimized="true" PdfACompliance="PdfA_2a" Title="" Author="" Subject="" Keywords="" Creator="FastReport" Producer="FastReport.NET" AllowPrint="true" AllowModify="true" AllowCopy="true" AllowAnnotate="true" HideToolbar="false" HideMenubar="false" HideWindowUI="false" FitWindow="false" CenterWindow="true" PrintScaling="false" Outline="true" DefaultZoom="ActualSize" JpegQuality="95" AutoPrint="false" /> <Save To="folder" Path="K:\Мои документы" Timestamp="True" /> <SendEmail Address="test@gmail.com" CC="" Subject="Report export" MessageBody="New report has been created" AccountAddress="username@gmail.com" AccountName="User" AccountHost="smtp.gmail.com" AccountPort="465" AccountUserName="username" AccountPassword="password" AccountMessageTemplate="This is your report has arrived!" AccountEnableSSL="true" /> </Config> |
Как вы заметили, структура файла довольно проста. Корневые теги соответствуют четырем шагам мастера создания файла конфигурации.
Мы создали файл конфигурации, теперь поговорим о способах его использования:
1) Ручной запуск из Конфигуратора. Тут все просто, создаем новый или открываем существующий конфигурационный файл и запускаем с помощью кнопки ;
2) Запуск из командной строки Построителя отчетов (входит в состав FR Desktop) с конфигурационным файлом, который мы создали:
"Builder.exe path/to/config.fcx"
Тут мы передаем в Построитель единственный параметр - путь к файлу конфигурации;
3) Запуск файла конфигурации по заданию в Планировщике (входит в состав FR Desktop).
Если первые два варианта не должны вызвать вопросов, то третий нуждается в рассмотрении:
Планировщик представляет собой типичную программу планирования заданий, выполняемых по расписанию. На рисунке показаны основные параметры задачи: имя, конфиг и триггер. В зависимости от значения триггера меняются настройки времени. Если это задача для однократного выполнения, то устанавливается дата и время срабатывания. Также задается время и для периодических задач, ежедневных или еженедельных. А для триггеров "При запуске компьютера" и "При входе в систему" никакие параметры не нужны. Вот и все. Когда задача отработает, то будет проставлено время последнего запуска:
Можно запустить задачу немедленно. Правый клик по задаче и из контекстного меню выбираем "Выполнить задачу сейчас".
При этом запустится построитель:
Результаты работы построителя отражены в командной строке.
Мы рассмотрели типовую задачу по созданию файла конфигурации и его выполнения. По сути в этом и заключается работа с FR Desktop, кроме, непосредственно, создания отчетов, конечно.