Using the Report Builder of FastReport Desktop from the command line

2017-08-13

The FastReport Desktop software package includes the console Report Builder. Report Builder - a console program to automate operations with reports.

You can perform the following operations:

  • Batch processing of reports;
  • export to all available formats;
  • Connection data source;
  • send the results by e-mail;
  • Save results locally on ftp, and to cloud storage.

Report Builder is closely connected with the Configurator, which creates a special configuration files- instructions. These instructions allow you to set the report export, choose where to save the report and send reports by email. Builder receives these instructions and execute them on a schedule that is created in the Scheduler program. But nothing prevents to work directly with the builder through the command line. This can be useful if you want to export or send reports from own applications. Let's look at three ways of interaction with Report Builder:

  • Transfer a configuration file to Builder. To do this, run the Builder on Windows command line, and pass it the configuration file:

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

Here, as you understand, the builder call with one parameter - the path to the configuration file;

  • Send configuration file to the Builder and override some of its parameters. You have the option to download the configuration file and replace the options you want, for example, a directory of saving report export:

"Builder.exe --Config-Path = path / to / config.xml --Save-Path =. / Dir"

That is to override the attribute you want to use the following scheme:

- Team {name} - {parameter name} = {value}

It turns out like this:

--Save-Path =. / Dir

In the case of override commands you need to specify the Config command to specify the path to the configuration file.

  • Send parameters-commands to the builder . With this approach, we do not load the configuration file, and in fact form the instructions for the Builder on the command line. Pass parameters, as well as the we define them in the Configurator. Let's look at an example:

--Report-Path="report.frx" --Export-As=image --Export-ImageFormat=Jpeg --Export-JpegQuality=80 --Save-To=folder --Save-Path="path/to/folder"

Since we do not load a configuration file --Config command is not needed. Note that we used the command --Export three times. For each export property you want to override (as opposed to the default values), you need to write command name.

Thus it is possible to define any parameter available in the Configurator. A full list of commands and properties (attributes) can be found in the documentation for FastReport Desktop.

So, we looked at different variants of working with console Report Builder. Now you can use it in conjunction with own programs, need only transmit a set of parameters.

FastReport Desktop FastReport Desktop
April 22, 2025

Working with the TfrShellTreeView Component in FastReport VCL

In this article, we will look at the TfrShellTreeView component. It is designed to display file system elements and is partially analogous to the TDirectoryListBox, TDirectoryOutline, and TShellTreeView components.
April 21, 2025

How RFID Tags Work in FastReport VCL

In this article, we'll check out how RFID tags work with the new TfrxDeviceCommand object in FastReport VCL with release 2025.2.
April 08, 2025

How to Set Up a Connection to Apache Ignite in FastReport .NET

In this article, we will explore how to configure a connection to Apache Ignite in FastReport .NET. You will learn the necessary steps to connect the plugin via code and the report designer.
Fast Reports
  • 800-985-8986 (English, US)
  • +31 97 01025-8466 (English, EU)
  • +49 30 56837-3928 (German, DE)
  • +55 19 98147-8148 (Portuguese, BR)
  • info@fast-report.com
  • 66 Canal Center Plaza, Ste 505, Alexandria, VA 22314

© 1998-2025 Fast Reports Inc.