Stimulsoft Simple Tabular Report using Business Objects

Andrew-Savin · May 5, 2010

Stimulsoft reporting provides a set of powerful reporting tools for Microsoft Visual Studio .net 2008 and 2010;
these tools are available for windows forms as well as web forms. They provide many useful features such as an easy
to use report designer and native support for exporting to PDF, Word, Excel and various other formats. Stimulsoft
reporting now supports binding to any .net class; this feature is called business objects in the report designer.
Crystal Report and Microsoft reports are great for day to day reporting, but if you need to create reports with
cross-tabs and drill down, Ajax, support for barcodes and connecting to more than one report source at the same time,
then Stimulsoft reporting is a very good solution. They also have a feature where end users can create their own reports
for Adhoc reporting. All these features make Stimulsoft reports a good choice for business intelligence reporting.

In this tutorial I will show to create a simple tabular report using the Business Objects (.net classes). Show how
to create an ADO.NET data model, register entities as business objects with stimulsoft report designer and design a
tabular report and save the report definition file to run the newly created report.

The data for this sample report will come from the <A href="http://www.microsoft.com/downloads/details.aspx?FamilyID=06616212-0356-46A0-8DA2-EEBC53A68034&displaylang=en">
Northwind sample database</a> provided by Microsoft.

The demo version of Stimulsoft reporting tools can be downloaded from the website
<A href="http://stimulsoft.com/ReportsNetDownloads.aspx">http://stimulsoft.com/ReportsNetDownloads.aspx.</a>

<img width=993 height=429 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/1.png">

 <h1 align="center">Steps are required in order to create a simple tabular report using Business Objects</h1>

<a href="#1. Add an ADO.NET data model to your project">1. Add an ADO.NET data model to your project</a>
 
<a href="#2. Generate Entity Model for Northwind database">2. Generate Entity Model for Northwind database</a>
 
<a href="#3. Register Business Objects with Report Desinger">3. Register Business Objects with Report Desinger</a>
 
<a href="#4. Design new report using Business Objects">4. Design new report using Business Objects</a>
 
<a href="#5. Run new report using Business Objects">5. Run new report using Business Objects</a>
 
 
 
<a name="1. Add an ADO.NET data model to your project">1. Add an ADO.NET data model to your project
• Make sure you targeting .NET Framework version 3.5 SP1 or higher
 
• Right-click on the project name in Solution Explorer
 
• Select Add and then select New Item
 
• Select the ADO.NET Entity Date Model
 
• Type the name of the model file, for this tutorial it is going to be Northwind.edmx
 
• Click on the Add button
<img width=392 height=473 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/2.png">
<img width=688 height=424 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/3.png">
<a name="2. Generate Entity Model for Northwind database">2. Generate Entity Model for Northwind database
• Select Generate from database and click Next
 
• Choose the connection string for northwind or build our own connection string using instructions given on <A href="http://www.connectionstrings.com">http://www.connectionstrings.com</a>
 
• Select all database objects that you want to report on. For the sake of this tutorial we are going to select only the tables.
 
• Type the namespace of the ADO.net entity model as NorthwindModel or any other namespace or our choice and click on Finish.
 
• Visual studio will now scan the database schema and generate all required Entity model classes and definitions.
 
• Browse the Entity model to see various entities that are created.
 
• We will be using Customers entity to list all customers in our report.
<img width=540 height=489 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/4.png">
<img width=539 height=489 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/5.png">
<img width=924 height=883 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/6.png">
<a name="3. Register Business Objects with Report Desinger">3. Register Business Objects with Report Desinger
• Create a new form in your project
 
• Make sure you have added the reference to required stimulsoft.net dlls by right-clicking on the project and selecting add reference.
 
• Add a button called Design Report and another button called Run Report.
 
• Create an event handler for design report button.
 
• Add a code to get a list of customers using Northwind entity model (For simplicity we are getting list of all customers, in practice you would be
using LINQ to form a query by following tutorials provided Microsoft at <A href="http://msdn.microsoft.com/en-us/library/bb738636.aspx">http://msdn.microsoft.com/en-us/library/bb738636.aspx</a> )
 
• Create new a StiReport object and load the report definition from “C:\MyReport.mrt” if the file exists (For this tutorial we have fixed the location of report file for simplicity)
 
• Register the list of customers with the report object.
 
• Call the Design function of the report object to launch the designer.
<img width=469 height=438 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/7.png">
<img width=277 height=143 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/8.png">
 using Stimulsoft.Report; 
 /// <summary> 
 /// Event Handler for Design Report button 
 /// </summary> 
 private void Design_Click(object sender, EventArgs e) 
 { 
 // Get Report Object 
 StiReport report = GetReport(); 
 // Launch Report Deginer for the report 
 report.Design(); 
 } 
 
 /// <summary> 
 /// This function Loads report definition from a fixed location 
 /// and registers all Business Objects in the report definition 
 /// </summary> 
 /// <returns> 
 /// StiReport object for the report 
 /// </returns> 
 private StiReport GetReport() 
 { 
 // Create a new object of StiReport Class 
 StiReport report = new StiReport(); 
 
 // Load the report definition file from C:\MyReport.mrt if the file exists 
 // This tutorial assumes you have are storing the report definition in a fixed location 
 // If the file does not exists then Designer will allow you to save the your newly created report in the location 
 if (File.Exists("C:\\MyReport.mrt")) 
 { 
 report.Load("C:\\MyReport.mrt"); 
 
 // Get of List of all customers from database using ADO.net Enity data model 
 NorthWindEntities nw = new NorthWindEntities(); 
 List<Customers> customers = nw.Customers.ToList(); 
 nw.Dispose(); 
 
 // Register Business Objects for Customers in the report 
 report.RegBusinessObject("Northwind", "Customers", customers); 
 
 // Return report to calling function 
 return report; 
 } 

<a name="4. Design new report using Business Objects">4. Design new report using Business Objects
• On run the project by pressing F5 on your keyboard or click on Start Debugging button in Visual Studio
 
• Click on Design Report button to show the Stimulsoft report designer
 
• Brower to Dictionary and Expand Business Objects
 
• Northwind is shown here because we specified category of Customers while registering business objects using RegBusinessObject function
 
• Expand Northwind to see customers and expand customers to see all the fields that belong to customers
 
• Drag Customers and drop into the report layout to add customers table to the design
 
• Select all the fields that you want to show in the report
 
• Click on Preview tab to see the report preview
 
• Click on Save Report icon save to C:\MyReport.mrt
 
• Close the report designer
<img width=312 height=467 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/9.png">
<img width=721 height=571 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/10.png">
<img width=716 height=232 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/11.png">
<img width=718 height=465 src="http://stimulsoft.com/Articles/TabularReportUsingBusinessObjects/images/12.png">
<a name="5. Run new report using Business Objects">5. Run new report using Business Objects
• Add a event handler for Run Report button
 
• Add code to get a list of customers using Northwind entity model (For simplicity we are getting list of all customer, in practice you would be using LINQ to form a query by following tutorials provided Microsoft at Query Expression Syntax Examples: Filtering(LINQ to Entities) )
 
• Create new StiReport object and load the report definition from “C:\MyReport.mrt” if the file exists (For this tutorial we have fixed the location of report file for simplicity)
 
• Register the list of customers with the report object.
 
• Call the Show function of the report object to launch the report viewer.
 
 
 
 using Stimulsoft.Report; 
 /// <summary> 
 /// Event Handler for Run Report button 
 /// </summary> 
 private void btnRun_Click(object sender, EventArgs e) 
 { 
 // Get Report Object 
 StiReport report = GetReport(); 
 // Show report to user 
 report.Show(); 
 } 
 
 /// <summary> 
 /// This function Loads report definition from a fixed location 
 /// and registers all Business Objects in the report definition 
 /// </summary> 
 /// <returns> 
 /// StiReport object for the report 
 /// </returns> 
 private StiReport GetReport() 
 { 
 // Create a new object of StiReport Class 
 StiReport report = new StiReport(); 
 
 // Load the report definition file from C:\MyReport.mrt if the file exists 
 // This tutorial assumes you have are storing the report definition in a fixed location 
 // If the file does not exists then Designer will allow you to save the your newly created report in the location 
 if (File.Exists("C:\\MyReport.mrt")) 
 { 
 report.Load("C:\\MyReport.mrt"); 
 } 
 
 // Get of List of all customers from database using ADO.net Enity data model 
 NorthWindEntities nw = new NorthWindEntities(); 
 List<Customers> customers = nw.Customers.ToList(); 
 nw.Dispose(); 
 
 // Register Business Objects for Customers in the report 
 report.RegBusinessObject("Northwind", "Customers", customers); 
 
 // Return report to calling function 
 return report; 
 }
 
 
 
 
The author of the article is Chirag Nirmal and his linkedin profile is
<a href="http://www.linkedin.com/in/chiragn">http://www.linkedin.com/in/chiragn</a>

Stimulsoft Simple Tabular Report using Business Objects

Andrew-Savin

Member

Similar threads

Share this page

Latest posts