Black Belt Components: Support Simple Navigation with a Document Map - Page 6

December 18, 2006

Verification: Preview the Report and Inspect Effectiveness of the Document Map

Let’s preview the report to inspect the results of our handiwork.

1.  Click the Preview tab, once again.

2.  Select All Products in the Product Category parameter selector, as depicted in Illustration 20.


Illustration 20: Select “All Products” in the Parameter Selector ...

3.  Click the View Report button, to execute the report.

The Report is being generated message briefly appears, as before, and then the report displays. The report appears as partially shown in Illustration 21.


Illustration 21: The Report Tab Displays (Document Map Tree Collapsed) ...

As we can see, DBJ_OLAP_Report.rdl has again executed, this time returning its data for all Product Categories. This time, however, we see the new Document Map tree appear in the left margin of the report. We note that the Document Map tree is collapsed by default (as we see circled in illustration above).

We will expand the Document Map tree, and then take it for a “test spin,” in the steps that follow.

4.  Expand the collapsed Document Map tree (the top level of which, as we can see, is named after the report itself), by clicking the “+” sign to its immediate left.

We see the first hierarchical level of the Document Map, representing the Sales Reason group in the report, appear. Each label can itself be expanded, to see the levels below, as we shall see, but we can also navigate the report from this level as well.

5.  Click the “Other” Sales Reason level within the tree.

We are taken to the section of the report (actually moved to Page 4 from the default display starting point, Page 1), where the “Other” Sales Reason data group begins, as partially depicted in Illustration 22.


Illustration 22: Navigating To the Level 1 “Other” Sales Reason Group ...

It is useful to remember that we are previewing the report within the development viewer, where behavior may not exactly mimic that of the viewing environment for a deployed report. For example, within the Preview tab we may click upon a given Sales Reason, and be taken appropriately to the page upon which the data for the selected Sales Reason begins, but it may appear that we are in an adjacent level until we scroll to the selected group within the window, which, of course, makes visible only a portion of a given page at a time.

6.  Expand the collapsed “Manufacturer” Sales Reason level (the level immediately underneath the “top,” DBJ_OLAP_Report level we have already expanded, in the Document Map tree, by clicking the “+” sign to its immediate left.

We see those members of the third hierarchical level of the Document Map (Product) that are associated with the respective second level, Manufacturer” Sales Reason, appear.

7.  Click the Touring-2000 Blue, 46 member of the expanded “Manufacturer” Sales Reason, within the tree.

We are taken to the section of the report where Touring-2000 Blue, 46 appears, as shown in Illustration 23.


Illustration 23: Navigating To a Specific Product ...

Another convenient characteristic of the Document Map feature resides in the fact that we can easily turn it on or off, by clicking the Show or Hide Document Map button that appears in the upper left-hand corner of the tab, just above the top level of the Document Map tree. This button is depicted (circled) in Illustration 24.


Illustration 24: Show or Hide Document Map Button

We have, therefore, seen that the Document Map feature supports navigation in the intended manner, and thereby enables us to meet the need as expressed by the information consumers. As we have noted, although the business requirement in our immediate scenario involved a simple matching of group labels to their associated Document Map labels, the flexibility of navigation support via the Document Map tree is extended in its allowance for more sophisticated labeling, based upon expressions through which we might accommodate more customized specifications. And even though the Document Map feature is not necessarily a good fit in all implementations, it can still be useful as a part of the design and development phase of the report lifecycle.

8.  Select Save -> Save All to save our work to this point.

9.  Perform other operations with the Document Map, as desired.

10.  Select File -> Exit to leave Reporting Services, when ready.

Conclusion ...

In this article, we examined the Document Map feature, which is available within any implementation of Reporting Services, to support easy navigation for information consumers. Our hands-on exposure to the “out-of-the-box” Document Map feature specifically focused upon its enablement within a sample OLAP report, containing a Matrix data region. We discussed the general concepts, and then set up a scenario wherein which we worked with a modified copy of a sample report to expose the steps involved in establishing a Document Map within a report.

Our overall objective was to demonstrate the ease with which we can employ a Document Map within a report to support a commonly encountered business need: providing information consumers with a means of easy navigation, within a report, to information upon which they wish to focus, eliminating the need for them to page through potentially large quantities of data to get there. As a part of preparing the backdrop for a practice exercise surrounding the setup of a Document Map, we created a copy of an existing sample report to leave the original intact for other uses.

The steps we took within the clone report gave us a feel for what is involved in bringing easy, out-of-the-box navigation to a report. We noted that, while the Document Map feature might not provide the sophistication to meet the precise needs of some consumers, the flexibility offered by the option for using expressions within its settings make it appealing to many who want a solution that does not involve programming and customization outside the basic application features. As we performed the necessary settings to enable the Document Map within the report, we addressed the options available, as well as the fact that the feature might have utility in the design and development phases of the report life cycle, even if it does not meet the needs of a targeted end audience. Finally, we verified the operation of our enhancements in a test of report operation.

» See All Articles by Columnist William E. Pearson, III

Discuss this article in the MSSQL Server 2000 Reporting Services Forum.

MSSQL Server Reporting Services
Introducing the Tablix Data Region: Basic Grouping Concepts
Introducing the Tablix Data Region in Reporting Services 2008
100% Stacked Column Chart for Analysis Services Data
XY (Scatter) Chart for Analysis Services Data
Simple Doughnut Chart for Analysis Services Data
Exploded Pie Chart for Analysis Services Data
Stacked Bar Chart for Analysis Services Data
Line Chart for Analysis Services Data
Stacked Column Chart for Analysis Services Data
A More Advanced Pie Chart for Analysis Services Data
Simple Pie Chart for Analysis Services Data
Simple Bar Chart for Analysis Services Data
Simple Column Chart for Analysis Services Data
Introducing Reporting Services Charts for Analysis Services
Mastering OLAP Reports: Parameterized Grouping
Mastering OLAP Reports: Parameterizing Number of "Top" Items with the MDX TopCount() Function, Part II
Mastering OLAP Reports: Parameterizing Number of "Top" Items with the MDX TopCount() Function, Part I
Mastering OLAP Reports: Parameterizing Number of "Look Back" Periods with the MDX LastPeriods() Function, Part II
Mastering OLAP Reports: Parameterizing Number of "Look Back" Periods with the MDX LastPeriods() Function, Part I
Support Parameterization from Analysis Services - Parameter Defaults
Parameterization from Analysis Services - Cascading Picklists
Support Parameterization from Analysis Services
Parameter Support Objects, Pt II: Support OLAP Parameter Defaults with Datasets
Reporting Services: Customize Automatically Created Parameter Support Objects
Snapshot Reports II: SQL Server Management Studio Perspective
Snapshot Reports I: Report Manager Perspective
Report Execution Caching II: Report Manager Perspective
Report Execution Caching I: SQL Server Management Studio Perspective
Report Session Caching in Reporting Services 2005
Black Belt Administration: Reporting Services Configuration Manager
Intelligent Layering: Leverage Conditional Formatting Logic from Analysis Services
Black Belt Administration: Performance Dashboard for Microsoft SQL Server, Part II
Black Belt Administration: Performance Dashboard for Microsoft SQL Server, Part I
Mastering OLAP Reports: Extend Reporting Services with Custom Code
Mastering OLAP Reports: Parameters for Analysis Services Reporting, Pt. II
Black Belt Components: Support Simple Navigation with a Document Map
Mastering OLAP Reports: Parameters for Analysis Services Reporting, Pt. I
Black Belt Components: Interactive Sorts within a Matrix Data Region
BlackBelt Authoring: Conditional Drillthrough to Multiple Reports
Mastering OLAP Reporting: Prototype KPIs in Reporting Services
BlackBelt Administration: Linked Reports in SQL Server Management Studio
BlackBelt Administration: Linked Reports in Report Manager
Mastering OLAP Reporting: Reporting with Analysis Services KPIs
Report Builder: Creating a Report Model
Mastering OLAP Reporting: Meet Business Needs with Matrix Dynamics, Part II
Mastering OLAP Reporting: Meet Business Needs with Matrix Dynamics, Part 1
Mastering OLAP Reporting: Display a Dataset Field in a Report Page Header
Interactive Sorting Within Reporting Services
MSSQL Server Reporting Services: Mastering OLAP Reporting: Multiple Value Selection in a Parameter Picklist
MSSQL Server Reporting Services : Mastering OLAP Reporting: Drilling Through Using MDX
MSSQL Server Reporting Services: Mastering OLAP Reporting: Relationally-Based Picklists for OLAP Reporting
MSSQL Server Reporting Services: Mastering OLAP Reporting: Extending Conditional Formatting: SWITCH and Drilldown Defaults
MSSQL Server Reporting Services: Mastering OLAP Reporting: Percent of Total - Chart Presentation Nuances
MSSQL Server Reporting Services: Mastering OLAP Reporting: Percent of Total - Two Perspectives
MSSQL Server Reporting Services : Mastering OLAP Reporting: Ad Hoc TopCount and BottomCount Parameters
MSSQL Server Reporting Services: Black Belt Components: Ad Hoc Sorting with Parameters
MSSQL Server Reporting Services: Black Belt Administration: "Governor" Capabilities: Report Execution Timeout
MSSQL Server Reporting Services : Black Belt Administration: Execution Log Performance and Audit Reports
MSSQL Server Reporting Services: Black Belt Administration: Prepare the Execution Log for Reporting
MSSQL Server Reporting Services: Black Belt Components: Ad Hoc Conditional Formatting for OLAP Reports
MSSQL Server Reporting Services : Black Belt Components: Manage Nulls in OLAP Reports
MSSQL Server Reporting Services: Reporting Services Basics: Create a Reusable Template Report
MSSQL Server Reporting Services: Master Chart Reports: Track Exchange Rates in a Line Chart
MSSQL Server Reporting Services: Master Chart Reports: Pie Charts in Reporting Services
MSSQL Server Reporting Services: Mastering OLAP Reporting: Cascading Prompts
MSSQL Server Reporting Services: Managing Reporting Services: Data-driven Subscriptions, and External Data Sources for Subscriber Data
MSSQL Server Reporting Services: Managing Reporting Services: Report Execution and Standard Subscriptions
MSSQL Server Reporting Services: Managing Reporting Services: Data Connections and Uploads
MSSQL Server Reporting Services: The Authoring Phase: Overview Part II
MSSQL Server Reporting Services: The Authoring Phase: Overview Part I
MSSQL Server Reporting Services: A New Paradigm for Enterprise Reporting








The Network for Technology Professionals

Search:

About Internet.com

Legal Notices, Licensing, Permissions, Privacy Policy.
Advertise | Newsletters | E-mail Offers