Chapter4: Working with Data
User Guide   121
Return quantity
Tip: You can find these items in the Orders and Products folders.
6. In the Insertable Objects pane, on the toolbox tab, drag Query Calculation to the right of 
Return quantity in the list.
7. In the Name box, type the following and click OK:
Time Interval
8. In the Expression Definition box, type the following and click OK:
[gosales_goretailers].[Orders].[Return date]-[gosales_goretailers].[Orders].[Order date]
9. From the Data menu, click Filters.
10.Click the add button.
11.In the Expression Definition box, type
[gosales_goretailers].[Orders].[Return date]-[gosales_goretailers].[Orders].[Order date] > 
?p1?
12.Click OK twice.
A parameterized filter is created that will return data when the difference between the return 
date and the order date is greater than the value specified by the user.
13.Pause the pointer over the page explorer button and click Prompt Pages.
14.In the Insertable Objects pane, drag Page to the Prompt Pages pane, and then double-click it.
15.In the Insertable Objects pane, on the toolbox tab, drag Interval Prompt to the work area.
The Prompt Wizard dialog box appears.
16.Click Use existing parameter, and then click p1.
17.Click Finish.
18.Run the report.
An interval prompt appears.
19.In the Days box, type a value and click Finish.
Tip: You can also type values for the Hrs and Mins boxes.
A list report appears, showing all products that were returned after the time interval you specified. 
For example, if you type 30 days, the list will show products that were returned more than 30 
days after the order date.
Add page number to pdf reader - insert pages into PDF file in C#.net, ASP.NET, MVC, Ajax, WinForms, WPF
Guide C# Users to Insert (Empty) PDF Page or Pages from a Supported File Format
adding a page to a pdf; add page numbers to a pdf document
Add page number to pdf reader - VB.NET PDF Page Insert Library: insert pages into PDF file in vb.net, ASP.NET, MVC, Ajax, WinForms, WPF
Easy to Use VB.NET APIs to Add a New Blank Page to PDF Document
add a page to a pdf file; add page number to pdf print
122    Report Studio
Chapter4: Working with Data 
Create a Parameter to Produce a Prompt
Report Studio can automatically generate prompted reports based on parameters you create. 
When you run the report, Report Studio can generate a prompt page for each parameter not 
associated to an existing prompt page, depending on whether the prompt run option (p.33) is 
selected or not.
You also define parameters when you want to create a drill-through report (p.164), and you can 
use parameters to define master-detail relationships (p.170).
Steps
1. Open the report that you want.
2. From the Data menu, click Filters
3. On the Detail Filters tab, click the add button. 
The Detail Filter dialog box appears.
4. In the Available Components box, click the source or data items tab to select the data item 
you want to use for the prompt:
To filter data based on data items not shown in the report, double-click a data item on the 
source tab.
To filter data that appears in the report but not necessarily in the model, such as 
calculations, double-click a data item on the data items tab.
The data item appears in the Expression Definition box.
5. In the Expression Definition box, type an operator after the data item, or select an operator 
from the functions tab.
The operator sets some of the default properties of the prompt. For example, if the operator is 
equals (=), users will be able to select only a single prompt value, and the prompt's 
Multi-Select property is set to No.
For more information about creating expressions, see "Using the Expression Editor"(p.223).
6. Type a name after the operator to define the prompt parameter. A question mark must 
precede and follow the name.
7. Click OK.
8. In the Usage box, click one of the following:
To create a required prompt, click Required.
To create an optional prompt, click Optional.
To specify not to use the prompt, click Disabled.
9. Click OK.
Create a Prompt Directly in a Report Page
You can add prompt controls directly in a report page instead of creating a prompt page.
Prompt controls that are added to report pages will not appear in the following:
saved reports
PDF reports
reports that are sent to users by email
scheduled reports
Prompt controls are by their very nature interactive. They are used to satisfy parameter values 
before running a report. As a result, prompt controls added to a report page only appear when 
you run the report in HTML format. When you run a report in HTML format, users select which 
values they want to see, and the report is refreshed, producing a new report.
For the non-interactive reports listed above, prompt parameter values must be collected and 
satisfied before the report is run. You provide the parameter values you want using the Run 
options tab in Cognos Connection. If you do not provide all the required values, the report will 
fail to run. You can access the Run options tab by clicking the set properties button for the report.
C# PDF insert text Library: insert text into PDF content in C#.net
pageIndex, The page index of the PDF page that will be 0
add page to pdf without acrobat; add page to pdf preview
C# PDF File Split Library: Split, seperate PDF into multiple files
If your page number is set as 1, then the two output PDF files will contains the first page and the later three pages Add necessary references:
add page pdf; add pages to pdf online
Chapter4: Working with Data
User Guide   123
If you are using the sample reports that come with Report Studio, the reports Consumer Trends, 
GO Media, Product Line by Year-prompt, and Sales Representative Contact List contain prompt 
controls on report pages.
Steps
1. Open the report that you want.
2. In the Insertable Objects pane, on the toolbox tab, drag a prompt control to the location 
where you want it to appear.
The Prompt Wizard dialog box appears.
3. Provide the information necessary to create the prompt.
Tip: Make the prompt optional by selecting the Make the filter optional check box. 
Otherwise, when you run the report for the first time, the prompt appears in a generated 
prompt page rather than in the report page. Alternatively, you can specify a default selection 
for the prompt (p.125).
4. In the work area, click the prompt.
5. In the Properties pane, set the Auto-Submit property to Yes
If you do not set the Auto-Submit property to Yes, the report will not refresh when users select 
a different prompt value.
Tip: An alternative to setting the prompt to auto-submit is to add a prompt button from the 
toolbox tab and setting its Type property to Finish.
The prompt control is added to the report page. You can modify its properties by clicking it and 
making changes in the Properties pane.
Modifying Prompts
For each prompt you create, you can modify its properties by specifying values in the Properties 
pane. For example, you can
change the prompt control interface
specify that a prompt requires user input
allow users to select multiple values
show or hide prompt status
specify default selections
specify prompt values
add a prompt button
create a cascading prompt
Some properties you set for a prompt may be overridden under some conditions. For example, 
some properties set for the filter associated with a prompt may override the corresponding prompt 
property.
Change the Prompt Control Interface
By default, when you create a prompt, Report Studio selects the prompt control interface. You can 
change the prompt control interface to something different, depending on the type of prompt you 
created. For example, for a value prompt, you can choose a drop-down list, a list box, or a radio 
button group.
Steps
1. Open the report that you want.
2. Click the prompt control you want to modify.
3. In the Properties pane, click the Select UI property and click the interface you want.
Specify That a Prompt Requires User Input
You can specify that a prompt requires user input before the report can run.
VB.NET PDF File Split Library: Split, seperate PDF into multiple
can split target multi-page PDF document file to one-page PDF files or PDF file to smaller PDF documents by every given number of pages Add necessary references
add a page to a pdf; add pages to pdf acrobat
C# PDF Text Search Library: search text inside PDF file in C#.net
Add necessary references: Description: Search specified string from all the PDF pages. eg: The first page is 0. 0
add pdf pages to word; adding page numbers to pdf document
124    Report Studio
Chapter4: Working with Data 
Steps
1. Open the report that you want.
2. Click the prompt control you want to modify.
3. In the Properties pane, click the Required property and click Yes.
4. Pause the pointer over the page explorer button and go to a report page.
5. From the Data menu, click Filters
6. Click the filter associated with the prompt.
7. In the Usage box, click Required and then click OK.
When you run the report, a star appears next to the prompt indicating that the user must select or 
type a value.
If you have a cascading prompt and the parent prompt control is required, the child prompt 
control is disabled. This ensures that users choose at least one value in the parent prompt before 
they can choose a value in the child prompt. Conversely, if the parent control is optional, then the 
child control is populated. This gives users the ability to choose values in the child prompt without 
having to choose a value in the parent prompt.
Allow Users to Select Multiple Values in a Prompt
You can allow users to select more than one value or a range of values in a prompt. For example, 
you have a prompt for which users must select a product line. You can modify the prompt so that 
users can select more than one product line.
If you enable multiple selections, the Auto-Submit property is always set to no.
Steps
1. Open the report that you want.
2. Click the prompt control that you want to modify.
3. In the Properties pane, choose whether to allow users to specify more than one value or a 
range of values:
To allow users to specify more than one value, set the Multi-Select property to Yes.
To allow users to specify a range of values, set the Range property to Yes.
4. Pause the point on the page explorer button and go to a report page.
5. From the Data menu, click Filters.
If you have more than one query defined in the report, you must first click an object linked to 
a query. If there is more than one query defined in the report, click an object that is linked to 
the query you want.
6. Double-click the filter associated with the prompt.
7. Change the operator to one of the following:
If you are creating a multi-select prompt, change the operator to 
in
.
For example, 
[gosales_goretailers].[Products].[Product_line] in ?Product 
line?
allows users to select multiple product lines.
If you are creating a range prompt, change the operator to 
in_range
.
For example, 
[gosales_goretailers].[Orders].[Margin] in_range ?Margin?
allows users to specify a margin range.
8. Click OK twice.
Show or Hide Prompt Status
Each prompt you create in a report provides dynamic validation when the report is run. Validity 
checks are performed to ensure that the data is correct, and that required values are supplied. For 
example, a star appears next to each required prompt. An arrow appears next to a prompt if you 
must select or type a value. If you type an incorrect value, a dotted line appears. You can choose 
whether to show the star and arrow for each prompt.
Steps
1. Open the report that you want.
C# PDF Text Highlight Library: add, delete, update PDF text
200F); annot.EndPoint = new PointF(300F, 400F); // add annotation to The string wil be highlighted from PDF file, 0
add page numbers to pdf preview; adding page numbers to a pdf in preview
C# PDF delete text Library: delete, remove text from PDF file in
Add necessary references: RasterEdge.Imaging.Basic.dll. matchString, The string wil be deleted from PDF file, -. 0
add pages to pdf in preview; add page numbers to a pdf
Chapter4: Working with Data
User Guide   125
2. Click the prompt control you want to modify.
3. In the Properties pane, click the Hide Adornments property and click Yes to hide the prompt 
characters or No to show them.
Specify a Default Selection for a Prompt
You can specify a default selection for a prompt so that users do not have to select or type a value 
when they run the report.
The values you specify must exactly match the corresponding values in the database. If you are 
specifying values for a date prompt control, you must type the value in the format Y-M-D when 
prompting a date column. When prompting a date-time column, type the value in the format 
Y-M-D hh:mm:ss.ms.
Steps
1. Open the report that you want.
2. Click the prompt control that you want to modify.
3. In the Properties pane, double-click the Default Selections property.
4. Click the add button, and then choose whether you want to define a single value or a range of 
values:
Click Simple Selection to define a single value.
Click Range Selection to define a range of values.
5. If you chose to define a single value, type the value you want as the default selection.
6. If you chose to define a range of values, type the minimum and maximum values of the range 
in the Minimum Value and Maximum Value boxes, respectively.
7. Click OK.
8. Repeat steps 4 to 6 to specify other default selections.
You can specify other default selections only if the Multi-Select property for the prompt is set 
to Yes.
9. Click OK.
Specify Prompt Values
Provide your own values in a prompt
to show something different from what is in the database
to improve performance by not accessing the database
to provide text for optional prompts, such as Select a value
to restrict the number of values available
For example, you have a prompt in which users choose a country. For the database value United 
States, you want USA to appear in the prompt.
Steps
1. Open the report that you want.
2. Click the prompt control that you want to modify.
3. In the Properties pane, double-click the Static Choices property.
4. Click the add button. 
5. In the Use box, type the prompt value you want to add.
6. In the Display box, type the value that will appear in the prompt.
7. Click OK.
8. Repeat steps 4 to 7 to add other prompt values.
9. If you want to link a prompt value to a condition (p.155), do the following:
Click the Variable drop-down list and choose the variable you want to use or create your 
own.
For information about creating variables, see "Add a Variable"(p.153).
Click the Value drop-down list and click one of the possible values for the variable.
C# PDF File & Page Process Library SDK for C#.net, ASP.NET, MVC
XImage.Barcode Reader. XImage.Barcode Generator. Highlight Text. Add Text. Add Text Box. Drawing Markups. PDF Print. Please note that, PDF page number starts from
add page pdf reader; add page numbers to a pdf in preview
C# PDF Page Delete Library: remove PDF pages in C#.net, ASP.NET
Add necessary references: RasterEdge.Imaging.Basic.dll. 0
adding page numbers to pdf in reader; add page number to pdf online
126    Report Studio
Chapter4: Working with Data 
Click the static value you want to link to the variable and click the edit button. 
In the Display box, type the value that you want to appear in the prompt for that 
particular value of the variable.
Repeat this procedure for each additional value.
10.Click OK.
Add a Prompt Button
Add prompt buttons so that users can submit selected items, cancel a report, or navigate between 
pages.
When you are building prompts and prompt pages (p.118), you may have to add a prompt 
button to submit selections. Some prompt controls, such as the value prompt, can be set to submit 
selections automatically. Other prompt controls, such as the date prompt, require a prompt 
button.
Steps
1. Open the report that you want.
2. Pause the pointer over the page explorer button and click the report or prompt page that 
contains the prompt control for which you want to add a prompt button.
3. In the Insertable Objects pane, on the toolbox tab, drag Prompt Button to the work area.
4. Click the prompt button and in the Properties pane, click the Type property. Choose one of 
the following actions.
Create a Cascading Prompt
Create a cascading prompt to use values from one prompt to filter values in another prompt. For 
example, a report contains the columns Product line and Product type. You create prompts for 
these columns, and you specify that the Product type prompt is a cascading prompt that uses 
Product line as the cascading source. When users select a product line, they see only the product 
types related to the selected product line.
Steps
1. Open the report that you want.
2. If you want to make the cascading source a required prompt, click it and in the Properties 
pane, set the Required property to Yes.
3. Click the prompt control that you want to use as a cascading prompt.
4. In the Properties pane, double-click the Cascade Source property.
5. Click the parameter that represents the cascade source, and click OK.
6. If the prompt allows users to select multiple values, add a prompt button to the cascade 
source to provide the cascading prompt with the appropriate values:
In the Insertable Objects pane, on the toolbox tab, drag Prompt Button to the report.
Click the prompt button and in the Properties pane, click the Type property and click 
Reprompt.
Goal
Action
Cancel the report
Cancel
Go to the previous prompt page
Back
Go to the next prompt page
Next
Run the report
Finish
Reprompt the user
Tip: Reprompting users is useful when you have cascading 
prompts.
Reprompt
Chapter4: Working with Data
User Guide   127
If you want to change the text in the prompt button, in the Insertable Objects pane, on 
the toolbox tab, drag Text Item to the prompt button and type the text you want.
For more information about how to create cascading prompts, see the Report Studio Tour.
Control the Data That Appears in a Tree Prompt
You can control what data appears in a tree prompt and how the data is structured to get the 
results that you want. To do this, you add various functions to the filter expression.
In addition, the operator that you chose in the Prompt Wizard dialog box (p.118) controls what 
appears next to each prompt value. If the operator is in or not in, check boxes appear next to each 
prompt value. If the operator is equals (=), no check boxes appear.
Steps
1. Open the report that you want.
2. Pause the pointer over the query explorer button and click the query that is associated with 
the prompt.
3. In the Data Items pane, double-click the data item that you are prompting on.
4. In the Expression Definition box, type one of the following functions and click OK.
Working with Queries
Queries specify what data appears in the report. In Report Studio, you create and modify queries 
using Query Explorer. Query Explorer provides an alternative way to modify existing reports or 
author new reports. You can use Query Explorer to perform complex tasks and other tasks that 
are more difficult to do in the report layout. For example, use Query Explorer to
improve performance by changing the order in which items are queried from the database
view or add filters and parameters, and modify their properties
view or add dimensions, levels, and facts
incorporate SQL statements that come from other reports or reports that you write
create complex queries using set operations and joins
Relating Queries to Layouts
Queries and layouts work together. After you decide the type of data that you need, you must 
create a layout in which to show the results. Each column of data must be both selected for the 
query, and shown in a layout unless there are some columns that you don’t want to show. The 
query and layout portions of a report must be linked to produce a valid report.
Goal
Function
Show the hierarchical structure of all members in the 
hierarchy. If this function is not used, all members are 
shown in a flat list. 
rootmembers(data_item)
Show the descendants of the data item in a hierarchical 
structure, where x represents the level. For example, if you 
are prompting on the Year hierarchy, and x=1, you will see 
2004, 2005, and 2006 in the tree. If x=2, you will see 2004 
Q1, 2004 Q2, and so on.
descendants(rootmembers(da
ta_item, x)
Show the children of a member. For example, 2004 Q1, 
2004 Q2, 2004 Q3, and 2004 Q4 appears for the member 
2004.
children(member)
128    Report Studio
Chapter4: Working with Data 
Report Studio automatically links query and layout. For example, when you use Report Studio 
and the list report template, query and layout are automatically linked. In addition, you can create 
a query and manually link it to a data container. In the layout, when you drag a data container to 
the work area, you can specify which query to use by clicking the Query property in the Properties 
pane. You then add the items in the query that you want to see in the layout by dragging them 
from the data items tab in the Insertable Objects pane.
Working with Dimensional Data Sources
When you are working with SAP BW data sources, you can use only a single hierarchy in a query.
Creating queries using a mix of OLAP and relational data is not supported. If you create queries 
using a database for which you do not know the type, consult your database administrator or 
modeler.
When performing multi-cube queries using dimensional data sources, the following restrictions 
apply:
Only basic operators (+, *, /,-) are available for cross-cube calculations.
Inner joins are not supported.
All joins for multi-cube queries are outer joins.
You cannot sort or filter on a conformed dimension (query subject).
Conformed dimensions are created in Framework Manager.
Viewing MDX using the Generated SQL/MDX query property may not show you the actual 
MDX that is executed. This is because when a multi-cube query is executed, a number of 
smaller queries are actually executed.
Add Queries to a Report
You can create multiple queries in Query Explorer to suit your particular needs. For example, you 
can create a separate query for each data container in a report to show different data.
Steps
1. Open the report that you want.
2. Pause the pointer over the query explorer button and click Queries.
3. In the Insertable Objects pane, drag one of the following objects to the work area. 
4. In the Properties pane, specify the properties you want.
For example, if you added a join, double-click the Join Relationships property to define the 
join.
5. Double-click a query.
6. In the Insertable Objects pane, on the source tab, drag data items that you want in the query 
to the Data Items pane.
Object
Description
Query
Adds a query.
Join
Adds a join relationship.
Union
Adds a union operator.
Intersect
Adds an intersect operator.
Except
Adds an except (minus) operator.
SQL
Adds SQL.
MDX
Adds MDX.
Chapter4: Working with Data
User Guide   129
Tip: You can add data items to the query that you do not want to appear in the layout. For 
example, if you want to filter on Product line code but you want users to see Product line in 
the layout, you must add both data items to the query.
7. If you want to create a new data item in the query, in the Insertable Objects pane, on the 
toolbox tab, drag Data Item to the Data Item pane.
8. If you want to add a filter, in the Insertable Objects pane, on the toolbox tab, drag Filter to 
the Detail Filters pane or to the Summary Filters pane, and define the filter expression 
(p.105).
Tip: You can also create a filter by dragging a data item from the source tab to the one of the 
filters panes and then completing the filter expression. If you are working with a dimensional 
data source, you can quickly filter data by dragging a member instead of the level to which the 
member belongs. For example, dragging the member 2006 from the Years level will filter data 
for the year 2006. This method is quicker than dragging the Years level and then completing 
the filter expression to specify to show data only for the year 2006.
When adding queries to the report
right-click the work area and click Show Package Sources to see the queries that use data 
items from a package
right-click the work area and click Expand References to see the relationships that exist 
between queries in the report, which is useful when you are creating complex queries
Create a Union Query
Create a union query to combine two or more queries into one result set.
You can combine queries that use different data sources. For example, you can combine a query 
that returns data from a dimensional data source with a query that returns data from a relational 
data source.
To combine two queries, the following conditions must be met:
The two queries must have the same number of data items.
The data types of the data items must be compatible and the data items must appear in the 
same order.
For numeric data types, integer, float, double, and decimal are compatible.
For string data types, char, varChar, and longVarChar are compatible.
For binary data types, binary and varBinary are compatible.
Date data types must match perfectly.
Steps
1. Open the report that you want.
2. Pause the pointer over the query explorer button and click Queries.
3. In the Insertable Objects pane, do the following:
Drag Query to the work area.
Drag Union, Intersect, or Except to the right of the query.
Two drop zones appear to the right of the operator.
Drag a Query object to each drop zone.
Two queries are created in the work area and a shortcut to each query appears in the drop 
zones.
4. Double-click each query that makes up the union query and add the data items that you want.
5. On the toolbar, press the back button to return to the Queries work area.
6. Click the set operator that you added in step 3.
7. In the Properties pane, click the Duplicates property and choose whether you want to remove 
or preserve duplicate rows.
8. Double-click the Projection List property.
The projection list shows the list of projected data items for the set operation.
130    Report Studio
Chapter4: Working with Data 
9. If you want Report Studio to automatically produce the list of projected data items, click 
Automatically generated.
Report Studio generates the projection list using only one of the two queries being unioned.
10.If you want to add, delete, move, or rename data items in the projection list, click Manual and 
make the changes you want.
11.Click OK.
12.Double-click the union query.
13.In the Insertable Objects pane, on the source tab, drag the data items that you want to add to 
the query to the Data Items pane.
The union query is complete. You can now link it to a data container in the layout.
Example - Create a Two-column List Report for Three Data Items
You are a report author at the Great Outdoors Company, which sells sporting equipment. You are 
requested to create a list report that shows revenue for all product lines and order methods. 
However, you want the product lines and order methods to appear in a single column. To create 
this report, you use a union query to join the Product line and Order method data items.
Steps
1. In the Cognos Connection Welcome page, click the Public Folders link.
2. Click the GO Sales and Retailers link, and then click the Report Studio link in the upper-right 
corner of the page.
3. In the Welcome dialog box, click Create a new report or template.
4. In the New dialog box, click Blank and click OK.
5. Pause the pointer over the query explorer button and click Queries.
6. In the Insertable Objects pane, do the following:
Drag Query to the work area.
Drag Union to the right of the query.
Two drop zones appear to the right of the operator.
Drag a Query object to each drop zone.
Query2 and Query3 are created in the work area, and a shortcut to each query appears in 
the drop zones.
7. Double-click Query2.
8. In the Insertable Objects pane, on the source tab, drag the following data items to the Data 
Items pane:
from the Products folder, Product line 
from the Orders folder, Revenue
9. In the Insertable Objects pane, on the toolbox tab, drag Data Item to the Data Items pane.
The data item will be used to sort product lines and order methods in the report.
10.In the Expression Definition box, type 'A' and click OK.
11.In the Properties pane, click the Name property, delete the default name, and type
Sort key
12.On the toolbar, press the back button to return to the Queries work area.
13.Double-click Query3.
14.In the Insertable Objects pane, on the source tab, drag the following data items to the Data 
Items pane:
Order method
Revenue
Tip: You can find these items in the Orders folder.
15.Repeat steps 9 to 11 to create a Sort key data item in Query3 with 'B' as its definition.
16.On the toolbar, press the back button to return to the Queries work area.
17.Click the Union operator.
Documents you may be interested
Documents you may be interested