RDL Project 1.0.0
Getting Started After running the installation you should have
three programs under Start > All Programs > fyiReporting RDL Project as
well as a link to this file.
RDL DesignerThe RDL Designer is a WYSIWYG report designer
allowing you to create standard RDL reports without knowledge of RDL. This
includes wizards for creating new reports and for inserting new Tables,
Matrixes, and Charts into existing reports. There are property dialogs for all
report objects with extensive support for the entire range of power of RDL.
Browse examples using the designerOpen an existing file by
picking the File Open menu item. Under the Program Files\fyiReporting RDL
Project\Examples pick a RDL file. Most of these examples use local XML data
either embedded as part of the report definition or in a separate XML file and
do not require a database connection to run the example. Modify the RDL file and
preview to see the new report. Using the File/Save As... button you can save
reports to PDF, XML, and HTML.
New report database wizardThe New Report wizard creates a new
Table or List based report using a SQL database as the datasource. To run this
wizard you need DB connectivity to either Microsoft SQL Server and/or MySQL via
ODBC. Both of these products have free downloads that you can use to experiment
with. Other databases may work but have not been tested. To start simply click
on the File/New menu item and follow the directions in the menu.
RDL DesktopThe RDL Desktop is a small report server
providing browser access to your reports. Point your browser to the URL
http://localhost:8080/ to get a list of the example reports. The port 8080 is
the default and can be modified in the config.xml file. For security, this
server will only accept requests from your local machine unless you edit the
The RDL Reader is a MDI application that provides Adobe Reader like
capabilities for RDL reports. This application shows some of the functionality
supported by the .Net RDL control like printing, saving a report to PDF, XML, or
WinForms RdlViewer .Net controlIf you're a programmer you
should try out the RDL Project in an application you build. To use the .Net
control you need to add a reference to the RdlViewer.dll and RdlEngine.dll in
your project. You should then add RdlViewer.dll to your toolbox. Simply
assigning a file name to the SourceFile property will cause your report to load.
Alternatively, assign RDL XML to SourceRdl if you want to programmatically
generate and preview a report.
Source codeFor programming source code you can use as a
model you should also download the source code
and examples of the RDL Project.
- The RdlCmd project is a simple batch program that dynamically invokes a
report. If you're creating a web based application this code demostrates how
to invoke reports to create PDF, XML or HTML files without using a .Net
- The RdlReader project is a full MDI application exploiting the printing,
saving and other capabilities of the control.
- If you need more programmatic control of DataSets and DataSources look at
the DataTests/RdlData project example. This example shows how to use
DataTables, DataSets, XML, IEnumerable collections to populate the data in a
Release Notes for 1.0.0There are known variances from the RDL 1.0
RDL specification features not included in RDL Project 1.0.0
- Matrix report item doesn't support static rows and columns
- Chart report item supports only 2d charts. In addition, the scatter,
stock, bubble chart types aren't supported.
- In the Table report item the tablegroup footer repeat on each page is not
- The RepeatWith attribute on report items is not supported.
- The Visibility attribute on report items is not supported for HTML and XML
- RepeatOnNewPage not supported for Footer rows.
- ... be sure you test your reports and report any
- To include data as part of the report use Rows under a DataSet. Extensions
include <TypeName> and Rows subtree. The query is ignored if Rows is
specifed. When the File attribute is specified on the Rows node, then the file
will be used as data instead. When both File and Row data is specified, Row
data will only be used if the File can't be read.
The designer supports this extension in the DataSet property dialog. This
feature is especially useful when you need to test the effect different data
might have on a report's output without modifying the underlying database
- You can make a table sortable on the client side (HTML only). There are
some restrictions: no tablegroups are allowed, only a single detail row but
multiple header rows and footer rows are allowed. To exclude a column from
being sortable then put the tag on the textbox in the header.
The designer doesn't support this extension. The report, SupplierStyled.rdl,
is an example using this technique.
- A RowLimit element has been added to Query element. This acts as a
governor to the query. It is applied before any report filtering of data. For
example, if there are 20 rows in the DB , RowLimit = 10, and a Filter
eliminates the first 4 rows retrieved but would allow all subsequent only 6
rows will be in the resulting DataSet.
Mono SupportTesting with Mono 1.1.8 for Windows shows that the
base reporting engine (RdlEngine.dll) works well. Also the RdlDesktop.exe and
RdlCmd.exe modules work. The RdlDesigner.exe and RdlReader.exe modules do not
work. The RdlViewer.dll when used in RdlTests RdlData.exe works buts has severe
painting problems. In short, if you want to use Mono you are restricted to the
non-graphical parts of the RDL Project.
Reporting ProblemsPlease report any problems you encounter with
the RDL Project at our feedback page. We
try to respond to all comments, questions and problem reports.