Index

• Description and features
• Reasons to use RReport
• Data population
• Components
• RReport Visual Builder
• Using the API
• Uses of RReport
  • Windows application
  • Web application (aspx)
• Other versions
  • RReport Visual Builder for the Java[TM] platform
  • RReport Visual Builder for .NET

RReport will add printing and reporting capabilities to your .NET application. RReport can be used with C# ,VBNET or any other .NET language.

Architecture
Reports templates are created using RReport Visual Builder. They are stored as files with extension .rep. The templates are read at runtime and the data for the report is extracted from database , arrays or provided by your program. Finally the report can be printed, or exported to DHTML or PDF.

• main features are

- Source code available
- Customizable preview window or
- default window's preview window

• Report fields can be populated using:

- database (ODBC, Ole ...): RReport will connect to your database and retrieve the data to be printed. It will also take into account your table relationships (primary and foreign keys).

- arrays: you can provide an array of objects as data source for a part of the report.

- programatically: you can set the value of each single object in the report also using the API from your Java[TM] program.

- user defined data sources: You can create your own objects that implement the RSource interface in order to provide the data.

• Components of the reports:

- fields (format, alignment)
- expressions
- current page number and date
- images
- combos
- areas
- groups of areas

- checkbox
- background
- borders
- lines
- rectangles
- nested areas

- page frame
- page header/footer
- report header/footer
- areas "Listener"
- charts (*)
- barcodes (*)

RReport Visual Builder

The Visual Builder is the tool the developer uses for creating the reports templates (*.rep files) which will be loaded in the final application. It is a graphical tool which allows an easy design of the templates by means of dragging and dropping objects and editting properties. The reports can be tested by just pressing the preview or the PDF/DHTML button.

Using the API

We recommend to use RReport Visual Builder in order to create your report's templates. However whenever a template is loaded at runtime all objects can be accessed and manipulated using RReport API (see doc/api.chm file). For example the following line:

[c#]

((RField) report.getAreaByName("Detail").getItemByName("company")).fontColor=Color.Red;

[vbnet]

dim f as RField
f=report.getAreaByName("Detail").getItemByName("company")
f.fontColor=Color.Red

would change the color of the text field called "company" in the detail area of the report.

It is also possible to create a report from scratch using the API, without the Visual Builder. For example:

[c#]

// create report
RReport rep=new RReport();

//create area
RArea HDR_PurchaseOrder= new RArea();
HDR_PurchaseOrder.width=16.429;
HDR_PurchaseOrder.height=4.074;
rep.setReportHeader(HDR_PurchaseOrder);

// add field to the area
RField lbltitle=new RField();
lbltitle.name="lbltitle";
lbltitle.x=0.132; // position and size
lbltitle.y=0.079;
lbltitle.width=7.339;
lbltitle.height=0.82;
lbltitle.setdefaultValue("Purchase Order");
lbltitle.FontColor=Color.Red;
lbltitle.FontType=new Font(new FontFamily("Arial"),18);
HDR_PurchaseOrder.add(lbltitle);

Using RReport in your .NET Applications

RReport can be used in your windows applications in order to be able to preview and print reports.

The software supports 2 preview windows, one of them is the Window's preview window and the other one is a propietary window you can modify so that it fits the UI of your application.

You can display and print a report in a few lines like for example:

[c#]

// load report from file
Report report=new Report();

if (!report.importReport("examples\\DatabaseSource\\DBorder.rep")) {
Console.WriteLine("Error, exiting");
Application.Exit();
}

// create preview window
RReportWindow Win= new RReportWindow(report);

// this will print the Header Area and all dependent areas
report.prepare();
report.endReport();
Win.ShowNow();

[vbnet]

' load report from file
Dim report as Report
report=new Report()

if (not report.importReport("examples\DatabaseSource\DBorder.rep")) then
Console.WriteLine("Error, exiting")
end
end if

' create preview window
Dim Win as RReportWindow
Win= new RReportWindow(report)

' this will print the Header Area and all dependent areas
report.prepare()
report.endReport()
Win.ShowNow()

Using RReport in your Web Applications

If you are building a web application and you need to print a report, we advise you to use RReport in order to create DHTML or PDF reports in the server. This report will be displayed by the browser in the client computer and printed using the browser's print button.

RReport can be used to create the DHTML or PDF output in an aspx page.

Download evaluation version

• Download version 1.0 (note: the evaluation version displays a reminder message and prints a maximum of 60 repetitions of the areas).

In order to start RReport Visual Builder you must execute:

RReportVB*.exe (where * is the NET version)

Registration

Steps for registering RReport for .NET:

1. Read the license agreement.
2. Select appropiate link below: