Reporting on data sources such as: MS Access, SQL Server and Oracle, is common with Crystal Reports (CR). How about
XML as the data source? Well, sure, you might be wondering how to do that? Is it even possible? Well, with help of this article I’ll show you how to use the
XML data source and report on it using CR.
I assume the reader has basic understanding of the Visual Studio (VS) 2005 IDE and Crystal Reports. You should also be comfortable writing code in C#. Basic understanding of
XML schema and
ADO.NET is desirable.
What is XML Data?
Before we see the demo, let’s get to know what
XML data is! Put in simple words,
XML stands for Extensible Markup Language. It is an initiative by W3C to allow the exchange of information.
XML is easy to understand by both humans and computers. The information stored in
XML format can work on cross platform scenarios. For example, if you have information in
XML format, it is easy to share them between the UNIX and the Windows platform. The data inside an
XML file is presented with user defined tags. Following is the partial listing from the sample
XML file which I am using in the demo:
As you can see, each
tag is equivalent to a row with information related to a CD. Furthermore, each column is uniquely identified as a tag. You can learn more on
XML. right, let’s start with our demo and see how easy it is to report on
XML data with CR and Windows Forms.
Step 1: Let’s create a Windows Application Project
If VS 2005 IDE is not already started, then you can launch the IDE by clicking on windows Start button -> All programs -> Microsoft Visual Studio 2005 -> click on icon Microsoft Visual Studio 2005. You may have others ways to lunch the IDE, such as clicking it on your desktop and so on.
- Click on menu File -> New-> Project… or you can press the hot key Ctrl + Shift + N
- From New Project dialog box select -> Visual C# -> Windows
- From Templates select -> Windows Application
- Please give a name to the application; I’ve called the project as “XMLCRReport”. You may choose a different location for storing the application files as per your preference. Please see Figure 2 for illustration of the naming process.
- Click on OK button to finish the process. VS 2005 will create a new project and add
Form1to it as default.
Let’s set the properties of the
Form1according to Table 1. In case the property toolbox is not visible in IDE, you may hit the
F4key to make it visible. Pease make sure to select
Form1before applying changes to properties using the property toolbox.
|Reporting XML data using Crystal Reports||700,300|
Step 2: Let’s add CrystalReportViewer to Form1
Crystal Report Viewer (CRV) control is needed for us to show the report to the user. Report Viewer gives life to your reports. Not only it lets you preview the output; it also allows you to generate the information in various popular formats (PDF, Excel, etc.). You can also take a hard copy print of the report while you are viewing the output.
You can add a CRV to the
Form1 as follows:
- Make sure
Form1is currently open in designer.
- Drag ToolBox -> CrystalReports -> CrystalReportViewer and drop it on
Form1. This step will create a new instance of CRV with the name crystalReportViewer1. You can name it as you prefer; I’ll stick with the default.
After the step 1 and step 2, your project should look similar to Figure
Step 3: Add a DataSet to the project
Although there are different ways you can get the data to CRV, I’ll show you here the
DataSet technique. So, let’s go ahead and add a
DataSet to the project. The following step is needed to have the
DataSet added to the project:
Select Add -> New Item ->
DataSet from Solution Explorer. Change the name from
dsCDCatalog and click the Add button. Please Cancel the TableAdapter Configuration wizard; we’ll add a
DataTable using the
Let’s add the
DataTable to our newly created
DataTable is essential to load the reporting data; we’ll use the information from the DataSet/DataTable while designing the report. The following step is required to have
DataTable added to
dsCDCatalogfrom Solution Explorer; this will open the designer view. Right-click the designer surface and select Add ->
DataTable. Click the header and change the name to
Let’s start adding columns to the
dtCDCatalog). Your designer screen should look like Figure 5. Right-click on
dtEmployeeand select Add ->
Columnto start adding the columns to the
Repeat the action for the following columns:
- Title (String)
- Artist (String)
- Country (String)
- Company (String)
- Price (Double)
- Year (String)
string. Go to the Properties windows after selecting a column to change it from
Int32. After you are done with adding columns, it should look similar to So far we’ve created the project, and added a CRV and a
DataSet. It’s time to work on the report. Following are the steps required to add Report (
Select Add -> New Item -> Crystal Report from Solution Explorer. Change the name from
rpt and click the Add button to complete the action. A dialog box of Crystal Reports Gallery will appear. Select “As a Blank Report” option and click the
OK button to complete the process to add report.
rptis open for you in designer mode and its default setting. For this example I’ll make use of only Page Header and Footer. I’ll reduce the height of Report Header and Footer
Adding a report to the project is easy. The challenge is to fill in the empty report layout. Whether this is your first report or you are a reporting junkie like me; we must deal with the most basic building blocks of the report writing. That is, the header, the detail, and the footer.
Typically, reports are designed with specific page size and layout in mind. Our report is Letter size and Portrait layout. You can explore various properties attached to the report layout by right-clicking anywhere on the open designer surface (gray area) and selecting Report and Design Properties.
It is always advisable to draw a prototype of your report on paper before you start the design process.we have the report name and report date in the header section. The body section has the employee list information; the footer carries the page numbers.
Header SectionOur header section is consists of five
LineObject and one Special Field. Please drag and drop Text Object and
LineObject from Toolbox -> Crystal Reports. You can drag and drop the “Print Date” special field from Field Explorer -> Special Fields -> Print Date. You’ll also notice that I’ve changed the color and font after placing the report object on the designer surface.
Footer section is simple; just one special field and one
LineObject. As you’ve done with the header section, you can drag and drop a
LineObject from Toolbox -> Crystal Reports. Similarly, you can drag and drop “Page N of M” special field from Field Explorer -> Special Fields -> Page N of M. Please see Figure 8 and make sure the Footer look similar.
The Details section of the report will have the CD Catalog list details. Now the question is: From where will we get the data? Well, as you know, at the beginning we added a
DataSet to this project. We will use this
DataSet as the source of data for our report.
DataSetas source of data for a report is easy. You’ll start with Right-Clicking on any open area on Report Designer -> Database -> Database Expert… As a result of this action, the Database Expert dialog box will appear. You can click on Project Data and expand the node
ADO.NET DataSet. Please select the
dtCDCatalog DataTablefrom our
DataSetand click on “>” button to move it to selected tables section on right-hand side
Once the report source is specified, all we have to do is drag and drop the fields from
DataTableinside Detail section on report designer surface. You can drag and drop all the fields from
DataTablestarting with “Title” from Field Explorer inside the details section. As you drag and drop the fields inside the detail section, you’ll notice that the title of the field is also added to report designer. Since we’ve already taken care of field header, just delete the default added field header.
Step 5: C# interface code
All right; we got all we needed as report design. Please make sure to have following
C# code behind
public partial class Form1 : Form
private void Form1_Load(object sender, EventArgs e)
DataSet dsReport = new dsCDCatalog();
// create temp dataset to read xml information
DataSet dsTempReport = new DataSet();
// using ReadXml method of DataSet read XML data from books.xml file
// copy XML data from temp dataset to our typed data set
//prepare report for preview
rptXMLData rptXMLReport = new rptXMLData();
crystalReportViewer1.DisplayGroupTree = false;
crystalReportViewer1.ReportSource = rptXMLReport;
catch (Exception ex)