Professional Documents
Culture Documents
GETTING STARTED
GETTING STARTED
TM
THE NEXT LEVEL OF PERFORMANCE
Product Information
(R)
This document applies to Cognos 8 Version 8.1 and may also apply to subsequent releases. To check for newer versions of this document,
visit the Cognos support Web site (http://support.cognos.com).
Copyright
Copyright (C) 2005 Cognos Incorporated.
Portions of Cognos(R) software products are protected by one or more of the following U.S. Patents: 6,609,123 B1; 6,611,838 B1; 6,662,188
B1; 6,728,697 B2; 6,741,982 B2; 6,763,520 B1; 6,768,995 B2; 6,782,378 B2; 6,847,973 B2; 6,907,428 B2; 6,853,375 B2.
Cognos and the Cognos logo are trademarks of Cognos Incorporated in the United States and/or other countries. All other names are
trademarks or registered trademarks of their respective companies.
While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or
technical inaccuracies may exist. Cognos does not accept responsibility for any kind of loss resulting from the use of information contained in
this document.
This document shows the publication date. The information contained in this document is subject to change without notice. Any
improvements or changes to either the product or the document will be documented in subsequent editions.
U.S. Government Restricted Rights. The software and accompanying materials are provided with Restricted Rights. Use, duplication, or
disclosure by the Government is subject to the restrictions in subparagraph (C)(1)(ii) of the Rights in Technical Data and Computer Software
clause at DFARS 252.227-7013, or subparagraphs (C) (1) and (2) of the Commercial Computer Software - Restricted Rights at
48CFR52.227-19, as applicable. The Contractor is Cognos Corporation, 15 Wayside Road, Burlington, MA 01803.
This software/documentation contains proprietary information of Cognos Incorporated. All rights are reserved. Reverse engineering of this
software is prohibited. No part of this software/documentation may be copied, photocopied, reproduced, stored in a retrieval system,
transmitted in any form or by any means, or translated into another language without the prior written consent of Cognos Incorporated.
Table of Contents
Introduction 5
Chapter 1: Cognos 8 7
Cognos Connection 7
Metric Studio 7
Query Studio 8
Analysis Studio 8
Report Studio 8
Event Studio 8
How Cognos 8 Works 9
Viewing and Organizing Content 10
Administration of Cognos 8 11
Security 11
Scheduling Content 12
The Software Development Kit 12
Integrating with Other Cognos Products 12
Chapter 2: Cognos 8 Examples 13
Example - Monitor Performance 13
Example - Run a Report 16
Example - Schedule a Report 18
Example - Create a Query 20
Example - Analyze Data 22
Example - Create a Report 25
Example - Manage an Event 30
Example - Create a Portal Page 33
Glossary 37
Index 41
Getting Started 3
4
Introduction
This document introduces the Cognos 8 architecture and provides examples to illustrate key
functionality.
Cognos 8 is an integrated business intelligence suite that provides a wide range of functionality to
help you understand your organization’s data.
For more information about using this product, visit the Cognos support Web site
(http://support.cognos.com). For information about education and training, click the Training
link from this site.
The following documents contain related information, and may be referred to in this document.
Note that the availability of the studios described in these documents depends on your licensing
permissions. To change your licensing permissions, see your administrator.
Document Description
Cognos Connection User Using Cognos Connection to view, schedule, create, and distribute
Guide reports
Metric Studio User Guide Authoring scorecard applications and monitoring the metrics within
for Authors them
Report Studio User Guide Authoring reports that analyze corporate data according to specific
needs
Event Studio User Guide Creating and managing processes that monitor data and perform
tasks when the data meets predefined thresholds
Cognos 8 Administration Managing servers, security, reports, and Cognos Portal Services;
and Security Guide setting up Cognos samples; and customizing Cognos 8
Online Help
All information is available in online help. Online help is available from the help button in a Web
browser, or the Help menu and help button in Windows products. You can also download the
online help from the Cognos support Web site (http://support.cognos.com).
Getting Started 5
Introduction
6
Chapter 1: Cognos 8
Cognos 8 is an integrated business intelligence suite that provides a wide range of functionality to
help you understand your organization’s data. Everyone in your organization can use Cognos 8 to
view or create business reports, analyze data, and monitor events and metrics so that they can
make effective business decisions.
Cognos 8 integrates the following business intelligence activities in one Web-based solution.
Activity Component
Publishing, managing, and viewing content Cognos Connection
Before you use Cognos 8, you should understand how each of the components that make up the
Cognos Series 8 user interfaces can help you do your job.
Depending on your licensing permissions, you may not have access to all the functionality
available in Cognos 8.
Cognos Connection
Cognos Connection is the Web portal for Cognos 8. It is the starting point to access the
functionality of Cognos 8. Use the portal to publish, find, manage, organize, and view your
organization’s business intelligence content, such as reports, scorecards, and agents. If you have
the necessary permissions, you can access the various studios from the portal and use the portal
for content administration, including scheduling and distributing reports, and creating jobs.
You view reports in Cognos Viewer, the report viewer.
System administrators also use the portal to administer servers, optimize performance, and set
access permissions.
For information about using Cognos Connection, see "Example - Run a Report" (p. 16),
"Example - Schedule a Report" (p. 18), and "Example - Create a Portal Page" (p. 33).
Metric Studio
Use Metric Studio to create a customized scorecarding environment to monitor and analyze
business metrics throughout your organization. It helps you translate your organization's strategy
into relevant, measurable goals that align each employee's actions and accountability with a
strategic plan.
Getting Started 7
Chapter 1: Cognos 8
The scorecarding environment of Metric Studio shows you quickly where your organization is
successful and where it needs improvement. It tracks performance against agreed targets and
indicates the current status so that decision makers at every level of the organization can react and
plan.
With Metric Studio, you are self-sufficient and can readily see how the organization is progressing
against its strategy. You can set priorities for your own actions and understand how your decisions
affect the performance of the company.
For information about using Metric Studio, see "Example - Monitor Performance" (p. 13).
Query Studio
Casual or novice users use Query Studio to create ad hoc reports that answer simple business
questions. Query Studio is an easy-to-use reporting tool.
With minimal steps, you can author basic reports, change the report layout, filter and sort data,
add formatting, and create charts.
When you use Query Studio, you interact directly with visible data.
For information about using Query Studio, see "Example - Create a Query" (p. 20).
Analysis Studio
Managers and business analysts use Analysis Studio to explore and manipulate data so that they
can analyze their business. Users can quickly analyze critical corporate data from any angle to
understand why business events occur, and then make effective decisions.
With analysis, it is possible to see trends and highlight exceptions that may not be evident with
other types of reporting. Analysis Studio users can explore large volumes of dimensional data.
When you use Analysis Studio, you interact directly with visible data.
For information about using Analysis Studio, see "Example - Analyze Data" (p. 22).
Report Studio
Report Studio is a report authoring tool that professional report authors and developers use to
create sophisticated and managed reports. With Report Studio, users can create any business
intelligence report that an organization requires, such as weekly sales and inventory reports.
Use Report Studio for reports that
• are intended for a wide audience
• exist long enough to require maintenance for changing requirements and data
• require detailed control over the appearance
Report Studio provides powerful functionality, such as bursting, prompts, and advanced charting,
and provides many ways to customize reports.
When you use Report Studio, data is not visible. You must run the report to view current data.
For information about using Report Studio, see "Example - Create a Report" (p. 25).
Event Studio
By using Event Studio, decision-makers in your organization can be notified of business events as
they happen so that they can make timely and effective decisions.
Use Event Studio to create agents that monitor status changes, priority customers, or any other
condition that is important to your business.
When an agent detects an event, tasks are performed, such as sending an email, adding
information to the portal, and running reports.
8
Chapter 1: Cognos 8
For information about using Event Studio, see "Example - Manage an Event" (p. 30).
5XQYLHZ
DQGPDQDJH
FRQWHQW &RJQRV 9LHZUHSRUWV
9LHZHU
0HWULF 0RQLWRUSHUIRUPDQFH
6WXGLR
4XHU\ &UHDWHTXHULHV
6WXGLR
&RJQRV
&RQQHFWLRQ $QDO\VLV $QDO\]HGDWD
6WXGLR
(YHQW 0RQLWRUHYHQWV
6WXGLR
5HSRUW &UHDWHUHSRUWV
6WXGLR
'DWDPRGHOLQJ
DQGSDFNDJLQJ
)UDPHZRUN 0HWULF
0DQDJHU 'HVLJQHU
&XVWRPHU
GDWDEDVHV
(1) In Framework Manager, the modeler ensures that metadata is presented in a manner that
business users can understand it. Modelers import the metadata from one or more databases,
and then add to the model to meet user requirements.
(2) In Metrics Designer, the modeler identifies the data items and calculations that form the
targets and actual results for each metric.
(3) The modeler then publishes and updates packages to Cognos Connection so that authors can
use them to create reports, agents, and scorecards.
(4) Business users and report authors use the published packages to understand their business
data.
(5) Users run, view, and manage their content in Cognos Connection. Depending on their
security permission they may be able to simply run and view reports or manage schedules,
portal layout, and other users’ permissions.
Getting Started 9
Chapter 1: Cognos 8
When you view or create a report, you are viewing and manipulating data stored in your
organization’s databases. The following diagram explains the steps involved in using Cognos 8.
For more information, see the Architecture and Planning Guide.
Report Specifications
When authors create a report, they are actually creating a report specification. The report
specification is an XML representation of the queries and prompts that are used to retrieve data,
as well as the layouts and styles used to present the data. For simplicity, the report specification is
called the report.
Report specifications can be useful to report authors for troubleshooting.
For information about working with report specifications, see the Report Studio User Guide and
the Cognos 8 Developer Guide.
Report Outputs
When a report is run, it contains the latest data from the data source. However, viewing the most
recent data may not always meet your needs. When you want to view older data, you save and
view the report output.
Report outputs are created when you schedule a report, when a report has multiple formats or
languages, when a report has a delivery method of save, print, or email, and when a report is
burst.
You can produce report outputs in the following formats:
• HTML
• PDF
• Excel
• delimited text (CSV)
• XML
10
Chapter 1: Cognos 8
If you are the owner of a report or have the necessary permissions, you can specify the default
format for each report. You can also specify how many report output versions to keep.
For more information, see the online help in Cognos Connection.
Drill-through Links
A report can contain drill-through links, also known as Go To links, so that you can easily open a
related report. A value in the report is linked to more detailed information in another report. For
example, a report includes sales information for each continent. When you click a continent name,
a more detailed report about sales for that specific continent opens.
When you view report data in Cognos Connection, Query Studio, and Analysis Studio, you may
also be able to drill down and drill up. When you drill down, you follow a link from one layer of
data to a more detailed layer within the same report. When you drill up, you access a less detailed
layer.
For more information, see the online help.
Portal Pages
In Cognos Connection, you can create your own custom portal pages. You use these portal pages
to view frequently-used content, to group related reports and folders, and to combine Cognos and
non-Cognos content within a single page. Within your portal pages, you can add Cognos portlets,
which you use to view and interact with your Cognos content.
If you have the necessary permissions, you can create public pages that other users and groups can
access and even use as their own. You can assign security permissions to allow only certain users
to access the pages.
For more information, see the online help in Cognos Connection.
Administration of Cognos 8
Cognos 8 administrators ensure that Cognos 8 runs smoothly and at its optimum performance.
They can
• define connections to the organization’s data sources
• define security permissions for users and groups in the organization
• specify distribution lists, contacts, and printers
• manage servers and dispatchers and fine-tune the performance of Cognos 8
• pre-define links for an entire package that authors can then easily add to their reports.
• customize the appearance and functionality of Cognos 8
For more information, see the Administration and Security Guide.
Security
Cognos 8 is secured by setting permissions and enabling user authentication. If anonymous access
is enabled, you can use Cognos 8 without authenticating as a specific user.
Getting Started 11
Chapter 1: Cognos 8
In Cognos 8, administrators define permissions so that users can access functionality. For
example, to edit a report using Report Studio, you must have the appropriate security and
licensing permissions.
In addition, each entry in Cognos Connection is secured to define who can read, edit, and execute
the entry.
For more information, see the online help in Cognos Connection.
Scheduling Content
You can schedule most content that appears in Cognos Connection to run at a time that is
convenient for you.
You can schedule
• reports
• metrics
• metrics data refreshes
• agents
• deployments
You can also create jobs to schedule multiple entries together.
For more information, see the online help in Cognos Connection.
12
Chapter 2: Cognos 8 Examples
To give you a quick idea of how to use the different functionality of the various Cognos 8
components, we set up some examples to show you how to run and modify reports, analyze data,
create agents, and monitor metrics. These examples show how to do the following:
• monitor the performance of your business in Metric Studio(p. 13)
• run a report in Cognos Connection (p. 16)
• schedule a report in Cognos Connection (p. 18)
• create a query in Query Studio (p. 20)
• analyze data in Analysis Studio (p. 22)
• create a report in Report Studio (p. 25)
• manage an event in Event Studio (p. 30)
• create a portal page in Cognos Connection (p. 33)
You can do any of these examples without having to do them all. For example, you can start with
the Analysis Studio example without doing the previous examples.
Before you experiment with a data source of your own, we recommend that you try these
examples using the sample data.
Cognos Samples
Before you can work through these examples, ensure that the Cognos samples are set up. They
show a good cross section of reports that you can create using Cognos 8.
For more information, contact your administrator or see the Administration and Security Guide.
The sample databases shipped with Cognos 8 contain data from the operations of a fictional retail
company, The Great Outdoors. The Great Outdoors sells camping and sports equipment directly
in retail stores across the world, and through other manufacturers.
Getting Started 13
Chapter 2: Cognos 8 Examples
Things to Notice
Metrics appear as either Poor (red), Average (yellow), or Excellent (green).
For each metric, you can see whether the trend is getting better or getting worse.
When you move your pointer over the title of a metric, you see a history chart that shows the
performance of the metric.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. In Cognos Connection, open Metric Studio and select the GO Metrics package.
3. Explore the scorecard:
• On the left pane, click Scorecards.
• Expand the Corporate and Distribution scorecards.
• Click each of the sales territory to view the metric related to return quantity.
You notice that in the Asia Pacific scorecard, the Return quantity-Asia Pacific-Returns metric
has the worst performance and its variance values appear in red.
4. Click the Asia Pacific - Return Quantity % metric and then click List.
You see the actual and target values for the metric data for previous periods. You also see
quarterly and yearly summaries.
14
Chapter 2: Cognos 8 Examples
Getting Started 15
Chapter 2: Cognos 8 Examples
Things to Notice
The icon for a report shows the default format and default action of the report.
Reports that have saved outputs have an additional icon in the Actions column.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
16
Chapter 2: Cognos 8 Examples
2. In Cognos Connection, open Public Folders, click the Great Outdoors Company package, and
then click Query Studio Report Samples.
3. Locate the Returns by Product Line Chart.
Tip: The icons beside an entry identify its default action and format. The default format for
this report is HTML and the default action is to run the report.
4. Click the report name to run the report.
The report runs and opens with the latest data about product returns.
You notice that Camping Equipment products have the highest number of returns. You want
to drill down to obtain more detailed information.
5. Click the Camping Equipment area in the pie chart to drill down to more detailed
information.
Tip: You can also drill down by right-clicking the pie area, by clicking the drill down button
on the toolbar, or by clicking the legend label.
At a quick glance, you notice that lanterns have the highest number of returns.
6. Drill down on Lanterns.
Getting Started 17
Chapter 2: Cognos 8 Examples
You notice that the EverGlow Lamp has the highest number of returns.
7. On the toolbar, click the home or return button to return to the portal.
18
Chapter 2: Cognos 8 Examples
Things to Notice
When a report runs according to a schedule, the report output is saved.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Locate the Returns by Product Type Chart report that you ran in the previous exercise.
Tip: You can find it in Public Folders > Great Outdoors Company > Query Studio Sample
Reports. You can also use any one of the Cognos sample reports.
3. Create a report view for a daily view of the report:
• In the Actions column, click the report view button next to the report.
• In the Name box, remove the words Report View of from the beginning of the name, type
(Daily) at the end of the name, and then click Finish.
A new entry appears in Cognos Connection, with the report view icon.
4. Schedule the report view to run daily:
• For the entry, in the Actions column, click the schedule button.
• Under Frequency, click By Day.
• Accept the default time and other defaults.
• Click OK.
5. Check the schedule:
• In Cognos Connection, click the Tools menu and click Schedule Management.
• Click the Schedule tab.
• In the Scope box, select Any and click Apply.
Your report appears in the list of scheduled reports.
Getting Started 19
Chapter 2: Cognos 8 Examples
Things to Notice
Data that can be added to the report has a different icon depending on what type of data it is.
The reports that you create in Query Studio can be viewed and edited in Report Studio.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Open Query Studio and select the Great Outdoors Company package.
A blank report appears.
3. Add columns to the report:
• From the Menu, click Insert Data.
• Expand Products, double-click Product type and then double-click Product name to add
them to the report.
• Expand Measures and double-click Quantity sold to add it to the report.
• Expand Other Measures and add Returns and Unit cost to the report.
The item Unit cost will not appear in the final report, but you need it to build a
calculation.
4. Create a calculation to show the lost revenue (Returns * Unit cost = Lost revenue):
• In the working area, click the heading for Unit cost and Ctrl+click the heading for the
Returns column.
• Click the calculate button.
• In the Operation box, click * (multiplication).
• In the New item name box, type Lost revenue.
• Click Insert.
• Delete the Unit cost column.
5. Format the calculated column that you added:
• Right-click the heading for the Lost revenue column and click Format Data.
• In the Category list, click Currency.
• In the Thousands separator list, click Yes, and then click OK.
20
Chapter 2: Cognos 8 Examples
The cells with a lost revenue greater than $20,000 appear with a red background.
9. Apply a template to the report:
• From the Change Layout menu, click Apply Template.
• Select Apply a template and click Select a template.
• In Public Folders, click Query Studio Templates, QS Template 1, and click OK twice.
The report appears with the styles from the template.
10. Add a title to the report:
• Above the report, click Title.
• In the Title box, type Returns by Product Type and click OK.
11. Save the report as Returns by Product Type.
The final report looks like this.
Getting Started 21
Chapter 2: Cognos 8 Examples
You notice that the EverGlow Lamp and Firefly Lite lanterns are the products that have the
highest return rate.
22
Chapter 2: Cognos 8 Examples
You will create an analysis that looks like the Analysis Studio sample % Returned by Product in
the Great Outdoors Company sample package.
To perform this exercise, you must have the appropriate licensing and security permissions.
Things to Notice
The items and measures that you can add to your analysis appear in the data tree in the left pane.
The overview area above the work area is a convenient place to quickly explore and change the
contents of your analysis. You manipulate rows and columns, drill up or down, and provide
context for the work area.
Analysis Studio uses sets, which are collections of similar data. You manipulate data by applying
actions to sets. You can sort, filter, and nest sets. You can also save custom sets and view subtotals
for your sets.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Open Analysis Studio.
3. Click the Great Outdoors Company package and click OK.
4. Insert data in the crosstab:
• In the Insertable Objects pane, expand Measures and Other measures, and drag Returns
to either the cell in the upper-left corner of the work area or in the middle of the work
area.
• Insert Products in the Columns zone.
• Expand the Retailer folder and insert Retailer in the Rows zone.
You now see the number of product lines that each retailer category returned.
By default, only five rows and columns are shown. The More subtotal is the sum of the values
that are not visible in the work area and that still meet any filter criteria.
Getting Started 23
Chapter 2: Cognos 8 Examples
24
Chapter 2: Cognos 8 Examples
Getting Started 25
Chapter 2: Cognos 8 Examples
You will create a report that looks like the Report Studio sample Returns by Order Method -
Prompted Chart in the GO Sales sample package
To perform this exercise, you must have the appropriate licensing and security permissions for this
functionality.
Things to Notice
When you use Report Studio, data is not live. You must run the report to view data.
You can view the XML report specification.
You can add multilingual capabilities.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Open Report Studio.
3. Click the GO Sales package.
4. Click Open an existing report or template, double-click GO Template Samples, click GO
Crosstab, and click Open.
5. Insert data in the crosstab zones:
• In the Insertable Objects pane, expand GO Sales, Returned items, Return reason and
Return reason.
• Insert Return reason in the Columns zone.
• In the Insertable Objects pane, expand Returned items.
• Insert Return quantity in the Measures zone.
• In the Insertable Objects pane, expand Inventory, Product, and Product.
• Insert Product line in the Rows zone.
6. Click the run report button to run your report and verify the content.
The report output appears in Cognos Viewer.
Tip: To return to Report Studio, close the Cognos Viewer Web browser.
26
Chapter 2: Cognos 8 Examples
Getting Started 27
Chapter 2: Cognos 8 Examples
9. Create a filter to exclude the Wrong product ordered return reason from the crosstab:
• In the crosstab, click the Return reason column heading.
• On the toolbar, click the filter button.
• Click the Detail Filters tab.
• Click the add button.
• Define the following expression:
[[Return reason] not in ([Returned items].[Return reason].[Return reason].[Return
reason]->[all].[3])
Tip: Insert items from the Available Components pane. The value 3 is the code for the
Wrong product ordered return reason.
• Click the validate button to validate your expression.
• Click OK twice.
10. Create a prompt page for the order method to allow users to filter data in the report and
retrieve data only for the order method they select:
• Click the background of the work area to deselect.
• From the Tools menu, click Build Prompt Page.
• Remove the Back and Next buttons and the prompt page title (Double-click to edit text)
that are automatically created.
• In the Insertable Objects pane, click the toolbox tab.
• Click the Value Prompt object and drag it in the prompt page.
The Prompt Wizard dialog box appears.
• Click Next.
• Beside the Package item box, click the ellipsis button (...).
• In the Choose Package Item dialog box, expand Sales, and Order method twice.
• Click the lowest-level Order method and then click OK.
• Click Next.
• Select the check box for Query 1 and Query 2 and then click Next.
By selecting both queries, the prompt will apply to the crosstab (Query 1) and the chart
(Query 2) in the report.
• Click Finish.
28
Chapter 2: Cognos 8 Examples
11. Move the cursor over the Page Explorer between the Insertable Objects pane and the work
area, and click Page1 under Report Pages to return to the report page.
Tip: Click the folder title (Prompt Pages) to remove or rename a page or to edit properties.
Getting Started 29
Chapter 2: Cognos 8 Examples
30
Chapter 2: Cognos 8 Examples
You are a business analyst for the Great Outdoors company. You want to ensure that your
customers are satisfied with the products and services that you provide. In particular, if products
are returned, you want to investigate why and ensure that you offer a replacement before your
customers decide to shop elsewhere.
Using Event Studio, you can be notified whenever a customer returns a product because it was
defective, unsatisfactory, incomplete, or because the wrong product was shipped to them. You
want to immediately send an email to your customer service department with details about the
order and the customer so that they can contact the customer.
You will create an agent that looks like the Event Studio sample Returns Agent in the GO Sales
sample package.
To perform this exercise, you must have the appropriate licensing and security permissions.
Things to Notice
The tasks that you need to perform to create an agent in Event Studio appear in the I want to...
area in the left pane. By default, when you open Event Studio, you start with the first task,
defining an event.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Open Event Studio and select the GO Sales package.
3. Create the expression that defines the event:
• In the Insertable Objects pane, expand Returned items, Returned items, and insert the
Return quantity measure in the Expression box.
• Create the following expression:
[Return quantity]>0 AND [Return reason] IN ('Unsatisfactory product', 'Defective
product', 'Incomplete product', 'Wrong product shipped')
Tip: Insert items from the Insertable Objects pane. To select from a list of possible values
for the return reason, click the select value button. Move the values you want from the
Select Value box to the Selected Items box and click OK.
• Click the validate button to validate your expression.
Tip: You can also click Preview Data from the Actions menu to see the data retrieved
from the data source.
4. Add an email task:
• In the I want to list, click Add a task and click Email.
• In the To box, type the email address for the customer service department.
Tip: Since this example is for learning purposes, the agent will not actually run.
Therefore, you can type any email address.
• In the Subject, type Products Returned.
• Above the Body box, click the insert table button and add 5 columns and 2 rows.
• In the table, add information about returned products as follows:
Tip: You can drag items from the Insertable Objects pane. When the agent runs, the data
item for each event is replaced by the current value in the package.
• Select the top row and select the bold button to make the column headings stand out.
Getting Started 31
Chapter 2: Cognos 8 Examples
5. Set the execution rules so that a notification is sent only for new events:
• In the I want to list, click Manage the task execution rules.
• In the Insertable Objects pane, expand Sales, Order header, Order number, and drag
Order number to the Event key box.
• Click Next.
• Under Perform the selected task for, ensure that only New events is selected.
• Click Finish.
6. Set the schedule:
• In the I want to list, click Schedule the agent.
• Under Frequency, click By day and select Every 1 hour.
7. Save the agent as Returns Agent.
Each hour, the agent runs and the next time a customer returns a product, an email will be sent to
the customer service department with information about the order.
32
Chapter 2: Cognos 8 Examples
Things to Notice
In a portal page, you can add Cognos content, such as business intelligence reports, utilities, such
as URLs and bookmarks, and third-party portlets.
You can make a portal page available to a group in your organization, such as to the sales team,
or you can create a portal page for your personal use.
Steps
1. Open Cognos Connection:
• Start your Web browser
• In the address bar, type the URL supplied by your administrator, and then press Enter.
The URL looks something like this:
http://servername/cognos8
2. Click the new page button anywhere in Cognos Connection.
3. Type the name My Great Outdoors page, select a location in My Folders for the new page,
and click Next.
4. Specify the page layout:
• Under Number of columns, select 2 columns.
• Change the width of the left column to 40% and the right column to 60%.
5. Add content to your page:
• Under the left column, click Add.
• Click Cognos Content.
• Select the Cognos Navigator, Cognos Search, and Cognos Viewer portlets, and click the
arrow to move them to the Selected entries box.
Tip: You can preview the content of the portlets by clicking the view this portlet button in
the Actions column.
• Click OK.
• In the left column, click Cognos Viewer and click the move one item right arrow.
Getting Started 33
Chapter 2: Cognos 8 Examples
• Click Next.
6. Define the appearance of the page:
• In the Title box, type My Great Outdoors page.
Tip: You can change the formatting of the text.
• Click Next.
• Select the Add this page to the portal tabs check box.
• Click Finish.
The My Great Outdoors Page that you created appears as a tab in Cognos Connection.
7. Enhance the content of your page:
• Click the My Great Outdoors Page tab.
• In the Cognos Viewer portlet, click the edit button.
• Under Entry, click Select an entry and locate the Returns by Product Line Chart sample
report.
Tip: You can find this report in Public Folders > Great Outdoors Company > Query
Studio Report Samples. You can also use any other sample report.
• Under Portlet height in pixels, type 600.
• Click OK.
The report now appears in the right column of your portal page.
If the report was not previously run and saved, click the run button in the Cognos Viewer
portlet. In the Run with options page, click Save the report and then click Run.
The portal page appears with your contents.
34
Chapter 2: Cognos 8 Examples
Getting Started 35
Chapter 2: Cognos 8 Examples
36
Glossary
agent
The object type created and edited by Event Studio. An agent contains the event condition and the
associated tasks to perform. Once defined, an agent can be scheduled to check for instances of the
event.
analysis
A process where a user interacts with data to gain insight and understanding. In Cognos 8,
Analysis Studio is designed to facilitate analysis.
authentication
The process of verifying the identity of users when they log on. Users must be authenticated before
they can be authorized to use any secured resources.
condition
An expression that yields a boolean value. Conditions are used in query expressions, query filters,
and boolean report variables that can be used for conditional formatting, styles, data sources,
layouts and blocks.
drill down
The act of navigating from one level of data to a more detailed level. The levels are set by the
structure of the data.
See also drill up.
drill up
The act of navigating from one level of data to a less detailed level. The levels are set by the
structure of the data.
See also drill down.
event
An exceptional item of data, defined by specifying a query expression against items in a package.
When data is detected matching the event condition, it causes an agent to perform tasks.
event key
A combination of data items that uniquely defines an event instance. Identifying an event instance
enables the agent to determine if it is new, ongoing or stopped. The task execution rules then
determine which tasks to execute for each instance.
metric
A measurement of performance in key areas of a business that compares current results to planned
values.
model
A physical or business representation of the structure of the data from one or more data sources.
A model describes data objects, structure, and grouping, as well as relationships and security.
A model, called a design model, is created and maintained in Framework Manager. The design
model or a subset of the design model must be published to the Cognos 8 server as a package for
users to create and run reports.
Getting Started 37
namespace
For authentication and access control, a configured instance of an authentication provider. Allows
access to user and group information.
In XML, a collection of names, identified by a URI reference, which are used in XML documents
as element types and attribute names.
In Framework Manager, namespaces uniquely identify query items, query subjects, and so on. You
import different databases into separate namespaces to avoid duplicate names.
package
A subset of a model, which can be the whole model, to be made available to the Cognos 8 server.
portlet
A mechanism for displaying Web content as part of a portal page.
publish
To expose all or part of a Framework Manager model via a package to the Cognos 8 server, so
that Cognos BI Users can use it to create reports and other content.
query
A specification for a set of data to retrieve from a data source. A report specification can contain
one or more queries.
The type of object created and edited by Query Studio. A query is a subtype of report.
query item
A representation of a column of data in a data source. It contains a reference to a database
column, a reference to another query item, or a calculation. Query items may appear in a model or
in a report.
query subject
One of the types of objects inside a model. A query subject can be defined as a collection of
references to items of other query subjects, or expressed as an SQL expression that represents
selected query items. These query items will be retrieved from objects such as tables, synonyms,
views, and so on. Query subjects contain query items.
report
A set of data deliberately laid out to communicate business information. Depending on the
context, "report" may refer to report specification or report output.
Report (more precisely, report specification) is the generic term for the objects created by edited by
Query Studio, Report Studio, and Analysis Studio.
report output
A report output combines data at the point in time when the report was run with a report
specification. It is a document that can be displayed, printed or emailed. Cognos 8 can produce
report outputs in HTML, PDF, Excel, or CSV formats.
report specification
The definition of queries, prompts, layouts, and styles that make up a report. A report
specificaiton is combined with data by a run operation to create report outputs. You create report
specifications by using Report Studio, Query Studio, Analysis Studio, or through the Software
Development Kit.
report view
A reference to another report that has its own properties, such as prompt values, schedules, and
results.
You use report views to share a report specification instead of making copies of it.
38
scorecard
A collection of metrics representing the performance of one unit or aspect of an organization.
set
A collection of related items or members. Members in the set may be selected by one or more filter
rules or by selecting specific members.
See also specific set definitions (detail-based set, selection-based set, and so on).
task
An action performed by an agent if the event status meets the task execution rules. For example,
an agent can send an email, publish a news item, or run a report.
template
A reusable report layout or style that can be used to set the presentation of a query or report.
watch list
A list of metrics that each user has chosen to monitor closely. If notification is enabled in Metric
Studio, the user will receive email notification of changes to these metrics. Users can also choose
to display their watch list as a portlet within Cognos Connection.
Getting Started 39
40
Index
A D
ad hoc reports, 8 document
adding to portal pages, 33 version, 2
administering ReportNet, 11 documentation
agent views, 10 printing, 5
agents, 8 related information, 5
definition, 37 drilling down, 22
examples, 30 definition, 37
analyses drilling through, 11
Analysis Studio, 8 drilling up
definition, 37 definition, 37
examples, 22
Analysis Studio, 8 E
examples, 22
authentication event keys
definition, 37 definition, 37
automating Event Studio, 8
Cognos 8, 12 examples, 30
events
definition, 37
C monitoring, 8
charts See also agents
creating in Report Studio, 25 examples, 13
Cognos 8, 7 analyzing data in Analysis Studio, 22
how it works, 9 creating a query using Query Studio, 20
Cognos Connection, 7 creating a report in Report Studio, 25
examples, 16, 18, 33 creating portal pages, 33
running reports, 16 managing events in Event Studio, 30
Cognos Enterprise Planning monitoring performance using Metric Studio, 13
integrating with Cognos 8, 12 running reports, 16
Cognos PowerPlay for Windows scheduling reports, 18
integrating with Cognos 8, 12 Excel
Cognos samples, 13 report outputs, 10
Cognos Series 7
integrating with Cognos 8, 12 F
Cognos Viewer, 16
components of Cognos 8, 7 filters
conditional formatting creating in Analysis Studio, 22
applying in Query Studio, 20 creating in Report Studio, 25
conditions formatting
defining in Event Studio, 30 conditional, 20
definition, 37 Framework Manager, 10
copyright, 2
crosstabs G
creating in Analysis Studio, 22 Go To links, 11
CSV
report outputs, 10
customer support H
contacting, 5 help
related information, 5
HTML
report outputs, 10
Getting Started 41
Index
I Q
integrating queries
other Cognos products with Cognos 8, 12 definition, 38
international solution, 11 examples, 20
query items
L definition, 38
Query Studio, 8
languages, 11 examples, 20
linking reports, 11 query subjects
definition, 38
M
managed reports, 8 R
managing report outputs, 10
reports, 10 definition, 38
Metric Studio, 7 report specifications, 10
examples, 13 definition, 38
metrics, 7 Report Studio, 8
definition, 37 examples, 25
examples, 13 report views, 10, 18
models, 10 definition, 38
definition, 37 reports, 12
monitoring advanced, 8
events, 8 definition, 38
multilingual solution, 11 managing, 10
My Folders, 10 running, 16
scheduling, 18
N simple, 20
namespaces running
definition, 38 reports, 16
O S
organizing samples, 13
entries in the portal, 10 Cognos, 13
outputs, 10 scheduling, 12
reports, 18
scorecards, 7
P definition, 39
packages, 10 examples, 13
definition, 38 SDK, 12
PDF security, 11
report outputs, 10 sets
permissions, 11 definition, 39
required for samples, 13 software development kit, 12
personalizing support
portal pages, 11, 33 contacting, 5
reports and agents, 10
planning data
integrating with Cognos 8, 12
T
portal pages, 11 tasks
examples, 33 defining in Event Studio, 30
portals, 7 definition, 39
portlets, 11, 33 templates
definition, 38 applying in Query Studio, 20
printing definition, 39
documentation, 5 top or bottom filters, 22
prompts tutorial, 13
creating in Report Studio, 25
Public Folders, 10 V
publishing version
definition, 38 document, 2
42
Index
W
watch lists, 13
definition, 39
workflow, 9
X
XML
report outputs, 10
report specifications, 10
Getting Started 43
Index
44