IBM Cognos Report StudioVersion 10.2.1

User Guide

NoteBefore using this information and the product it supports, read the information in Notices on page 983.

Product InformationThis document applies to IBM Cognos Business Intelligence Version 10.2.1 and may also apply to subsequentreleases.

Licensed Materials - Property of IBM

Copyright IBM Corporation 2005, 2013.US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contractwith IBM Corp.

ContentsIntroduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xlvii

Chapter 1. What's New in Cognos Report Studio? . . . . . . . . . . . . . . . . . 1New features in version 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Improved IBM Cognos Active Report performance . . . . . . . . . . . . . . . . . . . . . 1Extensible visualizations in IBM Cognos Active Report . . . . . . . . . . . . . . . . . . . . 1Option to group or ungroup repeating cells in Excel 2007 reports . . . . . . . . . . . . . . . . . 2Crosstab values as percentages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Share sets between reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Improved text-based relational filters . . . . . . . . . . . . . . . . . . . . . . . . . . 2Improved data container and query naming support . . . . . . . . . . . . . . . . . . . . . 3Search parameter Ends with any of these keywords . . . . . . . . . . . . . . . . . . . . . 3

Removed Features in Version 10.2.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3IBM Cognos Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

New features in version 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Updated world and Africa maps. . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Interactive repeater tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Improved IBM Cognos Active Report integration with IBM Cognos Workspace . . . . . . . . . . . . 4Improved support for bidirectional languages . . . . . . . . . . . . . . . . . . . . . . . 5Macro tab in expression editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Inherited table styles in lists and crosstabs . . . . . . . . . . . . . . . . . . . . . . . . 5Enhanced crosstab headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Prompt API. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Excel 2007 Data report output format . . . . . . . . . . . . . . . . . . . . . . . . . . 6Global classes for accessible reports. . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Changed features in version 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Support for inline prompts in reports viewed on mobile devices . . . . . . . . . . . . . . . . . 7Cognos Business Insight and Cognos Business Insight Advanced are renamed . . . . . . . . . . . . 7

Removed Features in Version 10.2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . 7Saving and opening reports on your computer . . . . . . . . . . . . . . . . . . . . . . . 7

New features in version 10.1.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7New active report controls. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Conversion of controls to other types of controls . . . . . . . . . . . . . . . . . . . . . . 8Improved user experience when authoring active reports . . . . . . . . . . . . . . . . . . . 8Active report access code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8New startup options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Keyboard shortcuts for accessibility. . . . . . . . . . . . . . . . . . . . . . . . . . . 9Updated maps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Custom groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Larger worksheet sizes for Microsoft Excel 2007 report outputs . . . . . . . . . . . . . . . . . 10Microsoft Excel 2007 supported as an external data source. . . . . . . . . . . . . . . . . . . 10

Changed features in version 10.1.1. . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Specify how to show no data contents . . . . . . . . . . . . . . . . . . . . . . . . . 10

What's new in version 10.1.0. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11New Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11Changed Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 19Removed Features in Version 10.1.0 . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Chapter 2. Getting started with Report Studio . . . . . . . . . . . . . . . . . . . 21Building IBM Cognos Business Intelligence Applications . . . . . . . . . . . . . . . . . . . . 21Relational and dimensional reporting styles . . . . . . . . . . . . . . . . . . . . . . . . 22The User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25Work in design or structure view . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Report Layout and Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Copyright IBM Corp. 2005, 2013 iii

Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30Report Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

Find Objects in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Web Browser Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36The IBM Cognos Software Development Kit . . . . . . . . . . . . . . . . . . . . . . . . 37

Chapter 3. Creating a report . . . . . . . . . . . . . . . . . . . . . . . . . . 39Specify the Data Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Refresh the package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Choose a Basic Report Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40

Inserting a data container from the toolbox tab . . . . . . . . . . . . . . . . . . . . . . 41Add Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Data Source Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Insert a Single Data Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42

Validate a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Save a Report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44Run a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Specify Not to Render a Page If It Does Not Contain Data. . . . . . . . . . . . . . . . . . . 47Controlling the Rows Per Page for Multiple Containers in HTML and PDF . . . . . . . . . . . . . 48Producing a Report in CSV Format . . . . . . . . . . . . . . . . . . . . . . . . . . 48Producing a Report in Microsoft Excel Format . . . . . . . . . . . . . . . . . . . . . . . 49Producing a Report in XML Format . . . . . . . . . . . . . . . . . . . . . . . . . . 52Set PDF Page Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

View Lineage Information for a Data Item . . . . . . . . . . . . . . . . . . . . . . . . . 53The IBM Cognos Business Intelligence Lineage Tool . . . . . . . . . . . . . . . . . . . . . 54

Access the IBM WebSphere Business Glossary . . . . . . . . . . . . . . . . . . . . . . . . 55Support for bidirectional languages . . . . . . . . . . . . . . . . . . . . . . . . . . . 56Reports for workspaces in Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . . 57

Prompts in workspaces in Cognos Workspace . . . . . . . . . . . . . . . . . . . . . . . 58Enable filters in workspaces in Cognos Workspace . . . . . . . . . . . . . . . . . . . . . 59

Creating Reports for IBM Cognos for Microsoft Office . . . . . . . . . . . . . . . . . . . . . 59Creating Reports for Mobile Devices . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Creating location-aware reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Chapter 4. Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Set List Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63Hide Columns in List Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64Using Repeaters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Convert a List into a Repeater . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65Example - Create Mailing Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Chapter 5. Crosstabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67Crosstab Nodes and Crosstab Node Members . . . . . . . . . . . . . . . . . . . . . . . . 67Set Crosstab Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Create a Single-Edge Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70Create a Nested Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71Creating headers automatically for sets in crosstabs . . . . . . . . . . . . . . . . . . . . . . 72Showing crosstab values as percentages . . . . . . . . . . . . . . . . . . . . . . . . . . 72Specify the Default Measure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Swap Columns and Rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Indent Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74Change a List into a Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Example - Add Aggregate Data to a Crosstab . . . . . . . . . . . . . . . . . . . . . . . . 75Example - Create a Discontinuous Crosstab. . . . . . . . . . . . . . . . . . . . . . . . . 76

Chapter 6. Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Current Default Charts and Legacy Charts . . . . . . . . . . . . . . . . . . . . . . . . . 79Creating Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79

Chart Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80

iv IBM Cognos Report Studio Version 10.2.1: User Guide

Chart Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83Choosing a Chart Type and Configuration . . . . . . . . . . . . . . . . . . . . . . . . 83Column Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84Line Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Pie Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86Bar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87Area Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Point Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Combination Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Scatter Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Bubble Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91Quadrant Charts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92Bullet Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Gauge Charts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94Pareto Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Progressive Column Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Microcharts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96Marimekko Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97Radar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Polar Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Range Indicator Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99Chart Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

Convert Charts From One Type to Another . . . . . . . . . . . . . . . . . . . . . . . . 102Convert Legacy Charts to Current Default Charts . . . . . . . . . . . . . . . . . . . . . . 103

Limitations When Converting Legacy Charts . . . . . . . . . . . . . . . . . . . . . . . 103Customizing Chart Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104

Resize a Current Default Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . 107Resize a Legacy Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108Customizing the Color Palette of a Chart . . . . . . . . . . . . . . . . . . . . . . . . 108Creating a Conditional Color Palette in a Chart . . . . . . . . . . . . . . . . . . . . . . 111Change a Chart Background in a Current Default Chart . . . . . . . . . . . . . . . . . . . 115Change a Chart Background in a Legacy Chart . . . . . . . . . . . . . . . . . . . . . . 115Add Background Effects to a Chart Object in a Legacy Chart . . . . . . . . . . . . . . . . . 116Add Colored Regions in a Current Default Chart . . . . . . . . . . . . . . . . . . . . . 117Specify Custom Label Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Customizing the Axes of a Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Showing Gridlines in a Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123Customize the Legend in a Current Default Chart . . . . . . . . . . . . . . . . . . . . . 124Customize the Items in the Legend of a Legacy Chart . . . . . . . . . . . . . . . . . . . . 126Adding a Note to a Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Adding a Baseline to a Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128Adding Markers to Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Display Trendlines in Current Default Charts. . . . . . . . . . . . . . . . . . . . . . . 134Display Regression Lines in Legacy Scatter or Bubble Charts . . . . . . . . . . . . . . . . . 135Showing data values in current default charts . . . . . . . . . . . . . . . . . . . . . . 136Showing data values in current default pie and donut charts . . . . . . . . . . . . . . . . . 137Showing data values in other current default charts . . . . . . . . . . . . . . . . . . . . 138Define Query Context When Customizing Legend Entries, Legend Titles, or Axis Labels . . . . . . . . 138Summarize Small Slices, Bars, or Columns in Current Default Charts . . . . . . . . . . . . . . . 139Customizing Lines and Data Points in a Line Chart . . . . . . . . . . . . . . . . . . . . 139Customize a Current Default Combination Chart . . . . . . . . . . . . . . . . . . . . . 141Create a Matrix of Current Default Charts . . . . . . . . . . . . . . . . . . . . . . . . 142Customize a Current Default Gauge Chart . . . . . . . . . . . . . . . . . . . . . . . 144Customize a Legacy Gauge Chart . . . . . . . . . . . . . . . . . . . . . . . . . . 145Define Color by Value in Current Default Scatter and Bubble Charts . . . . . . . . . . . . . . . 146Specify the Bubble Size in a Current Default Bubble Chart . . . . . . . . . . . . . . . . . . 148Set the Position of the First Slice in a Current Default Pie Chart . . . . . . . . . . . . . . . . 148Create a Donut Chart from a Current Default Pie Chart . . . . . . . . . . . . . . . . . . . 149Pull Out Pie Slices in a Current Default Pie Chart . . . . . . . . . . . . . . . . . . . . . 149Define the Cumulation Line in a Current Default Pareto Chart . . . . . . . . . . . . . . . . . 151Define the Cumulation Line in a Legacy Pareto Chart . . . . . . . . . . . . . . . . . . . . 151

Contents v

Insert a Microchart into a Crosstab . . . . . . . . . . . . . . . . . . . . . . . . . . 152Customize a Current Default Bullet Chart . . . . . . . . . . . . . . . . . . . . . . . . 152

Changing the number of hotspots in a chart . . . . . . . . . . . . . . . . . . . . . . . . 153Create a Drill-up and Drill-down Chart . . . . . . . . . . . . . . . . . . . . . . . . . 153Example - Creating Drill-through Access in a Legacy Chart . . . . . . . . . . . . . . . . . . . 154

Create the target report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Create the Source Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Define the Drill Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

Example - Creating and Customizing a Metrics Range Legacy Chart . . . . . . . . . . . . . . . . 156Create a Metrics Range Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Customize the Chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Customize the Chart Legend Labels . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Adding a Metric Studio Diagram to a Report. . . . . . . . . . . . . . . . . . . . . . . . 158Add a Static Metric Studio Diagram to a Report . . . . . . . . . . . . . . . . . . . . . . 159Add a Data-driven Metric Studio Diagram to a Report . . . . . . . . . . . . . . . . . . . 159

Chapter 7. Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161The Report Studio Map Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Example - Create a Map Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162Set Map Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Example - Define Data Values for the Region Layer . . . . . . . . . . . . . . . . . . . . . 165Match Data Values to Names in the Map File. . . . . . . . . . . . . . . . . . . . . . . . 166Define Data Values for the Point Layer . . . . . . . . . . . . . . . . . . . . . . . . . . 166Add Colors to the Region or Point Layer . . . . . . . . . . . . . . . . . . . . . . . . . 167Add a Legend Title to a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Add a Note to a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168Drill Through to Another Report From a Map . . . . . . . . . . . . . . . . . . . . . . . 168Edit a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Additional Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Location Intelligence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170

Chapter 8. Active Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Active Report Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171Active Report Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Convert an Existing Report to an Active Report . . . . . . . . . . . . . . . . . . . . . . . 172Specify Active Report Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173Extensible visualizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173

Adding a visualization to an active report . . . . . . . . . . . . . . . . . . . . . . . . 174Adding a treemap visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Adding a heatmap visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . 177Creating a packed bubble visualization . . . . . . . . . . . . . . . . . . . . . . . . . 178Adding a network diagram. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180Resizing a visualization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Changing the nesting order. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181Populating a visualization with data from the visualization definition . . . . . . . . . . . . . . 182Specifying the range values that are displayed . . . . . . . . . . . . . . . . . . . . . . 182Updating visualizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183

Adding Interactivity to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184Create and Manage Active Report Variables . . . . . . . . . . . . . . . . . . . . . . . 184Adding Controls to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Add Data to a Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Define a Connection Between Controls . . . . . . . . . . . . . . . . . . . . . . . . . 192Specify the Selection Behavior of a Control . . . . . . . . . . . . . . . . . . . . . . . 193Specify the Reaction Behavior of a Control . . . . . . . . . . . . . . . . . . . . . . . 194Set the No Value List Item . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Show or Hide a Column or Row . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Sort Data in a List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Recommendation - use master detail relationships when authoring decks . . . . . . . . . . . . . 197

Summarizing Data in the Active Report Output . . . . . . . . . . . . . . . . . . . . . . . 198Run or Save an Active Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198

vi IBM Cognos Report Studio Version 10.2.1: User Guide

Example - Create an Active Report Showing Revenue Data for Core Products . . . . . . . . . . . . . 199Create the active report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199Add data to the data drop-down list controls. . . . . . . . . . . . . . . . . . . . . . . 200Add data to the list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Add interactivity to the report. . . . . . . . . . . . . . . . . . . . . . . . . . . . 202Specifying default values for the data drop-down list controls . . . . . . . . . . . . . . . . . 202Revenue data for core products report output . . . . . . . . . . . . . . . . . . . . . . 202

Example - Sales analysis active report . . . . . . . . . . . . . . . . . . . . . . . . . . 203Creating a new active report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203Adding data to the check box group control . . . . . . . . . . . . . . . . . . . . . . . 204Adding a default card to the deck and data to the data discrete values slider . . . . . . . . . . . . 204Defining a connection between the check box group and the deck . . . . . . . . . . . . . . . . 205Adding data to the list object . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Defining a connection between the slider and the list object . . . . . . . . . . . . . . . . . . 206Adding a title to the list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206Adding data to the data deck and chart . . . . . . . . . . . . . . . . . . . . . . . . 207Defining a connection between the chart and the data deck . . . . . . . . . . . . . . . . . . 207Adding a title to the chart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208Sales analysis report output . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Example - Network diagram visualization . . . . . . . . . . . . . . . . . . . . . . . . . 209Adding a new visualization in IBM Cognos Active Report . . . . . . . . . . . . . . . . . . 209Adding data to the nodes data container . . . . . . . . . . . . . . . . . . . . . . . . 210Adding data to the links data container . . . . . . . . . . . . . . . . . . . . . . . . 210Defining a connection between the data drop-down list and the visualization object. . . . . . . . . . 210Network diagram visualization output . . . . . . . . . . . . . . . . . . . . . . . . . 211

Chapter 9. Relational Reporting Style . . . . . . . . . . . . . . . . . . . . . . 213Add Relational Data to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213Group Relational Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213

Perform Advanced Grouping . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214Creating relational custom groups . . . . . . . . . . . . . . . . . . . . . . . . . . 215Set the Group Span for a Column . . . . . . . . . . . . . . . . . . . . . . . . . . 216Divide Data into Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Summarizing Data Relationally . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219Add a Simple Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220Set the Auto Group & Summarize Property . . . . . . . . . . . . . . . . . . . . . . . 221Specify Detail or Summary Aggregation in the Model . . . . . . . . . . . . . . . . . . . . 222Specify Aggregation Properties for a Data Item . . . . . . . . . . . . . . . . . . . . . . 222Use Summary Functions in Data Item Expressions . . . . . . . . . . . . . . . . . . . . . 222Summary Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

Focusing Relational Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228Create a Detail or Summary Filter . . . . . . . . . . . . . . . . . . . . . . . . . . 229Edit or remove a filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233Browse or Search the Values of a Data Item . . . . . . . . . . . . . . . . . . . . . . . 233Ignoring the Time Component in Date Columns. . . . . . . . . . . . . . . . . . . . . . 234

Sorting Relational Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235Perform Advanced Layout Sorting . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Working with Relational Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236Specify a List of Data Items for an Object . . . . . . . . . . . . . . . . . . . . . . . . 237Relate a Query to a Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237Connecting Queries Between Different Data Sources . . . . . . . . . . . . . . . . . . . . 237Add a Query to a Relational Report . . . . . . . . . . . . . . . . . . . . . . . . . . 238Create a Union Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239Create a Join Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242Reference a Package Item in a Child Query . . . . . . . . . . . . . . . . . . . . . . . 243Create a Master Detail Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . 244Working with Queries in SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246

Using Relational Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248Create a Simple Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249Insert a Query Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 250Create a Layout Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252

Contents vii

Chapter 10. Dimensional Reporting Style . . . . . . . . . . . . . . . . . . . . 253Add Dimensional Data to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . 253

Customize the Source Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Insert a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 255Search for a Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 256Nest Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Insert a Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257Insert a Member Property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258Create a Set of Members. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 258Sharing sets between reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . 259Edit a Set. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261Extended Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263Tips for Working with Ragged or Unbalanced Hierarchies . . . . . . . . . . . . . . . . . . 264

Creating dimensional custom groups . . . . . . . . . . . . . . . . . . . . . . . . . . 265Summarizing Data Dimensionally . . . . . . . . . . . . . . . . . . . . . . . . . . . 266

Add a Simple Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268Summarizing Values in Crosstabs . . . . . . . . . . . . . . . . . . . . . . . . . . 269Summarizing Member Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271Rolling and Moving Averages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 272Show Data for Specific Time Periods . . . . . . . . . . . . . . . . . . . . . . . . . 273Summary Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273

Focusing Dimensional Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278Create a Context Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279

Sorting Dimensional Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281Sort Sets by Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282Sort Sets in the Opposite Axis by Value . . . . . . . . . . . . . . . . . . . . . . . . 282Perform Advanced Set Sorting. . . . . . . . . . . . . . . . . . . . . . . . . . . . 283

Working with Dimensional Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . 283Specify a List of Data Items for an Object . . . . . . . . . . . . . . . . . . . . . . . . 284Relate a Query to a Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284Using Dimensional Data Sources with Queries . . . . . . . . . . . . . . . . . . . . . . 284Connecting Queries Between Different Data Sources . . . . . . . . . . . . . . . . . . . . 285Multiple-fact Queries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285Add a Query to a Dimensional Report . . . . . . . . . . . . . . . . . . . . . . . . . 289Add Dimension Information to a Query . . . . . . . . . . . . . . . . . . . . . . . . 290Create a Master Detail Relationship . . . . . . . . . . . . . . . . . . . . . . . . . . 292Working with Queries in SQL or MDX . . . . . . . . . . . . . . . . . . . . . . . . . 295Example - Create a Dynamic Report That Shows Period-to-date Data. . . . . . . . . . . . . . . 300

Using Dimensional Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302Create a Simple Member Calculation . . . . . . . . . . . . . . . . . . . . . . . . . 302Insert a Query Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303Create a Layout Calculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305Create an Intersection (Tuple) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306Assigning a Hierarchy or Dimension . . . . . . . . . . . . . . . . . . . . . . . . . 306

Drilling Up and Drilling Down in Dimensional Reports . . . . . . . . . . . . . . . . . . . . 307Member Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307Create a Drill-up and Drill-down Report . . . . . . . . . . . . . . . . . . . . . . . . 308Example - Create a Dashboard Report . . . . . . . . . . . . . . . . . . . . . . . . . 310

Chapter 11. Adding Prompts to Filter Data . . . . . . . . . . . . . . . . . . . . 313Use the Build Prompt Page Tool . . . . . . . . . . . . . . . . . . . . . . . . . . . . 314Build Your Own Prompt and Prompt Page . . . . . . . . . . . . . . . . . . . . . . . . 315

Example - Create a Report Showing Products Shipped for a Specific Time Interval . . . . . . . . . . 318Create a Parameter to Produce a Prompt . . . . . . . . . . . . . . . . . . . . . . . . . 319Create a Prompt Directly in a Report Page . . . . . . . . . . . . . . . . . . . . . . . . 320Modifying Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

Change the Prompt Control Interface . . . . . . . . . . . . . . . . . . . . . . . . . 321Specify That a Prompt Requires User Input . . . . . . . . . . . . . . . . . . . . . . . 322Allow Users to Select Multiple Values in a Prompt . . . . . . . . . . . . . . . . . . . . . 322Show or Hide Prompt Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Specify a Default Selection for a Prompt . . . . . . . . . . . . . . . . . . . . . . . . 323

viii IBM Cognos Report Studio Version 10.2.1: User Guide

Customize Prompt Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323Specify Prompt Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324Add a Prompt Button . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324Create a Cascading Prompt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325

Control the Data That Appears in a Tree Prompt . . . . . . . . . . . . . . . . . . . . . . 326Using in_range Filters with Character Data . . . . . . . . . . . . . . . . . . . . . . . . 326Showing prompt values in generated SQL or MDX . . . . . . . . . . . . . . . . . . . . . . 326

Chapter 12. Laying Out a Report . . . . . . . . . . . . . . . . . . . . . . . . 329Report Layout Recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . 329The Page Structure View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329Copy Object Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330Add a Header or Footer to a Report or List . . . . . . . . . . . . . . . . . . . . . . . . 331Add Borders to an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332Add a Text Item to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332Specify the Font for a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333Insert an Image in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 333

Insert a Background Image in an Object . . . . . . . . . . . . . . . . . . . . . . . . 334Add Background Effects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334

Add background effects to a chart . . . . . . . . . . . . . . . . . . . . . . . . . . 335Add a background gradient to a page . . . . . . . . . . . . . . . . . . . . . . . . . 335Add a drop shadow to a container . . . . . . . . . . . . . . . . . . . . . . . . . . 336

Insert a Formatting Object in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . 336Elements Supported in Rich Text Items . . . . . . . . . . . . . . . . . . . . . . . . . 338Example - Add a Multimedia File to a Report . . . . . . . . . . . . . . . . . . . . . . 338

Align an Object in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339Using a table to control where objects appear . . . . . . . . . . . . . . . . . . . . . . . 339

Apply a Table Style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340Apply Padding to an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341Set Margins for an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342Add Multiple Items to a Single Column . . . . . . . . . . . . . . . . . . . . . . . . . 342

Example - Create a Report with Multiple Items in One Column . . . . . . . . . . . . . . . . 342Reuse a Layout Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344

Change a Reused Object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345Update Reused Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346

Specify text and container direction . . . . . . . . . . . . . . . . . . . . . . . . . . . 346Specify Line Spacing and Breaking . . . . . . . . . . . . . . . . . . . . . . . . . . . 348Specify the Height and Width of an Object . . . . . . . . . . . . . . . . . . . . . . . . 348Control How Other Objects Flow Around an Object . . . . . . . . . . . . . . . . . . . . . 349Specify Report Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350Create and Modify Report and Object Styles . . . . . . . . . . . . . . . . . . . . . . . . 350

Modify the report style . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351Modify object styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351(Don't Print) Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 352Modify Classes to Format Query Studio Reports . . . . . . . . . . . . . . . . . . . . . 352Modifying the Default Layout Style Sheet . . . . . . . . . . . . . . . . . . . . . . . . 353

Add Color to an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353

Chapter 13. Working With Your External Data . . . . . . . . . . . . . . . . . . 355Preparing to Work with your External Data . . . . . . . . . . . . . . . . . . . . . . . . 357Import Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358Map Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359Finish Importing Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360Publish the Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Edit Your External Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361Delete Your External Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362Running a Report That Contains External Data . . . . . . . . . . . . . . . . . . . . . . . 363Making your Reports Public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Contents ix

Chapter 14. Using Conditions . . . . . . . . . . . . . . . . . . . . . . . . . 365Highlight Data Using a Conditional Style . . . . . . . . . . . . . . . . . . . . . . . . . 365

Create a New Conditional Style . . . . . . . . . . . . . . . . . . . . . . . . . . . 366Reuse an Existing Conditional Style . . . . . . . . . . . . . . . . . . . . . . . . . . 367Create an Advanced Conditional Style . . . . . . . . . . . . . . . . . . . . . . . . . 368Manage Conditional Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368Example - Add a Conditional Style to an Existing Report. . . . . . . . . . . . . . . . . . . 368

Highlight Data Using a Style Variable . . . . . . . . . . . . . . . . . . . . . . . . . . 369Adding Conditional Rendering to a Report . . . . . . . . . . . . . . . . . . . . . . . . 370

Add a Variable from the Condition Explorer . . . . . . . . . . . . . . . . . . . . . . . 370Add a Variable from the Properties Pane . . . . . . . . . . . . . . . . . . . . . . . . 371Hide or Show an Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372Add Conditional Rendering . . . . . . . . . . . . . . . . . . . . . . . . . . . . 373Example - Create a Conditional Report . . . . . . . . . . . . . . . . . . . . . . . . . 373Add Multiple Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375Setting up a Multilingual Reporting Environment . . . . . . . . . . . . . . . . . . . . . 376Create a Multilingual Report in Report Studio . . . . . . . . . . . . . . . . . . . . . . 377

Chapter 15. Bursting Reports . . . . . . . . . . . . . . . . . . . . . . . . . 379Defining Burst Recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379

Create a Calculated Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379Creating the Burst Table in the Source Database . . . . . . . . . . . . . . . . . . . . . . 380Importing the Table into a Package . . . . . . . . . . . . . . . . . . . . . . . . . . 381

Specify a Burst Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381Set Burst Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382Enable Bursting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 383Creating Burst Reports Using Dimensional Data Sources . . . . . . . . . . . . . . . . . . . . 383Example - Burst a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384

Chapter 16. Format Data. . . . . . . . . . . . . . . . . . . . . . . . . . . . 387Set the Default Data Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387Specify the Data Format for an Object . . . . . . . . . . . . . . . . . . . . . . . . . . 388

Specifying the Number of Decimals in Numbers . . . . . . . . . . . . . . . . . . . . . 388Digit shaping in charts and maps. . . . . . . . . . . . . . . . . . . . . . . . . . . 388

Locale-sensitive Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390Suppress Empty Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391

Suppress Null Cells Using Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . 391Example - Suppress Zeros in Rows and Columns in an Existing Report . . . . . . . . . . . . . . 392

Specify what appears for data containers that contain no data . . . . . . . . . . . . . . . . . . 392Using Patterns to Format Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393

Pattern Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Date and Time Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394Decimal Format Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401

Chapter 17. Using Query Macros . . . . . . . . . . . . . . . . . . . . . . . . 403Syntax. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403Add a Query Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405Creating Prompts Using Query Macros . . . . . . . . . . . . . . . . . . . . . . . . . . 406

Examples - selecting country or region prompts . . . . . . . . . . . . . . . . . . . . . . 408Examples - creating prompts that use parameter maps . . . . . . . . . . . . . . . . . . . 410Examples - creating a multiple value prompt . . . . . . . . . . . . . . . . . . . . . . . 411

Chapter 18. Using Drill-through Access . . . . . . . . . . . . . . . . . . . . . 415Understanding Drill-through Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . 416

Drill-through Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416Selection Contexts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417Drilling Through to Different Report Formats . . . . . . . . . . . . . . . . . . . . . . 417Drilling Through Between Packages . . . . . . . . . . . . . . . . . . . . . . . . . . 418Bookmark References. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418Members and Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 418

x IBM Cognos Report Studio Version 10.2.1: User Guide

Member Unique Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419Conformed Dimensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420Business Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Mapped Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422Drilling Through on Dates Between PowerCubes and Relational Packages . . . . . . . . . . . . . 423

Set Up Drill-through Access in a Report . . . . . . . . . . . . . . . . . . . . . . . . . 423Create a parameter in the target . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424Create a drill-through definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . 425

Defining independent drill-through definitions for crosstabs. . . . . . . . . . . . . . . . . . 427Specify the Drill-through Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428Example - Drill Through to a Hidden Report from a Report Studio Report . . . . . . . . . . . . . . 429

Check the Target Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429Create and Test the Drill-Through Definition . . . . . . . . . . . . . . . . . . . . . . . 429

Try it yourself - create a report with drill-through access to itself . . . . . . . . . . . . . . . . . 431Drilling Through from IBM Cognos Series 7 to IBM Cognos BI. . . . . . . . . . . . . . . . . . 433

Setting Up Drill-through Access from IBM Cognos Series 7 Visualizer . . . . . . . . . . . . . . 434Setting Up Drill-through Access from PowerPlay Web . . . . . . . . . . . . . . . . . . . . 434Create and Test the Target for a Series 7 Report . . . . . . . . . . . . . . . . . . . . . . 434

Chapter 19. Working with Multiple Pages . . . . . . . . . . . . . . . . . . . . 437Add a Page to a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437Create a Page Break or Page Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Create simple page breaks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438Create advanced page sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

Join Nested Page Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439Example - Preparing a Product List Report . . . . . . . . . . . . . . . . . . . . . . . . 440Add a Bookmark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441Create a Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443

Example - Add a Table of Contents to a Report . . . . . . . . . . . . . . . . . . . . . . 444Insert Page Numbers in a Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446Control Page Breaks and Page Numbering . . . . . . . . . . . . . . . . . . . . . . . . 447Create Page Layers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449

Chapter 20. Creating Report Templates . . . . . . . . . . . . . . . . . . . . . 451Convert a Report to a Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451Create a New Template . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451

Chapter 21. Managing Existing Reports . . . . . . . . . . . . . . . . . . . . . 453Copy a Report to the Clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453

Copy a Report to the Clipboard in Internet Explorer . . . . . . . . . . . . . . . . . . . . 453Copy a Report to the Clipboard in Firefox . . . . . . . . . . . . . . . . . . . . . . . . 453

Open a Report from the Clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . 453Open a File from Another Studio . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454

Analysis Studio Query Specification . . . . . . . . . . . . . . . . . . . . . . . . . . 454Managing Changes in the Package . . . . . . . . . . . . . . . . . . . . . . . . . . . 458

Update a Name Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459Change the Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459

Chapter 22. Upgrading Reports. . . . . . . . . . . . . . . . . . . . . . . . . 461Upgrading Reports from IBM Cognos BI Version 8.4 . . . . . . . . . . . . . . . . . . . . . 461

Upgrading Report Styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461Upgrading Legacy Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462New Default for Hidden or Deleted Axis Titles . . . . . . . . . . . . . . . . . . . . . . 462Upgrading Reports with SAP BW Prompt Variables . . . . . . . . . . . . . . . . . . . . 462

Upgrading Reports from IBM Cognos BI Version 8.1 or 8.2 . . . . . . . . . . . . . . . . . . . 463Members Containing No Data Are Not Suppressed for SAP BW . . . . . . . . . . . . . . . . 463Thousands Separators Missing . . . . . . . . . . . . . . . . . . . . . . . . . . . 463RQP-DEF-0177 Error When Upgrading Reports . . . . . . . . . . . . . . . . . . . . . . 463

Upgrading Reports from IBM Cognos ReportNet . . . . . . . . . . . . . . . . . . . . . . 464

Contents xi

Undocumented and Unsupported Features . . . . . . . . . . . . . . . . . . . . . . . 464No Sort Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Layout Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Report Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Customized Style Sheets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464PDF Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464IF-THEN-ELSE Statements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 464Solve Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465Chart Behavior . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465Database Only Processing of Queries . . . . . . . . . . . . . . . . . . . . . . . . . 465Changes in the Behavior of Functions Between ReportNet 1.1 and IBM Cognos BI . . . . . . . . . . 465

Appendix A. Accessibility Features . . . . . . . . . . . . . . . . . . . . . . . 467Accessibility features in IBM Cognos Report Studio . . . . . . . . . . . . . . . . . . . . . 467Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467Considerations to Improve Report Accessibility . . . . . . . . . . . . . . . . . . . . . . . 468

Enable Accessible Report Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . 469Alternate text and summary text . . . . . . . . . . . . . . . . . . . . . . . . . . . 469Designate Cells Headers in Tables . . . . . . . . . . . . . . . . . . . . . . . . . . 471Headings and emphasis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471Prompt control labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472Example - Conditionally Show a List Below a Chart for an Accessible Report . . . . . . . . . . . . 473

IBM and accessibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475

Appendix B. Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . 477Problems Creating Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

Division by Zero Operation Appears Differently in Lists and Crosstabs . . . . . . . . . . . . . . 477Application Error Appears When Upgrading a Report. . . . . . . . . . . . . . . . . . . . 477Nested List Report Containing a Data Item That is Grouped More Than Once Does Not Run After Upgrade 477Background Color in Template Does not Appear . . . . . . . . . . . . . . . . . . . . . 478Subtotals in Grouped Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478Chart Labels Overwrite One Another . . . . . . . . . . . . . . . . . . . . . . . . . 478Chart Shows Only Every Second Label . . . . . . . . . . . . . . . . . . . . . . . . . 478Chart Gradient Backgrounds Appear Gray in Internet Explorer. . . . . . . . . . . . . . . . . 479Metadata Change in Oracle Essbase Not Reflected in Reports and in the Studios . . . . . . . . . . . 479Relationships Not Maintained in a Report With Overlapping Set Levels . . . . . . . . . . . . . . 479Summaries in Query Calculations Include Nulls with SAP BW Data Sources . . . . . . . . . . . . 480Creating Sections on Reports That Access SAP BW Data Sources . . . . . . . . . . . . . . . . 480Error Characters (--) Appear in Reports. . . . . . . . . . . . . . . . . . . . . . . . . 480Columns, Rows, or Data Disappear With SSAS 2005 Cubes . . . . . . . . . . . . . . . . . . 481Function Unreliable with Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482Searching for values might return unexpected results . . . . . . . . . . . . . . . . . . . . 482Report Differences Between TM1 Executive Viewer and IBM Cognos Business Intelligence with TM1 DataSources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482Order of Metadata Tree Differs for TM1 Data Sources . . . . . . . . . . . . . . . . . . . . 483MSR-PD-0012 error when importing external data . . . . . . . . . . . . . . . . . . . . . 483MSR-PD-0013 error when importing external data . . . . . . . . . . . . . . . . . . . . . 483

Problems Calculating Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483Unexpected Summary Values in Nested Sets . . . . . . . . . . . . . . . . . . . . . . . 483Null Results for Calculations Using SAP BW Data Sources . . . . . . . . . . . . . . . . . . 484Incorrect Results with IBM Cognos PowerCubes and Time Measures . . . . . . . . . . . . . . . 484Incorrect Results in Summaries When Using OLAP Data Sources . . . . . . . . . . . . . . . . 485

Problems Filtering Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486Unexplained Discrepancies in Number Calculations . . . . . . . . . . . . . . . . . . . . 486HRESULT= DB_E_CANTCONVERTVALUE Error When Filtering on a _make_timestamp Column . . . . . 488

Problems Running Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488Report Runs Slowly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488Summaries in a report do not correspond to the visible members . . . . . . . . . . . . . . . . 490Cannot Find the Database in the Content Store (Error QE-DEF-0288) . . . . . . . . . . . . . . . 493Parse Errors When Opening or Running an Upgraded Report . . . . . . . . . . . . . . . . . 493

xii IBM Cognos Report Studio Version 10.2.1: User Guide

Overflow Error Occurs When a Value in a Crosstab Is More Than 19 Characters . . . . . . . . . . . 493The ORA-00907 Error Appears When Running a Report . . . . . . . . . . . . . . . . . . . 493A Report or Analysis Does Not Run Because of Missing Items . . . . . . . . . . . . . . . . . 494Cannot View Burst Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494A report upgraded from ReportNet does not retain its original look . . . . . . . . . . . . . . . 495Measure Format Disappears in SSAS 2005 . . . . . . . . . . . . . . . . . . . . . . . . 495Drill-through Links are Not Active in the Safari Browser . . . . . . . . . . . . . . . . . . . 495Data Does Not Appear in a Target Report or the Wrong Data Appears . . . . . . . . . . . . . . 496A Running Total in Grouped Reports Gives Unexpected Results . . . . . . . . . . . . . . . . 496PCA-ERR-0057 Recursive Evaluation Error . . . . . . . . . . . . . . . . . . . . . . . 496Arithmetic Overflow Error When Running a Report in PDF Format . . . . . . . . . . . . . . . 497RQP-DEF-0177 An error occurred while performing operation 'sqlPrepareWithOptions' status='-69'UDA-SQL-0043 Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497Unable to View Active Reports in Mozilla Firefox . . . . . . . . . . . . . . . . . . . . . 498Problems with viewing saved Active Report output in Mozilla Firefox 8 or later versions . . . . . . . . 498Problems with large SAP BW queries . . . . . . . . . . . . . . . . . . . . . . . . . 498Master Detail or Burst Reports with Charts or Crosstabs May Result in Denial of Service . . . . . . . . 499PCA-ERR-0087 error when you run a large report . . . . . . . . . . . . . . . . . . . . . 499Differences in the appearance of charts that are run in different formats or on different operating systems . . 499Out-of-memory errors with reports that are run in interactive HTML format . . . . . . . . . . . . 500Charts in PDF Output Show Unexpected Results . . . . . . . . . . . . . . . . . . . . . 501Result set of a multi-fact query contains blanks . . . . . . . . . . . . . . . . . . . . . . 501Cognos Statistics object is not displayed in a report . . . . . . . . . . . . . . . . . . . . 501

Problems When Drilling Through . . . . . . . . . . . . . . . . . . . . . . . . . . . 502Cannot Drill Through Between PowerCubes Because MUNs Do Not Match . . . . . . . . . . . . 502Unexpected or Empty Results When Drilling Through. . . . . . . . . . . . . . . . . . . . 503Cannot Drill Through From a Relational Source to a Cube . . . . . . . . . . . . . . . . . . 504Calculations Do Not Appear in the Target Report . . . . . . . . . . . . . . . . . . . . . 505Nested Crosstab Only Filters on Some Items . . . . . . . . . . . . . . . . . . . . . . . 505Data is Not Filtered in the Target Report After Drill-Through . . . . . . . . . . . . . . . . . 505Drill-through links in active reports do not work . . . . . . . . . . . . . . . . . . . . . 506

Appendix C. Sample Reports and Packages . . . . . . . . . . . . . . . . . . . 507The Sample Outdoors Company . . . . . . . . . . . . . . . . . . . . . . . . . . . . 507

The Sample Outdoors Group of Companies . . . . . . . . . . . . . . . . . . . . . . . 507Employees . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509Sales and marketing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509Sample Outdoors database, models, and packages . . . . . . . . . . . . . . . . . . . . . 510

Samples in the Sample Outdoors Sales (cube) package. . . . . . . . . . . . . . . . . . . . . 512Consecutive Periods Comparison . . . . . . . . . . . . . . . . . . . . . . . . . . . 512

Samples in the Sales and Marketing (Cube) Package . . . . . . . . . . . . . . . . . . . . . 512Actual vs. Planned Revenue . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512Historical Revenue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Revenue by Date Range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Revenue by Product Brand (2011) . . . . . . . . . . . . . . . . . . . . . . . . . . 513Same Month Prior Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513Selected Retailer Country or Region . . . . . . . . . . . . . . . . . . . . . . . . . . 514Top Retailers by Country or Region . . . . . . . . . . . . . . . . . . . . . . . . . . 514

Samples in the GO Data Warehouse (analysis) Package . . . . . . . . . . . . . . . . . . . . 514Budget vs. Actual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Core products results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514Customer Returns and Satisfaction . . . . . . . . . . . . . . . . . . . . . . . . . . 515Employee Satisfaction 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515Employee Training by Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515Eyewear Revenue by Brand and Size . . . . . . . . . . . . . . . . . . . . . . . . . 516Global Bonus Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 516GO Balance Sheet as at Dec 31 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . 516Sample Outdoors Company Balance Sheet as at Dec 31 2012 . . . . . . . . . . . . . . . . . 517Manager Profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517New order methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517Planned Headcount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Contents xiii

Positions to Fill . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517Promotion Plan Revenue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Promotion Success. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Quantity Sold vs. Shipped and Inventory . . . . . . . . . . . . . . . . . . . . . . . . 518Recruitment Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518Return Quantity by Order Method . . . . . . . . . . . . . . . . . . . . . . . . . . 519Returned Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 519Returns by Damage, Failed Orders and Complaints in 2012 . . . . . . . . . . . . . . . . . . 519Returns by Failed Orders in 2012 . . . . . . . . . . . . . . . . . . . . . . . . . . . 519Returns by Order Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520Returns by Order Method - Prompted Chart . . . . . . . . . . . . . . . . . . . . . . . 520Revenue by GO Subsidiary 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . . 520Sales Commissions for Central Europe . . . . . . . . . . . . . . . . . . . . . . . . . 521Sales Growth Year Over Year . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Sales target by region. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Succession Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521Top 10 Retailers for 2011. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521

Samples in the GO Data Warehouse (query) Package . . . . . . . . . . . . . . . . . . . . . 522Advertising-cost vs revenue . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Bursted Sales Performance Report . . . . . . . . . . . . . . . . . . . . . . . . . . 522Employee Expenses (report) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Health Insurance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522Pension Plan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Regular Salary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523TOC Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523Total Revenue by Country or Region . . . . . . . . . . . . . . . . . . . . . . . . . 523

Samples in the GO Sales (analysis) Package . . . . . . . . . . . . . . . . . . . . . . . . 5232011 Quarterly Sales Forecast . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5232011 Sales Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

Samples in the GO Sales (query) Package . . . . . . . . . . . . . . . . . . . . . . . . . 524Active Report Techniques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Briefing Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Film strip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524Horizontal Pagination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Matrix-chart and graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Order Invoices - Donald Chow, Sales Person . . . . . . . . . . . . . . . . . . . . . . . 525No Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525PDF Page Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525Product details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Sales analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Sales Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Singletons on Page Body . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526

Interactive Samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526Bursted Sales Performance Report . . . . . . . . . . . . . . . . . . . . . . . . . . 526Percentage Calculation (by year) . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Recruitment Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Revenue by GO Subsidiary 2011 . . . . . . . . . . . . . . . . . . . . . . . . . . . 527Rolling and Moving Averages . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Top 10 Retailers for 2011. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

Prompt API samples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Clear prompt selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Date prompt presets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528Display all prompt values ignoring user selections . . . . . . . . . . . . . . . . . . . . . 528Display user selected prompt values. . . . . . . . . . . . . . . . . . . . . . . . . . 528Filter country by letter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Limit date prompt selection by database value . . . . . . . . . . . . . . . . . . . . . . 529Limit numeric prompt selection by database value . . . . . . . . . . . . . . . . . . . . . 529Limit time between two dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Limit user selection to two items . . . . . . . . . . . . . . . . . . . . . . . . . . . 529Pass parameter via hidden prompt . . . . . . . . . . . . . . . . . . . . . . . . . . 529

xiv IBM Cognos Report Studio Version 10.2.1: User Guide

Personal default prompt selections - set selections . . . . . . . . . . . . . . . . . . . . . 529Personal default prompt selections - use selections . . . . . . . . . . . . . . . . . . . . . 529Validate prompt values when button pushed . . . . . . . . . . . . . . . . . . . . . . . 529Validate type-in postal code values . . . . . . . . . . . . . . . . . . . . . . . . . . 529Validate type-in product line code . . . . . . . . . . . . . . . . . . . . . . . . . . 529

Appendix D. Limitations when using dimensional data sources. . . . . . . . . . . 531Running a Report Against a Dimensional Data Source. . . . . . . . . . . . . . . . . . . . . 531Limitations When Using Set Expressions in List Reports . . . . . . . . . . . . . . . . . . . . 532Limitations When Using Clauses in Summary Functions . . . . . . . . . . . . . . . . . . . . 532Limited Support for Relational Functions When Used with OLAP Data Sources . . . . . . . . . . . . 533Limitations When Summarizing Measures in DMR Data Sources . . . . . . . . . . . . . . . . . 534Limitations When Filtering Dimensional Data Sources . . . . . . . . . . . . . . . . . . . . . 534

Error Characters (--) When Filtering . . . . . . . . . . . . . . . . . . . . . . . . . . 535Limitations When Specifying the Scope of Summary Filters with Dimensional Data Sources . . . . . . . 535Limitations When Filtering Data Using an SAP BW Data Source . . . . . . . . . . . . . . . . 536

Considerations when Creating Calculations . . . . . . . . . . . . . . . . . . . . . . . . 537Calculation Solve Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537Length of Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537Quality of Service Indicators . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537Using Quotation Marks in Literal Strings . . . . . . . . . . . . . . . . . . . . . . . . 538Limitations of Calculations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538Creating Expressions Using SAP BW Data Sources . . . . . . . . . . . . . . . . . . . . . 538Using Microsoft Excel Functions with SSAS 2005 Data Sources . . . . . . . . . . . . . . . . . 539Concatenating Strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539Intersecting Calculations in Crosstabs and Charts . . . . . . . . . . . . . . . . . . . . . 539Null (Missing) Values in Calculations and Summaries . . . . . . . . . . . . . . . . . . . . 542Dimensional Coercion Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544Recommendation - Use Member Unique Name (MUN) Aliases . . . . . . . . . . . . . . . . . 547

Limitations When Formatting Empty Cells in SAP BW Data Sources . . . . . . . . . . . . . . . . 548

Appendix E. Limitations When Producing Reports in Microsoft Excel Format . . . . . 549Unable to Load Images from the IBM Cognos Business Intelligence Content Store in a Report . . . . . . . 549Blank Worksheet Appears . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549Warning Message Appears When Excel Opens an IBM Cognos Business Intelligence Report . . . . . . . . 549Spreadsheet Content Not Saved for Reports Saved in XLS Format . . . . . . . . . . . . . . . . . 549Unable to Load Excel Report in Netscape 7.01 . . . . . . . . . . . . . . . . . . . . . . . 550Unable to Nest Labels in Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Data Series Are Truncated . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Colors Different From Those in HTML or PDF . . . . . . . . . . . . . . . . . . . . . . . 550Repeating Pie Charts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Unable to Skip Discrete Axis Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . 550Unsupported IBM Cognos BI Formatting . . . . . . . . . . . . . . . . . . . . . . . . . 550Cells Contain Series of #. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Table and Column Widths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551Secure Socket Layer (SSL) Is Not Supported in Some Excel Formats and Versions . . . . . . . . . . . 551Number Formats Become Currency Formats in Japanese Excel . . . . . . . . . . . . . . . . . . 552Reports Show Data in Wrong Columns . . . . . . . . . . . . . . . . . . . . . . . . . . 552Unable to Access Reports on Remote Servers . . . . . . . . . . . . . . . . . . . . . . . . 552Drill-through Reports Are Not Supported in Excel . . . . . . . . . . . . . . . . . . . . . . 552Map Reports Are Not Supported in Excel . . . . . . . . . . . . . . . . . . . . . . . . . 552Unsupported Excel Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552Hyperlink Buttons Are Not Supported in Excel . . . . . . . . . . . . . . . . . . . . . . . 553Unable to View Reports in Excel Format Sent as Email Attachments . . . . . . . . . . . . . . . . 553Unsupported Chart Properties in Excel . . . . . . . . . . . . . . . . . . . . . . . . . . 553Unsupported Chart Types in Excel . . . . . . . . . . . . . . . . . . . . . . . . . . . 553Cell Height and Width Are Incorrect . . . . . . . . . . . . . . . . . . . . . . . . . . 554

Appendix F. Using the expression editor. . . . . . . . . . . . . . . . . . . . . 555Operators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

Contents xv

(. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555*. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555, . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555/ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555|| . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556+ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556-. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556< . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556-> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557>= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557and. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557auto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558contains . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558currentMeasure. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558distinct . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558else. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558end. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559ends with . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559for . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559for all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559for any . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559for report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560in_range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560is missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561is null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561is not missing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561is not null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561like . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562not . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562or . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562prefilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563rows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563starts with . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563then . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563when . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563Statistical functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563aggregate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573moving-average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 573moving-total. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574percentile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575quantile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

xvi IBM Cognos Report Studio Version 10.2.1: User Guide

quartile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576running-average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577running-count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578running-difference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578running-maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579running-minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579running-total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

Member Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581aggregate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581average . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581maximum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582median . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582minimum. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582percentile. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583quantile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583quartile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583rank . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583standard-deviation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583standard-deviation-pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584total . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584variance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584variance-pop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

Constants . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584date-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584time with time zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584timestamp with time zone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval year. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval year to month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval day to hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval day to minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval day to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval hour to minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval hour to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585interval minute to second . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585null . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

Constructs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586if then else . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586in_range . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586search case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587simple case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

Business Date/Time Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587_add_days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587_add_months . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588_add_years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588_age . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589_day_of_week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589_day_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

Contents xvii

_days_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589_days_to_end_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590_first_of_month. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590_last_of_month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590_make_timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591_months_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591_week_of_year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591_years_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592_ymdint_between . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592

Block Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592_firstFromSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592_remainderSet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

Aster Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593Aster Data String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593Aster Data Data Type Formatting. . . . . . . . . . . . . . . . . . . . . . . . . . . 595Aster Data Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595Aster Data Trigonometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598

DB2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598DB2 Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598DB2 Trigonometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600ceiling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 601day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602dayname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602dayofweek . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602dayofweek_iso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602dayofyear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603dec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603difference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604digits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604double. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604event_mon_state . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604float . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604hex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605hour . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605insert . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605integer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605int . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605julian_day . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606lcase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606left . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606locate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607long_varchar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607ltrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607microsecond . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607midnight_seconds . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608minute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

xviii IBM Cognos Report Studio Version 10.2.1: User Guide

monthname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609quarter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609radians . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609repeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610right . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610rtrim . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610second. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611sign . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611smallint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611soundex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611substr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612table_name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612table_schema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612timestamp_iso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613timestampdiff . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613to_char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614truncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614ucase . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614value . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615varchar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615year . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615

Greenplum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616Greenplum String . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616Greenplum Data type formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . 617Greenplum Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618Greenplum Trigonometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618ascii . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620chr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620current_database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620current_schema. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620{current_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620{session_user} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620translate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620date_trunc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 620version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

Informix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621Informix Math . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621Informix Trigonometry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621cardinality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622char_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622concat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623day. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623extend. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623hex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623initcap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624lpad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624mdy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624month . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624nvl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624octet_length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625

Contents xix

round . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625rpad . . . . . . . . . . . . . . . . . . . .