Vertigo Software, Inc.
Summary: This white paper discusses the ASP.NET Reports Starter Kit in depth and provides insight from the perspective of the creators. In addition, the article covers how the reports can be used as a template for building other reports by examining the key application features and implementation technologies. (29 printed pages)
What is the ASP.NET Reports Starter Kit?
ASP.NET Reports Starter Kit is a guide for creating and publishing customizable web reports using ASP.NET. This guide will show developers how to implement feature rich reports without relying on third party reporting tools. Using eight samples, the Reports Starter Kit presents functional online reports and their equivalent versions optimized for printing. Developers will be able to use these sample reports to build their own reports using these techniques and ASP.NET. Key features:
Server control nesting
Displaying relational data
Datagrid paging and sorting
Dynamic image generation with GDI+
Detail's Drill down
The Reports Starter Kit was developed using both the in-line and code behind coding models. The SDK version was written using the in-line coding model and is optimized for the ASP.NET Web Matrix Project and the .NET Framework SDK. The second version was written using Microsoft ® Visual Studio.NET using the code-behind coding model. A C# and VB .NET implementation was created for both the SDK version and the Visual Studio.NET version. Application Flow
The reports home page acts as a selection page for the different reports. The user selects the desired report that they are interested in viewing from this page. This brings them to the report details page where they are presented with the overview of the report and links to more information on the reports, such as working versions, page source, business logic code, and stored procedures. Figure 1 shows the application flow.
Figure 1. Application Flow
The navigation mirrors the approach taken for the ASP.NET Store Starter Kit Documentation, where the detail information is presented in a frame below the navigation area at the top. This will be explained in depth later in this whitepaper. Home page
The Reports home page describes the eight basic reports with their iconic representation and lists features that the each report demonstrates. This allows developers to look for either a specific layout example or an example for a technical issue they are looking to solve. The user can select a report by clicking on the report name or icon, which will bring them to the report details page. Figure 2 shows the report home page.
Figure 2. ASP.NET Reports Home page
Report Details page
The details page is divided into two frames. The top frame is the navigation and the bottom frame is the content. The highlighted area in the image below is the navigational frame. It has links for the overview, live and printable versions, page source, business logic layer, and stored procedures. The bottom frame changes according to the link the user clicks in the navigational frame. Users can click on the "Reports Overview" link to return to the overview page.
Figure 3. Tabular Report Details
The Sample Reports
The tabular report shows a basic way of grouping related data (in this case, grouping products by category). The grouping is done by nesting a DataGrid control inside of a DataList control. Figure 4 shows how the DataList and the DataGrid work in tandem. The DataList displays the category name and summary information, while the DataGrid returns the products details based on the Category ID passed in from the DataList for each category.
Figure 4. DataList and DataGrid interaction
The DataList's data source is a TabularReportCollection returned from the GetHeader function. To correlate each category with its details, the DataGrid's...