Use IBM® Cognos® Report Studio to create a simple report
based on a predefined layout.
About this task
The instructions that follow demonstrate the procedure
for creating a simple report by using Cognos Report
Studio. Follow the steps in the example to create a column chart that
shows the total number of times that items were updated for each Connections
application. The report uses three basic sets of data:
For more information about dimensions in the Metrics PowerCube,
see the PowerCube
dimensions topic. For more information about working with Cognos Report Studio, see the Report Studio User Guide.
Procedure
- Choose a unique name for the report:
A unique
name is required for community metrics, so before you create a report,
check the list of existing community reports to make sure that your
new report has a unique name.
- Open a browser and go to the Cognos dashboard by using the following address: http://cognosserver.example.com:9083/cognos/servlet/dispatch/ext
- Log in to Cognos as
the Cognos administrator.
- Click . If this folder does not exist, you can stop checking.
- Review the list of reports. If you see a name that matches
the planned report, choose a different name for the new report.
- Open Cognos Report
Studio:
- Return to the Cognos dashboard.
- Click .
- When prompted to select a data package, select to create a report that queries the PowerCube containing
Metrics data.
- In the Welcome window, click Create
a new report or template.
- Select a report type:
- In the New window, select a type
of report by clicking the image that represents the general type of
display that the report generates.
For this example,
select Column; this type displays the available
formats for a column chart.
- In the Insert chart window, select
a specific format from the display that corresponds to the type of
chart that you selected in the previous step.
For this
example, select any column chart format. Because the example tracks
a limited data series, there is no data to stack and all of the column
formats appear similar in the output.
- Click OK.
- Select a Measure for the chart to track along the Y-axis:
The Y-axis displays measures of quantitative data, such as
sales figures or quantities.
- Click the Source tab.
- In the packages list, expand the METRICS_TRX_CUBE datasource.
- Select EVENT_COUNT and drag it
to the Default measure (y-axis) area of the
chart.
- Select the specific categories (applications, in this example)
to be tracked along the X-axis:
The X-axis displays
categories (groups of related data) that are plotted on the X-axis
so you can compare them. Categories are qualitative because they represent
things rather than quantities. For this example, events (on the Y-axis)
are tracked for activities within Connections applications. Each application
is s category and is plotted along the X-axis. The "source" of the
categories includes all Connections applications. There are two ways
to select the categories; use the method that is simplest for your
report:
Begin with all categories and exclude the categories
that you do not want in the report:
- Return to the METRICS_TRX_CUBE datasource.
- Expand SOURCE and select the SOURCE hierarchy;
drag it to the Categories (x-axis) area of
the chart.
- Click All Members to begin by
including the complete list of categories.
- On the Categories (x-axis) area
of the chart, click <#SOURCE#> tag.
- In the Properties window, click Edit for
the "Set Definition" property.
- In the Set Definition window, right-click
the SOURCE hierarchy and select .
- In the Exclude window, expand the METRICS_TRX_CUBE datasource.
- Select SOURCE in the Available members
list and click Add to copy it to the excluded Members list.
- Select DEFAULT in the Available members
list and click Add to copy it to the excluded Members list.
DEFAULT represents a special calculation
that is not needed for this simple report, so you can exclude it.
- Click OK.
Begin with no categories and include only the categories
you want in the report:
- Return to the METRICS_TRX_CUBE datasource.
- Expand SOURCE and select the SOURCE hierarchy.
- Expand Members and select SOURCE.
- Click a category to include in the report; Ctrl+click
each additional category to add it to the selection; then drag the
selection to the Categories (x-axis) area of
the chart.
- Click OK.
- Select the data series:
A data series is
a group of related data points that are plotted in a chart. This example
reports on updated items, which use the UPDATE type of the EVENT measure
as the data series. Because this report tracks the total number of
updates for each application, the data series contains only one measure
(UPDATE). A more complex report might chart the total number of updates
for each application over a series of months or years. In that case,
the data series includes each month or year that is reported.
- Expand the measure.
- Expand .
- Select UPDATE and drag it to
the Series area of the chart.
- Click Save and store the report
in .
All custom reports should be stored
in this location to make them available to the Metrics application.
- Click to test the report by viewing
it in the Cognos Viewer;
then close the viewer when ready to proceed.
- Determine the URL for the new report so you can add it
to the Metrics user interface:
- Return to the Cognos dashboard.
- Go to the location where you saved the report, and select
the new report.
- Click Set properties.
- In the Set properties window, click
the General tab.
- On the General tab, click View the search
path, ID and URL.
- In the View the search path, ID and URL window,
copy the entire URL from the Default action url field.
- Click Close.
- Leave the Cognos dashboard
open so that you can return to it in step 11.
- Modify the report URL and add it to the Metrics user interface:
- Paste the copied URL into a text editor.
- In the URL, replace http://localhost:80/ibmcongos/cgi-bin/cognos.cgi with /servlet/dispatch/ext.
The remainder of the URL ( from ?b_action= to
the end of the URL) stays the same.
For example:
http://localhost:80/ibmcognos/cgi-bin/cognos.cgi?b_action=cognosViewer&ui.action=run&ui.object=%2fcontent%2ffolder%5b%40name%3d%27IBMConnectionsMetrics%27%5d%2fpackage%5b%40name%3d%27Metrics%27%5d%2ffolder%5b%40name%3d%27customReports%27%5d%2freport%5b%40name%3d%27test1%27%5d&ui.name=test1&run.outputFormat=&run.prompt=true
becomes:
/servlet/dispatch/ext?b_action=cognosViewer&ui.action=run&ui.object=%2fcontent%2ffolder%5b%40name%3d%27IBMConnectionsMetrics%27%5d%2fpackage%5b%40name%3d%27Metrics%27%5d%2ffolder%5b%40name%3d%27customReports%27%5d%2freport%5b%40name%3d%27test1%27%5d&ui.name=test1&run.outputFormat=&run.prompt=true
- Using the revised URL, add an entry for the new report
in the reports-config.xml file as explained in Adding custom reports
to the Metrics reports list.
Your new report
is not available to users until you add it to the reports-config.xml file.
- (Community metrics) If the new report is for use in community
metrics, add it to the job list so it can be updated from the Community
Metrics user interface:
- Return to the Cognos dashboard.
If you closed the dashboard, you can access it at the following
address: http://cognosserver.example.com:9083/cognos/servlet/dispatch/ext.
- Click .
- Find the new report that you created and copy it to
the Public Folders/IBMConnectionsMetrics/Metrics/community/customizedTheme folder.
If the customizedTheme folder does not exist,
create it now.