Construct a Report using Report Templates - RS 2005
Use the UW Report Template as a starting place in report creation. This template contains the
standard components required to publish reports on UW’s central server, as set by the Data Management Committee. The standard elements include the UW Logo, header
elements, an Executive Summary, and report metadata in the footer area. This template is to be used
- Online and printed reports, and
- Lists exported for non-report uses, such as mailing lists.
Using the Report Template
The following information describes how to customize the
standard elements of the template, how to set the report to display with or without metadata, and how
to use the built-in functions which govern the look, feel and behavior of the report.
Customize the Template Standard Elements
- Open a Report Template file in an Internet Explorer browser window (Internet Explorer is the supported browser)
- You can select from two report template files. Both files
contain all the same components – the only
difference is Report_Template is in a portrait orientation and Report_Template_landscape is in a landscape orientation. Note that each template file contains correspondingly-sized subreport files.
- Copy the file to your computer
- Click on the Properties tab at the top of the page
- Click Edit under Report Definition and a save window will appear
- Save the file to a local folder on your computer
- Open the file with Microsoft SQL Server 2008 Report Builder 2.0
- Change the Report ID (see top right corner) to the report metadata code for your report
- While on the Layout or Data tab, select from the menu: Report > Report Parameters
- In the Report Parameters window, select the ReportID parameter.
- Change the Default value from ADMIN1003 to the value for your report.
- Click OK.
- Change the Report Title and Subtitle textbox contents to the name and subtitle of your report.
- Remove the text box containing the link to the report template instructions:
- Change the DataRefresh textbox (to the left) to display the correct information for your respective data source.
- Change the values in the Parameters text box below, to reflect appropriate values for your report. If there are no parameters, enter Parameters = None
Report Display - Report or Raw Data
- The report template contains built-in functionality that allows you to choose how the
report is rendered - either with metadata, or stripped down as raw data for export to Excel.
- For each object to be hidden when rendering the report in Raw Data mode, the Hidden property
in the Visibility section has been set to the following expression:
=IIF(Parameters!RenderingType.Value = "RawData",True,False)
- The actual property entry looks like this:
- If you add additional objects to your report that should be hidden when rendering in Raw Data mode, be sure to set this property.
Reporting Services can be tailored to add functionality. The Report Template contains two
added functions – the first governs colors and fonts, and the second provides a way to display a
concatenated list of multiple parameter selections which is a very useful form of metadata.
Color and Font Management
Reporting Services does not have a formal style sheet feature. In order to maintain consistent
colors and fonts across reports, a user-defined function called StyleSelection has been added to the
report template, and has been applied to the relevant template elements. The following information
describes the function and how it is applied in the report.
The StyleSelection Function
- The Style Selection function is stored as part of the Report Properties.
- From the menu, select Report > Report Properties, then click the code tab.
- Scroll through the function to see the available values. Note how it is divided into: Background Colors, Font Colors, Font Weights and Font Sizes.
The features shown below are built into the Report Template file and no modification to their settings is required. The purpose of this section is to describe how these settings work so you can add/adjust/remove them to customize the reports.
Note: Colors and fonts are not prescribed by the Data Management Committee.
- The Report Template file contains color and font style settings for the following report objects:
- Column headings
- Table detail rows
- Table Subtotal rows
- Table Total row
- To invoke the style, a code snippet is applied to the respective report property. This code snippet then retrieves the value from the StyleSelection function.
- To see this in action, select the top row of the table, called TableRow1, by right-clicking on the icon on the far left of the row and choose Properties.
- On the Properties list, see the values for:
Normal, Arial, =code.StyleSelection("COLUMNHEADINGFontSize"), =code.StyleSelection("COLUMNHEADINGFontWeight")
- Note how the function is invoked through the =code.StyleSelection statement, and then the relevant style is set by the value passed to the function ("COLUMNHEADINGFontSize")
The ParameterList Function
This function lets you select more than one value from a drop down list and have every value selected be displayed in the report result, or more technically, provides the ability to display a concatenated list of parameters selected from a multi-value parameter. For example, you select Arts & Sciences and Engineering from a drop down list of colleges and you want to follow best practices by displaying these selections so the reader can readily see what values are governing the report output. This function makes that display possible. Here is an example of how, using ‘college’ as the multi-value parameter:
- This example assumes your report contains a parameter called college
- Set the college parameter to multi-value
- Add a new text box to the report
- Right click the text box and select Expression…
- In the Edit Expression dialog box, paste the following expression, then click OK
="School/College: " & code.ParameterList(Parameters!college.Label)
- When the report is rendered, the new text box will display a concatenated list of all values the user selected in the college parameter drop down list.