You are on page 1of 59

4.

1 Defining new reports

You can create new reports with Report Wizard or by using an existing report as a template. For instructions, see
Report Wizard. For instructions on one particular report type, see Defining TopN reports.

To use an existing report as a template for another report

You can use a Nokia report as a template for one of your own reports.

Note!
You cannot modify the predefined reports provided by Nokia. You can change the permissions of a default report but
you can make it editable with any permission changes. For more information, see Managing permissions.

You can only copy a report if you have at least Read access for a particular report. When you copy a report, you
become the owner of the new report and you can define the permissions for it. For more information on access and
permissions, see Managing permissions.

1. Select the report that you want to use as a template.


2. Copy the report onto the Clipboard:
o Select Edit -> Copy Ctrl-c from the Menu bar.
o Select Copy Ctrl-c from the local context menu.
o Press the Ctrl-c keys.
3. Select the folder in which you want to create the new report.
Note!
Reports can only be pasted into folders.
You need to have Modify permission for the folder to be able to paste the template report into it.
4. Paste the report into the folder:
o Select Edit -> Paste Ctrl-v from the Menu bar.
o Select Paste Ctrl-v from the local context menu.
o Press the Ctrl-v keys.

When you copy a report, all the existing settings and KPIs for the original report are copied into the new
report.
Note!
The title of the chart remains unchanged when you create a copy of a report. The title is independent of the
report name and therefore you have to change it separately when you open the copied report for editing. For
instructions, see Title pane in Axis tab.

5. To distinguish the new report from the old one, the words Copy of are placed in front of the original name by
default. You can modify this default name. For instructions, see Modifying reports.

4.2 Defining TopN reports

You may need to create a report to show, for example, the poorest performing elements in the network. If you were
looking for badly performing BTSs, a query for all BTSs would produce a massive amount of records. By creating a
TopN report, you can concentrate on specific network elements of interest.

To create a TopN report

1. Define a report with a single counter.


2. Enter the Report Visualisation window.
3. Use the Type tab to define the report as a TopN report.
4. Use the Chart Data tab to
o Move all dimensions to the X-axis Display pane.
o Disable the Time Series Data Completion checkbox, if selected.
5. Use the Table Data tab to
o Move all dimensions to the Rows - Display one Row per pane.
o Disable the Time Series Data Completion checkbox, if selected.
6. Click Ok.

4.3 Defining URLs

You can define and use Uniform Resource Locator (URL) links in Report Builder. You can view the links from Report
Builder and Report Browser with a Web browser.

To create a URL

1. Select the folder in which you want to add the new URL.
2. Create the new URL:
o Select Report -> New -> URL from the Menu bar.
o Click the (Create URL) icon in the Toolbar.
o Select New -> URL in the local context menu.
o Press the F4 key.
3. A URL node with a default name is created. You can change the name at this point. The owner of the URL is
the current user.

For instructions on other URL-related tasks, see Modifying or deleting Reporter nodes.

4.4 Caching and scheduling reports

The caching and scheduling feature of Report Builder allows you to enhance the performance of the Reporter
applications. You can configure Report Builder to generate your reports according to a predefined schedule and to
send out e-mail notifications when the scheduled report is generated. The scheduled reports are written to a cache
from where you can access them faster with Report Builder and Report Browser.

Note!
The caching and scheduling feature is optional and you need a licence for it. If you do not have the licence you

always regenerate the report from the data in the database if you click the (Enforce Query) icon or press the F5
key.

Caching

The cache is a designated database table and is empty when the Reporter applications are first installed. When
Report Builder caches a report, it writes the queried report to the cache. When any user who can access the report
queries it again before its expiration date, the report is called from the cache rather than generated from scratch.

Whether a report is cacheable depends on when the validity interval of the report is over and for what time you want
to cache the report.

• You cannot cache reports with the raw or hourly summary level, if their time frame is Relative and their End
Point is CURRENT_TIME. In practice, it means that you can only cache daily, weekly, or monthly reports.

• Caching depends on the request time to the extent that the content of the cached report might not be
available all the time. For example, summarised daily data is not available at midnight because the time-
consuming operation of summarisation only starts at midnight and delayed raw data often enforces re-
summarising as well. Scheduled reports can only provide you with sensible results if they are generated
after the summarisation and the eventual re-summarisations have been performed.

Scheduling

Scheduling a report allows you to run a report at a time that you specify. The results of a scheduled report are pre-
calculated and cached. The report can be scheduled for periods with lower load on the system, and querying them
from the cache during higher load periods does not put significant further load on the system.

For information on how to schedule a report, see Report Scheduling options - fifth (optional) Report Wizard window.

You can find the following information on scheduled reports in the SystemOut.log file:

• Start time of the report generation.

• Start time of the second attempt to generate the report if the first generation failed because all the available
connections were in use. The generation of a scheduled report is postponed by 10 minutes if, for example,
the system is busy because several reports have to be generated the same time.

• End time of the report generation.

The SystemOut.log file is located on the Linux Application Server in the


/opt/WebSphere/AppServer/logs/server1/ directory.

Dependencies between caching and scheduling

There are restrictions on caching, and, consequently, on scheduling a report. The following restrictions apply:

• Reports that cannot be cached cannot be scheduled either.

• Scheduled reports are cached.

• You can always obtain static reports with absolute time period, that is, reports with an unlimited validity
interval, from the cache. Therefore, it has no practical purpose to schedule a static report on a regular basis.
However, Reporter does not prevent you from scheduling such a report, it only gives you a warning
message.

Note!
Temporary reports, which you generate ad-hoc with Report Browser by only adjusting the time period or the Busy
hour settings for a report, cannot be cached.

4.5 Modifying reports

If you want to modify an existing report without overwriting the original, generate a copy of the original. For
instructions, see Defining new reports.
You can modify existing reports in the following ways:

• Modifying the report description by opening the text field that you can edit in the first window of Report
Wizard:
o Select Report -> Description... from the Menu bar.
o Select Description... in the local context menu.

For more information, see Report creation - first Report Wizard window.

• Adding or removing PI/KPIs or forcing the report to use the raw or aggregated value for a PI/KPI in the
second window of Report Wizard:
o Select Report -> Performance Indicator Selection... from the Menu bar.
o Select Performance Indicator Selection... in the local context menu.
o Press the F6 key on the keyboard.

For more information, see Performance Indicator Selection - second Report Wizard window.

• Modifying the dimension selections or the busy hour settings in the third window of Report Wizard:
o Select Report -> Dimension Selection... from the Menu bar.
o Select Dimension Selection... in the local context menu.
o Press the F11 key on the keyboard.

For more information, see Dimension Selection - third Report Wizard window.

• Modifying the report visualisation options in the fourth window of Report Wizard:
o Select Report -> Report Visualisation... from the Menu bar.
o Select Report Visualisation... in the local context menu.
o Press the F12 key on the keyboard.

For more information, see Report Visualisation options - fourth Report Wizard window.

• Modifying the scheduling parameters by opening the second window of Report Wizard:
o Select Report -> Report Scheduling... from the Menu bar.
o Select Report Scheduling... in the local context menu.

For more information, see Report Scheduling options - fifth (optional) Report Wizard window.

Note!
You cannot modify the predefined reports that were provided by Nokia. However, users who belong to the Report
Builder Admin group have administrator rights and can change the scheduling parameters of Nokia default reports.
For more information on scheduling, see Caching and scheduling reports.

When you add a PI/KPI to an existing report, you need to make sure that all PI/KPIs in the report use the same
dimension selection settings. If, for example, no summary level is defined for the PI/KPIs you are adding to the
existing report, Report Builder assumes a default value. If this default value is different from the value of the existing
PI/KPIs in the report, and thus there is no common summary level defined for all PI/KPIs in the report, Report Builder
shows the highest common available level. For information, see Why does Report Builder change the summary level
when I add PI/KPIs to an existing report?.

To add PI/KPIs or formulas to a report


1. Select the report to which you want to add PI/KPIs or formulas.

2. Open the second window of Report Wizard:


o Select Report -> Performance Indicator Selection... from the Menu bar.
o Select Performance Indicator Selection... in the local context menu.
o Press the F6 key on the keyboard.

For a description of this window, see Performance Indicator Selection - second Report Wizard window.

3. Navigate to the PI/KPIs in the Tree tab or search for the PI/KPIs that you want to add in the Find tab of the
window. For instructions on how to use the Find tab, see Searching in the PI Tree.

4. Select the PI/KPI(s) that you want to use in your report and click the (Add) icon. The PI/KPI(s) you
chose appears in the Selected Performance Indicators pane.

5. Click Ok. This closes the Performance Indicator Selection window and adds the selected PI/KPI(s) to your
report in the Report Tree of the main window.

Note!
You must reload the report before you can see the new PI/KPI data in it. For instructions, see Reloading reports.

To remove PI/KPIs or formulas from a report

1. Open the second window of Report Wizard:


o Select Report -> Performance Indicator Selection... from the Menu bar.
o Select Performance Indicator Selection... in the local context menu.
o Press the F6 key on the keyboard.

For a description of this window, see Performance Indicator Selection - second Report Wizard window.

2. Select the PI/KPI(s) that you want to remove in the Selected Performance Indicators pane.

3. Click the (Remove) icon.


The PI/KPIs disappears from the Selected Performance Indicators pane.

4. Click Ok to close the Performance Indicator Selection window and remove the selected PI/KPI(s) from your
report in the main window Report Tree.

Note!
You must reload the report before you can see the impact of the PI/KPI removal. For more information, see
Displaying reports.

To force the report to use the raw or aggregated tables for a PI/KPI

1. Select the report in which you want to modify whether a PI/KPI or formula uses raw or aggregated
measurement tables or if you want to restore the system settings.

2. Open the second window of Report Wizard:


o Select Report -> Performance Indicator Selection... from the Menu bar.
o Select Performance Indicator Selection... in the local context menu.
o Press the F6 key on the keyboard.

For a description of this window, see Performance Indicator Selection - second Report Wizard window.

3. Select the PI/KPI or formula for which you want to modify the settings in the Selected Performance
Indicators pane.

4. Click the cell with the current value in the Agg.Choice column. The three aggregation options become
visible in a pull-down list.
o Select Raw or Agg if you want that the PI/KPI fetches data from the raw or from the aggregated
measurement tables, respectively.
o Select System if you want the report to fetch data from the measurement tables according to the
PI/KPIs definition.

5. Click Ok. This closes the Performance Indicator Selection window and saves the modifications to your report
in the Report Tree of the main window.

Note!
You must reload the report before you can see the impact of your modifications in the aggregation settings. For
instructions, see Reloading reports.

To modify dimension selections for PI/KPIs or formulas in a report

You can modify the following dimensions for a PI/KPI or formula:

• Busy hour
• Time or other dimensions, for example object hierarchy

1. Open the third window of Report Wizard:


o Select Report -> Dimension Selection... from the Menu bar.
o Select Dimension Selection... in the local context menu.
o Press the F11 key on the keyboard.

For a description of this window, see Dimension Selection - third Report Wizard window.

2. Select the PI/KPI or formula that you want to modify in the left pane of the window.

3. Modify the dimension(s) for the PI/KPI or formula:

o Tick the Busy Hour (BH) checkbox in front of the PI/KPI or formula in the left pane of the window if
you want the busy hour values of this PI/KPI to be used for your report. If a PI/KPI does not have a
checkbox, this particular PI/KPI is not available for busy hour reports.
o Select the tab for the time or other dimension that you want to modify in the right pane of the
window.
Note!
Since PI/KPIs do not necessarily have the same dimensions, the dimension tabs are updated when
the selection of PI/KPIs changes. Any prior changes are stored in the database. As a result, the
dimension tabs display all dimensions shared by the selected PI/KPIs.
Depending on which dimensions you want to edit, click the corresponding dimension tab, for
example, Time or Network.
For instructions on how to edit the time dimension selection, see To edit the time dimension
selection. For instructions on how to edit other dimension selections, see To edit other dimension
selections.

To edit dimension selections

1. Select the report in which you want to modify dimension selections for PI/KPIs or formulas in a reports from
the Report Tree and select Report from the toolbar
or

right-click the report that you want to modify to open the Report Context menu.

2. Select Dimension Selection to open the Dimension Selection window.


In the Dimension Selection window, the selected PI/KPIs of your report are visible on the left and dimension
tabs, for example, 'time' and 'network', are visible on the right hand side. The dimension tabs group
dimensional settings together.
Note!
Since PI/KPIs do not necessarily have the same dimensions, the dimension tabs are updated when the
selection of PI/KPIs changes. Any prior changes are stored in the database. As a result, the dimension tabs
display all dimensions shared by the selected PI/KPIs.

3. Depending on which dimensions you want to edit, click the corresponding dimension tab, for example, Time
or Network.
For instructions on how to edit the time dimension selection, see To edit the time dimension selection. For
instructions on how to edit other dimension selections, see To edit other dimension selections.

To edit the time dimension selection

1. Select the PI/KPI(s) that you want to edit from the list on the left of the Dimension Selection window.
By default, all PI/KPIs are selected and you can define dimensional settings for all PI/KPIs in the report.

2. Select the dimension hierarchy, Start Time (Month), or Start Time (Week), by clicking the Hierarchy option
list.

3. Select the summary level from the Summary Level option list. For information, see Time dimension tab.
Note!
Some summary levels are available in more than one Dimension Hierarchy. Specifying both Dimension
Hierarchy and Summary Level gives Report Builder sufficient amount of information to generate the report.
4. Select the time frame by clicking either the Absolute or Relative option in the Time Frame Selection pane.
For more information on how to select the time frame, see Time dimension tab.

5. Tick the Mon - Sun checkboxes in the Day Selection pane if you want to include data only from specific
days within the time interval you select in the Time Frame Selection pane. You can select all days at the
same time by clicking Select All and deselect selected days by clicking Clear Selection.

6. Click the boxes 0 - 23 in the Hour Selection pane if you want to include data only from specific hours within
the time interval you select in the Time Frame Selection pane. You can select all hours at the same time by
clicking Select All and deselect selected hours by clicking Clear Selection.
Note!
At least one day and one hour should be selected.

7. Click Ok to close the Dimension Selection window and apply the properties to your report.
Note!

To see these changes in your report, you must first reload it by clicking the (Enforce Query) button.

To edit other dimension selections

1. Select the PI/KPI(s) that you want to edit from the list on the left of the Dimension Selection window.
By default, all PI/KPIs are selected and can define dimensional settings for all PI/KPIs in the report.

2. Select the hierarchy dimension by clicking the Hierarchy option list.

3. Select the summary level by clicking the Summary Level option list.
Note!
Some summary levels are available in more than one Dimension Hierarchy. Specifying both Dimension
Hierarchy and Summary Level gives Report Builder sufficient amount of information to generate the report.

4. In the List Type pane, select either the Include or Exclude option depending on whether you want to
include the selected objects in your report or exclude them.

5. Expand the Available objects list by double-clicking the icons.

6. Depending on whether you want to include or exclude objects:


o Select the object(s) that you want to include and click the (Add) icon. The object appears in the
Selected objects pane.
o Select the object(s) that you want to exclude and click the (Remove) icon.
7. Click Ok to close the Dimension Selection window and apply the properties to your report.

Note!

To see these changes in your report, you must first reload it by clicking the (Enforce Query) button.

Note!
If a object is shown as 'OBJECT NOT FOUND...', it has been removed from the database. If a single object is
missing, it might have been removed from the network. In this case, it is recommended that you remove this object
from the selection.

4.6 Managing folders

You can create, modify, or delete folders in the Report Tree and in the PI Tree. You can also modify the permission to
a folder.

1. Toggle to the relevant view:


o Select View -> Report View or View -> Formula View from the Menu bar.

o Select the (Report View) or (Formula View) toggle button in the Toolbar.
2. Select the folder in Report Tree or PI Tree in which you want to create the new folder or select the folder that
you want to modify.

To create a new folder

1. Select the folder in which you want to create the new folder.
2. Create the new folder in one of the following ways:
o Select Report -> New -> Folder or Formula -> New -> Folder from the Menu bar.
o Select Report -> New -> Folder or Formula -> New -> Folder from the local context menu
o Press Ctrl-Alt-n.

A new folder is created.

3. Edit the name of the new folder and press Enter.

The new folder inherits the permission of its parent folder. For more information, see Managing permissions.

Note!
You can also create a folder in the first window of Report Wizard and Formula wizard.

For instructions on other folder-related tasks, see Modifying or deleting Reporter nodes.

4.7 Modifying or deleting Reporter nodes

You can modify the Reporter nodes (folders, reports, URLs, and formulas) in Report Builder. You cannot modify
PI/KPis which are the built-in formulas of NetAct Reporter.

Note!
You can only rename and delete nodes, or change the permission to nodes if you have Modify permission to them. If
you only have Read permission to a node, the Rename option is inactive (grayed out) in the Edit menu and in the
local context menu. For information on permissions, see Managing permissions.

When you modify a formula, the modification has an immediate impact on all the reports in which the formula is
included. Before you modify a formula, it is recommended to check in which reports it is included with the Reports
referencing PI radio button if you only want the list of the report names. For instructions, see Searching in the Report
Tree.

To rename a node

1. Select the node that you want to rename.


2. Rename the node in one of the following ways:
o Select Edit -> Rename from the Menu bar.

o Click the (Rename) icon in the Toolbar.


o Select Rename from the local context menu.

Note!
You cannot rename default Nokia reports, or nodes that are locked and are marked with the lock icon.

To delete a node

1. Select the node that you want to delete.


2. Delete the node in one of the following ways:
o Select Edit -> Delete from the Menu bar.

o Click the (Delete) icon in the Toolbar.


o Select Delete from the local context menu.
o Press Ctrl-x.

To change the permissions of a node

1. Select the node for which you want to change the permission.
2. Change the permission of the node in one of the following ways:
o Select Report -> Permissions... or Formula -> Permissions... from the Menu bar.

o Click the (Permissions) icon in the Toolbar.


o Select Permissions from the local context menu.
o Press Ctrl-x.

To modify a URL

1. Select a URL node that you want to modify.


2. Edit the URL:
o Select Report -> Edit from the Menu bar.
o Select Properties... in the local context menu.
3. The URL window opens where you can edit the properties of the URL node:
o URL: the Web link, for example, http://www.google.de or file://c:/readme.txt.
o Description: edit the current URL description.
o Launch in a new browser checkbox: leave the checkbox empty to open the Web browser in the
Report view or select the checkbox to open the Web browser in a new window.
Note!
This choice only applies to Report Browser and KPI Browser but not to Report Builder. For Report
Builder a new Web browser window is always opened for each URL that is selected.
4. Click Ok to save the changes.

5 MANAGING PERMISSIONS

Users who can modify an element of the Report Tree and the PI Tree can also specify whether other users could
read or modify it. You can change the permission of all the element types in the Report Tree, that is, all the nodes:
PI/KPIs or formulas, URLs, reports, and folders.

You can also modify the permission of a default report. You cannot making it editable even if you assign Modify
access to it, but you can hide it from other users if you assign No Access right to it.

By default, nodes inherit the permission value from their parent node. You need to set the permission to a node
manually if you want to assign it a permission that is different from the permission of the parent node.

Note!
Users who have not received at least Read permission for a node cannot see the node in the Report Tree or the PI
Tree. Therefore, PIs must have at least Read permission to be visible in the PI tree for all the users. Otherwise they
cannot use the PIs for creating new reports.

There are three permission types for Reporter nodes:

• Private or No Access
If the owner or an administrator user define the permission for the node as Private or No Access, no other
user can see or modify the node.
The owner of a node, that is, the user who has created it, and the administrator users can always see and
modify the node.

• Read
A user with Read permission is able to view and copy the report or formula. However, the user cannot
change the characteristics of the report or formula in any way.

• Modify
A user with Modify permission is able to modify the permission of the node, edit the characteristics of the
report or formula, and save the changes.

It is recommended that administrators assign Read permission to the Root node of the Report Tree and PI Tree first
and hide parts of the trees by setting the permissions to No Access or Modify as necessary.

You can set and change permissions in Report Builder in two ways:

• Private/Public approach

You can set a node so that everybody can see or even modify it, to Public Read and Public Modify,
respectively, or to Private so that only the owner and the administrator can see and modify it.

• Role-based approach

You can set a node so that users who are assigned the same NetAct role can either read or modify it, or
have no permission to it at all. Administrators have to create user groups and roles for the users of the
Reporter applications with NetAct Permission Manager before the users can log into Report Builder and
access nodes or modify permissions to nodes. Default Permission Object and Operations exist in NetAct
Permission Manager for creating user groups and roles for the Reporter applications as well.

For instructions, see Assigning permissions with the Private/Public approach and Assigning permissions
with the Role-based approach.

o The Permission Object for Reporter is APP_SC_REPORTER, which is created when the
application is installed on the Application Server.

o The Permission Operations are ADMIN and LAUNCH, which are available.

o It is recommended that you create at least one user group and one role for the Reporter users and
their role of being a user of Reporter applications. Administrators can create as many user groups
and roles as required, so that various permission settings can be associated with different user
groups.

For more information and for instructions on how to create user groups and roles, see NetAct Permission
Manager Help in the 'Helps' category in the NetAct documentation.

Note!

It is also possible to use the Role-based approach to assign permission for each NetAct or Reporter user to
each object in Nokia NetAct, including reports or KPIs, on a per-object basis. However, this approach is not
recommended because it would require continuous and manual control of permissions for each object, an
approach which would eventually undermine the concept of the role- and group-based permission
management.

You can select between these two options at installation time, the default is the Private/Public approach. If you want
to use the Role-based instead of the Private/Public approach, assign the
APP_SC_REPORTER.USE_ROLE_BASED_INSTEAD permission to the Reporter_Public_Role role in
NetAct Permission Manager.

It is also possible to switch between the two solutions later on with NetAct Permission Manager. You need to restart
Reporter for the change to take effect by restarting WebSphere. For instructions, see To shut down the LinAS
WebSphere application server cluster and To start up LinAS WebSphere application server cluster in Starting Up and
Shutting Down NetAct in the NetAct documentation. However, changing between the permission management
solutions is not recommended because all settings are practically lost when you change from one solution to the
other, because the settings for the permissions are stored separately, and any changes in the Report Tree will make
the permission settings obsolete and therefore not usable any more.

The Report Tree and the PI Tree are updated automatically after you have changed the permissions in the tree. If you
have changed the permission of a folder, the folder collapses in the tree.

5.1 Assigning permissions with the Private/Public approach

The figure below shows the Node Permissions window when you are using the Public/Private approach to set the
permissions for the nodes in the Report Tree and the PI Tree.

Node Permission window in the Private/Public approach

To change the permission to a node with the Private/Public approach

Note!

You can only change the permission to a node if you have Modify permission to it, or you are the owner or an
administrator user.

1. Right-click the node in the Report Tree or in the PI Tree and select Permissions. If you want to modify the
permissions for a node in the Report Tree (a folder, a report, or a URL), you can also select Report ->
Permissions.

The Node Permissions window appears with the nodes to which you have Modify permission.

2. If you want the node to inherit the permission settings of its parent, leave the As inherited checkbox ticked.

To change the permission to a node, untick the As inherited checkbox and select one of the radio buttons:

o Select Private, if you want to reserve all the rights to the node for yourself. Other users cannot see
or modify the node.
Note!
It is recommended that you only set a permission to Private if you are the owner or an
administrator, otherwise you can deny yourself access to the node.

o Select Public Read, if you want to reserve the modification rights to yourself. Other users can see
the node but cannot modify it.

o Select Public Modify, if you want to allow any user to see or modify the node.
3. Click OK to save the changes.

5.2 Assigning permissions with the Role-based approach

The figure below shows the Node Permissions window when you are using the Role-based approach to set the
permissions for the nodes.

Node Permission window in the Role-based approach

To change the permission to a node with the Role-based approach

Note!

You can only change the permission to a node if you have Modify permission to it, or you are the owner or an
administrator user.
1. Right-click the node in the Report Tree or in the PI Tree and select Permissions. If you want to modify the
permissions for a node in the Report Tree (a folder, a report, or a URL), you can also select Report ->
Permissions.

If you have Modify permission to the node, the Node Permissions window appears and displays the NetAct
roles to which the LAUNCH Permission Operation is associated for the APP_SC_REPORTER Permission
Object.

2. If you want the node to inherit the permission settings of its parent, leave the As inheritance checkboxes
ticked for those roles to which this inheritance should apply.

To change the permission to the node for the users who are assigned a particular NetAct role, untick the As
inheritance checkboxes and select one of the radio buttons in the row of the role:

o Select No Access, if you want to revoke the permission to the node from all the users who are
assigned the role.

o Select Read, if you want to make the node visible for the users with the role but you want to
reserve the modification rights to another role. Other users can see the node but cannot modify it.

o Select Modify, if you want to allow any user with the role to see or modify the node.

3. Click OK to save the changes.

6 SEARCHING

Trees can be very long and can contain numerous folders of reports or PI/KPIs and formulas. In Report Builder you
can search a particular tree and obtain matches based on given search criteria. You may want to search a tree for the
following reasons:

• You cannot find particular items in the tree.

• You know the name of the item, but you do not want to click through the tree to find it.

• You want to find all items that match a certain search criteria.

• The tree is very long, in which case searching is faster and easier than browsing.

• You want to find a specific item to use, for example, in a formula you are working on.

If the search has not provided any results, ensure that the following conditions do NOT apply:

• The tree exists but is empty.

• You have used an empty search string, or an invalid string, for example, with wildcards that are not
supported.
Note!
Report Builder searches for an exact string by default. You can use only the asterisk (*) as a wildcard in your
search, for example, in *wsv*. You can use the asterisk in all the search procedures and it can stand for one
or several characters in the string.
• No items are found that match the search criteria.

You can search for reports, report components, URLs, and folders in the Report Tree and for PIs and formulas in the
PI Tree. You can use the following search procedures:

 Searching in the Report Tree


 Searching in the PI Tree

 Searching for managed objects when modifying a dimension

6.1 Searching in the Report Tree

You can search for any node in the Report Tree: folders, reports, URLs, or report components.

1. Select the Find tab in Report View.

2. Select the filter for your search with the radio buttons. Report Builder finds all the reports that match the
search string and also those that contain nodes (PI/KPIs or formulas) that match the search string.
o Select Reports name if you want to see all the nodes in the Report Tree whose name is a match
for the search string.
o Select Reports referencing PI if you want to know which reports include the component whose
name is a match for the search string.

These buttons are only visible on the Find tab in Report View and you can use them to check in Report Tree
in which report they are used before you remove or modify them.

3. Select the maximum number of search results that you want to display.

4. Start the search:

o Click the (Search) icon.


o press Enter.

5. The search result pane displays the list of Report Tree objects that matches the search criteria and for which
you have Read permission. A search result displays the name of the item and its type represented as an
icon. The pathname of the item is shown at the bottom of the pane. If the pathname is not completely visible,
use the Tooltip to display the full name.

6. Select one or more Report Tree nodes from the search results.

7. Start the operation that you want to perform, for example Show Chart or Delete, on the selected node(s):
o Click the relevant icon in the Toolbar.
o Select the relevant menu item from the local context menu.
o Press the relevant key or key combination.

6.2 Searching in the PI Tree


You can search for PI/KPIs or formulas

1. Select the Find tab in Formula View.

2. Select the maximum number of search results that you want to display.

3. Start the search:

o Click the (Search) icon.


o press Enter.

4. The search result pane displays the list of PI Tree objects that matches the search criteria and for which you
have Read permission. A search result displays the name of the item and its type represented as an icon.
The pathname of the item is shown at the bottom of the pane. If the pathname is not completely visible, use
the Tooltip to display the full name.

5. Select one or more PI Tree nodes from the search results.

6. Start the operation that you want to perform, for example Show Chart or Delete, on the selected node(s):
o Click the relevant icon in the Toolbar.
o Select the relevant menu item from the local context menu.
o Press the relevant key or key combination.

6.3 Searching for managed objects when modifying a dimension

1. Select the report in which you want to edit dimension selections.

2. Open the third window of Report Wizard:


o Select Report -> Dimension Selection... from the Menu bar.
o Select Dimension Selection... in the local context menu.
o Press the F11 key on the keyboard.

For a description of this window, see Performance Indicator Selection - second Report Wizard window.
The selected PI/KPIs of your report are visible on the left and dimension tabs, for example, '3G network' are
visible on the right. The Time tab is not relevant.

3. Select the Find tab. Enter the search criteria of the managed object for which you want to search.
Select a search level, for example, 'BSC'.

4. Select the maximum number of search results you want to display.

5. Start the search:

o Click the (Search) icon


or
o press Enter.
6. The search result pane displays the list of managed objects that matches the search criteria and for which
you have read permission. A search result displays the name of the item and its type represented as an
icon. The pathname of the item is shown at the bottom of the pane. If the pathname is not completely visible,
use the Tooltip to display the full name.

7. Select one or more managed objects from the search results that you want to include in the report and click
the (Add) icon to put them in the report. You can use drag-and-drop to perform the same operation.

7 REPORT BUILDER USER INTERFACE

The user interface of Report Builder consists of the following components:

• Menu bar
The menu has the following submenus in Report View and in Formula View:
o File menu

o Report menu (visible only in Report View, when the toggle button has been selected)

o Formula menu (visible only in Formula View, when the toggle button has been selected)
o Edit menu
o View menu
o Window menu
o Help menu
• Toolbar buttons
• Report Tree or PI Tree
• Frame for the report charts or tables
• Status bar

• For instructions on how to use Report Wizard, see:


o Report creation - first Report Wizard window
o Performance Indicator Selection - second Report Wizard window
o Dimension Selection - third Report Wizard window
o Report Visualisation options - fourth Report Wizard window
o Report Scheduling options - fifth (optional) Report Wizard window

• For instructions on how to use Formula Wizard, see:


o Create a Formula or select a Formula to edit- first Formula Wizard window
o Define the Calculation Rule for the Time Dimension - second Formula Wizard window
o Define the available Dimensions - third Formula Wizard window

• For instructions on how to search the PI Tree, see Find tab.

• For instructions on how to use the Node Permission window, see:


o Node Permissions window (Private/Public)
o Node Permissions window (Role-based)

You can also use some shortcuts in Report Builder and you can also select several nodes in the Report Tree and the
PI Tree and execute an operation on all of them:

• Shortcuts
• Operations on multiple nodes
• 7.1 File menu

Menu item Description...


Save as Opens the Save as dialog in which you can select the target folder for the graphic
file or excel when you are exporting a chart or a table from Report Builder.

Print... (Ctrl-p) Opens the Print dialog to print the table or chart in the right-hand frame.
Exit Exits the application.

7.2 Report menu

This menu is not visible in Formula View.


Menu item Description...
New Starts Report Wizard with an empty template for creating a new report.
Edit Starts Report Wizard with the information of the report that you have selected in
the Report Tree.

Performance Indicator Selection... Opens the second window of Report Wizard in which you can select which PI/KPIs
(F9) you want to include in your report.
For instructions, see Modifying reports.
Dimension Selection... (F11) Opens the third window of Report Wizard which displays the PI/KPIs that you have
selected for your report. You can change the settings for the PI/KPIs in all
dimensions.
Report Visualisation... (F12) Opens the fourth window of Report Wizard in which you can sort the data to be
included in the report and define the basic properties of your report chart and
table, for example style definitions and titles.
Report Scheduling Opens the fifth (optional) window of Report Wizard in which you can specify when
and with what frequency Report Builder generates the report and stores it into the
cache.
Description... Opens a dialog in which you can see and if you have sufficient permission, modify
the description of the report.

Show Report F6 Displays the report both as a chart and a table.


For instructions, see Displaying reports.
Displays the report as a chart.
Show Chart F7 For instructions, see Displaying reports.
Displays the report as a table.
Show Table F8 For instructions, see Displaying reports.
Show SQL Opens a window which displays the SQL query associated with the report. The
SQL information is mainly of interest to Report Builder administrators who need to
debug, for example to determine why a certain report in Reporter Builder does not
work or does not produce the expected results.
Displays the active report or updates it by enforcing a query from the database.
Enforce Query F5 The cached version of the report is overwritten. The Enforce Query functionality is
only available if you have the licence for the optional caching and scheduling
feature.
For instructions, see Displaying reports.
Permissions... Opens the Node Permission window in which you can check and if you have
sufficient permissions, modify the permissions of a node in the Report Tree.
For instructions, see Managing permissions.

7.3 Formula menu

This menu is not visible in ReportView.


Menu item Description
New Starts Formula Wizard with an empty template for creating a new formula.
Edit Starts Formula Wizard with the information of the formula that you have selected in
the PI Tree.

Description... Opens a dialog in which you can see and if you have sufficient permission you can
modify the description of the formula.
Time Dimension Opens the second Formula Wizard window. You can see the time dimension
settings of the formula and if you have sufficient permissions, you can also modify
the time aggregation rule for the formula.
Other Dimension Opens the third Formula Wizard window. You can see the various dimension
settings of the formula and if you have sufficient permissions, you can also modify
the settings.
Permissions... Opens the Node Permission window in which you can check and if you have
sufficient permissions, modify the permissions of a node in the PI Tree.
For instructions, see Managing permissions.

7.4 Edit menu

Menu item Description


Copy (Ctrl-c) Allows you to copy any Reporter nodes except folders.
Paste (Ctrl-v) Allows you to paste any Reporter nodes except folders.
Allows you to delete Reporter nodes (except pre-defined or locked reports and
Delete (Delete) PI/KPIs).
Allows you to rename Reporter nodes (except pre-defined or locked reports and
Rename PI/KPIs).

7.5 View menu

Menu item Description


Report View Toggles to Report View. When you start Report Builder, Report View is displayed
by default.
Formula View Toggles to Formula View.

7.6 Window menu

Menu item Description


Cascade Displays the charts and tables on top of each other in cascading style for all the
reports that you have opened. When you open any first report, the chart and the
table are displayed in cascading style by default even if earlier reports were
displayed in the horizontal or vertical tiling style.
Tile Horizontally Displays all the charts and tables in horizontally divided panes next to each other
for all the reports that you have opened so far.
Tile Vertically Displays all the charts and tables in vertically divided panes below each other for
all the reports that you have opened so far.
Close all Closes all the charts, tables or dialogs that you have opened earlier in the right-
hand frame of the Report Builder GUI.

7.7 Help menu

Icon Description
Contains instructions on how to use Report Builder and a description of the user
Help Topics... (F1) interface components.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with
the F1 key but with the Alt-h key combination from the Report Wizard and Formula
Wizard windows.
About Opens a window that provides information on Report Builder releases, builds, and
contacts.

7.8 Toolbar buttons


Button Description
Toggle between Report View and Formula View. One of the two icons is always enabled, the
other is disabled.
Calls the Report Wizard to create a report. The first of the four Report Wizard windows opens.
(Ctrl-n) Not visible in Formula View.
For instructions, see Report Wizard.
Calls Formula Wizard to create or edit a formula. The first of the three Formula Wizard
(Ctrl-n) windows opens. Not visible in Report View.
Creates a new URL node. Opens a list where you can select to create a new URL or a new
(F4) folder. Not visible in Formula View.
Depending on the active View and the type of the node that you have selected in the Report
Tree or PI Tree, calls Report Wizard to edit the report, the URL properties window to modify
the URL, or Formula Wizard to edit the PI/KPI or formula.
A file browser opens where you can select or create a folder in which to save your chart or
table.

• The chart is saved as a graphic in portable network graphic (.png) format. You can
use the chart for further processing, for example, integrating into a Microsoft Word
document or viewing in a Web browser.
• A file browser opens where you can select or create a folder in which to save your
table. The table is saved as tabular data in .xls file format. This format allows the
file to be displayed in applications such as Microsoft Excel.
For information on exporting in other file formats, see How can I ensure that the
column structure is preserved in a file that I export?.

(Ctrl-p) Opens the Print dialog which allows you to print a table or chart selected in the Report view.
Displays the chart of the selected report.
(F7) For instructions, see Displaying reports. Not visible in Formula View.
Displays the table of the selected report.
(F8) For instructions, see Displaying reports. Not visible in Formula View.
Displays a selected report or updates an existing report by enforcing a query from the
(F5) database. Prior cached versions are overwritten. The Enforce Query functionality is only
available if you have the licence for the optional caching and scheduling feature.
For instructions, see Displaying reports.
Depending on the active View and the type of the node that you have selected in the Report
Tree or PI Tree, opens the Node Permission window in which you can check and if you have
sufficient permissions, modify the permissions of a node.
Renames the selected Reporter node (folder, report, URL, PI/KPI, or formula.

Deletes a selected folder, report, URL, or PI/KPI.


(Delete)
Opens Report Builder Online Help.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key
but with the Alt-h key combination from the Report Wizard and Formula Wizard windows.

.9 Report Tree and PI Tree

Icon Description
Unexpanded folder for reports or URLs
Expanded folder for reports or URLs
Folder for which you have Read permission and therefore you cannot edit. For example, all the
default report sets delivered with Report Builder are read-only reports
Unexpanded folder for PIs or formulas
Unexpanded folder for PIs or formulas
Report
Scheduled report. Report scheduling is only available if you have the licence for the optional caching
and scheduling feature.
Non-editable report. The padlock often indicates a Nokia default report. These reports are
predefined, non-editable reports delivered to you by Nokia. You can modify the permission of a
default report but cannot make it editable. For more information, see Managing permissions.
URL link to a report. For information, see Defining and using URLs.
PI/KPI
Non-editable PI/KPI
Customer defined formula
Non-editable customer-defined formula

7.10 Frame for report charts and tables

On the upper right corner of the window you can see the following three icons:

• Click the first icon to reduce the window to an icon in the bottom of the Report view.
• Click the second icon to enlarge the window to fill the Data View area.
• Click the third icon to close the report Description window.

The icon next to the report title has the same effect as the second icon.

If the table is selected, the sort order of a column may be reversed by clicking the column title. If you click a column
title and holding the mouse button, the position of the column in the table may also be changed.

Note!
The column changes in the display do not affect the data model on which the table is based.

7.11 Status bar

The status bar consists of the following components:

• Activity bar indicating calculations through continuous movement. For example, the pasting phase can take
long when you copy a report with the Copy and Paste menu commands or the Ctrl-c and Ctrl-v shortcuts.
The activity indicator is running until copying is finished.

• Activity message displayed during a certain activity, for example, Fetching report....
• 7.12 Local context menus

Folders:

Context menu item Description

New -> Report Ctrl-n Starts Report Wizard with an empty template for creating a new report.

New -> Folder Ctrl-Alt-n Creates a new folder in Report Tree.


Creates a new URL node in the Report Tree and opens the Properties
New -> URL F4 dialog in which you can enter the address and other details for the
URL.
Deletes the selected folder node(s) from the Report Tree.
Delete Ctrl-x Not available for .
Allows you to enter a new name for the folder node within the tree.
Rename Not available for .
Opens the Node Permission window in which you can check and if you
have sufficient permissions, modify the permissions of a node in the
Permissions...
Report Tree.



Reports and URLs:

Context menu item Description


Show Report F6 Displays the report both as a chart and a table in the right-hand frame.

Show Chart F7 Displays the report as a chart in the right-hand frame.

Show Table F8 Displays the report as a table in the right-hand frame.


Opens a window which displays the SQL query associated with a
selected report. This operation is mainly of interest to Report Builder
Show SQL
administrators who need to debug, for example, why a certain report in
Reporter Builder does not work or does not produce the desired result.
Displays a selected report or updates an existing report by enforcing a
query from the database. Prior cached versions are overwritten. The
Enforce Query functionality is only available if you have the licence for
Enforce Query F5
the optional caching and scheduling feature.
For instructions, see Displaying reports.
Allows you to copy a report. For more information, see Defining new
Copy Ctrl-c
reports.
Allows you to delete the report from the Report Tree.
Delete Ctrl-x Not available for , , or .
Allows you to change the name of the report.
Rename Not available for , , or .

Report Wizard (Ctrl-n) Starts Report Wizard with an empty template for creating a new report.
Opens a window in which you can select the PI/KPIs you want to
Performance Indicator Selection... F9 include in your report.
For instructions, see Modifying reports.
Dimension Selection... F11 Opens a window which displays the PI/KPIs that you have selected for
your report. You can change the settings for the PI/KPIs in all
dimensions.
For instructions, see Modifying reports.
Opens a window in which you can sort the data to be included in the
report and define the basic properties of your report chart and table
Report Visualisation... F12
(for example, style definitions and titles).
For instructions, see Modifying reports.
Opens a window in which you can schedule cacheable reports or
modify the schedules for a scheduled report.
Report Scheduling...
For information, see Report Scheduling options - fifth (optional) Report
Wizard window.
Opens a dialog for the report in which you can use to describe the
characteristics of the report.
Description...
For instructions, see Displaying properties of reports, PI/KPIs, and
formulas.
Opens the Node Permission window in which you can check and if you
have sufficient permissions, modify the permissions of a node in the
Permissions... Report Tree.
For instructions, see Managing permissions.



PI/KPIs and formulas:

Context menu item Description


Allows you to copy a report. For more information, see Defining new
Copy Ctrl-c reports.
Available only for formulas, not available for PI/KPIs.
Deletes the node(s) from the PI Tree.
Delete Ctrl-x Not available for and .
Allows you to enter a new name for PI Tree node within the tree.
Rename Not available for and .
Opens a dialog for the PI/KPI or formula in which you can use to
describe the characteristics of the report.
Description...
For instructions, see Displaying properties of reports, PI/KPIs, and
formulas.
Opens the Node Permission window in which you can check and if you
have sufficient permissions, modify the permissions of a node in the PI
Tree.
Permissions...
For instructions, see Managing permissions.
Available only for formulas, not available for PI/KPIs.

7.13 Node Permissions window (Private/Public)

If you are using the Private/Public approach to assign permissions, the Node Permission window contains the
following components.

• Node Information
• Permission Type pane
• Buttons

Node Information
The top part of the Node Permission provides the following information about the node to which you are assigning
permission:
• Node Name
The name of the node.
• Node Owner
The owner of the node, that is, the user who created it.
• As Inherited checkbox
Shows whether the permission is inherited from the parent node.

Permission Type pane


This pane consists of three radio buttons:

• Private
Only you have access to the node. Private automatically means Modify access to the node.

• Public Read
Every user who can launch Report Builder can see the node but they cannot modify it.

• Public Modify
Every user who can launch Report Builder can see and modify the node.

Note!
The restrictions do not apply when an administrator user, that is, a user with APP_SC_REPORTER.ADMIN
permission in Nokia NetAct, is using Report Builder. Administrators can view, modify, or delete any node in the
Report Tree or in the PI Tree with the exception of the pre-defined reports or built-in PI/KPIs.

Buttons
The Node Permissions window contains the following buttons:

Button Description
Ok Closes the Node Permissions window and saves the changes.
Cancel Cancels any changes that you have made and closes the Node Permission window.
Provides information on the Node Permissions window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

7.14 Node Permissions window (Role-based)

If you are using the Role-based approach to assign permissions, the Node Permission window contains the following
components.

• Current Permissions pane


• Buttons

Current Permissions pane


This pane consists of columns headed as follows:

• Role
This column lists all the roles that have been defined with NetAct Permission Manager.
• No Access, Read, Modify
These three columns cover all possible permissions. You can select only one permission at a time with the
radio buttons:
o No Access
Users who are assigned the role cannot see the node when they log into Report Builder.
o Read
Users who have Read permission to the node can see it when they log into Report Builder.
o Modify
Users who have Modify permission to the node can see and modify it when they log into Report
Builder.

• As Inherited checkboxes
Shows whether the permission is inherited from the parent.

Note!
The restrictions do not apply when an administrator user, that is, a user with APP_SC_REPORTER.ADMIN
permission in Nokia NetAct, is using Report Builder. Administrators can view, modify, or delete any node in the
Report Tree or in the PI Tree with the exception of the pre-defined reports or built-in PI/KPIs.

Buttons
The Node Permissions window contains the following buttons:

Button Description
Ok Closes the Node Permissions window and saves the changes.
Cancel Cancels any changes that you have made and closes the Node Permission window.
Provides information on the Node Permissions window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

For more information, see Managing permissions.

7.15 Find tab

You can specify the search criteria with the Find tab that is visible in several Report Wizard and Formula Wizard
windows.

For instructions on how to execute a search, see Searching.


Item Description
Radio buttons to filter Report Builder finds all the reports that match the search string and also those that contain
the search result nodes (PI/KPIs or formulas) that match the search string. However, you can choose to list only
the reports or all of the nodes.

• Select Reports name if you want to see all the nodes in the Report Tree whose
name is a match for the search string.
• Select Reports referencing PI if you want to know which reports include the
component whose name is a match for the search string.
These buttons are only visible on the Find tab in Report View and you can use them to check
in Report Tree in which report they are used before you remove or modify them.

(search icon) Enter in the search field the search criteria for the item that you want to find, and click or
press Enter to start the search.
Note!
Report Builder searches for an exact string by default. When you search for substrings, you
can use the asterisk (*) as a placeholder for one or more characters. No other wildcards are
supported in the search.
Max. Results Select a maximum number of results you want displayed. The overall maximum is 80 results.
The default is 50 results.
Case Sensitive
Check this box to ensure the search results exactly match the search criteria.
checkbox
Search results pane Displays the list of results matching the search criteria.
Search Level This field is only present when searching dimension selections (other than the time
dimension). Select the MO level at which you want the search to be performed.

7.16 Shortcuts

You can use shortcuts in Report Builder to perform several actions that you perform from the Menu bar or from the
local context menu:
Ctrl-s
Saving.

Ctrl-p
Printing.

Ctrl-n
Creating a new report or formula by launching Report Wizard from the Report Tree or Formula Wizard from
the PI Tree, respectively.

Ctrl-Alt-n
Creating a new folder.
Ctrl-c
Copying.

Ctrl-v
Pasting.

Ctrl-x
Deleting.
Note!
Ctrl-x is not the combination of Ctrl-c and Ctrl-v in Report Builder.

Clicking a selected note again


Making a node name editable for renaming in the Report Tree or in the PI Tree.

Double-clicking a node
Expanding a folder or opening the report in Report Wizard, a PI/KPI or formula in Formula Wizard, or the
description dialog for an URL.

Drag&Drop
Selecting a report in Report Tree and dragging it onto the Report view pane of the Main Window, or
selecting a PI or formula in PI Tree and dragging it into the Time Aggregation Rule or Selector panes in
Formula Wizard.

7.17 Operations on multiple nodes

You can execute some operations on several nodes at the same time:

• Description
Activated from the Menu bar (Report -> Description or Formula -> Description) or from the local context
menu, it opens the description dialog for all the nodes that you have selected.

• Show SQL
Activated from the Menu bar (Report -> Show SQL) or from the local context menu, it opens the SQL dialog
for all the selected reports.

• Delete
Activated from the Menu bar (Edit -> Delete) or from the local context menu, it deletes he selected nodes.
.

When you select several nodes to execute the same operations on them, the context menus show only the
operations that you can execute on all of the nodes. For example, when you select a report and an URL or a report
and a report component in the Report Tree, only the Delete operation is available, Show SQL is not included in the
context menu.

8 REPORT WIZARD

Report Wizard consists of four windows (five if you have the licence for the optional caching and scheduling feature).
If you do not use all the options, Report Builder assumes default values.

1. Start Report Wizard:


o Select Report -> New Report Ctrl-n from the menu bar.
o Click the (Report Wizard) icon in the Toolbar.
o Press the Ctrl-n keys.

The first Report Wizard window opens.


Note!
Report Wizard opens in Create or Edit mode depending on the permission of the node (folder or report)

which you have selected. In Create mode, the three button icons in the top-right corner ( , , and
) are enabled, in Edit mode, the icons are disabled. For information on the icons, see Report creation - first
Report Wizard window.

2. In the first Report Wizard window, define the name of your report and select its location in the Report Tree. If
you want to add a new folder, also define the folder name.

3. Expand the Report Tree on the left hand side with a double-click.
4. Select the folder for the new report. Enter the name of the new report in the Report Name field.

5. In the window, you can also add a description of the report. The window can contain up to 4000 characters
of text. The window may also contain, for example, HTML links that you can see in Report Browser. The
HTML code is displayed with HTML tags as a source code in Report Builder. Click Save to store the
description.

6. Click Next. The second Report Wizard window opens.

Note!
Steps 7 to 9 provide the same functionality as described in Modifying reports, but the wizard provides
additional buttons for navigating through the wizard itself.

7. In the second Report Wizard window, you can select the PI/KPIs for your report. To add or remove PI/KPIs:

o To add PI/KPIs, follow steps 1 to 3 in Modifying reports.


o To remove PI/KPIs, follow steps 1 and 2 in Modifying reports.

By right-clicking the PI/KPIs, you can use the Description window for further information.

After you have selected the PI/KPIs for your report, click Next. The third Report Wizard window opens.

8. In the third Report Wizard window, you can select the dimensions for your report. For instructions, follow
Modifying reports.

After you have selected the dimensions for your report, click Next. The fourth Report Wizard window opens.

9. In the fourth Report Wizard window, you can select the report visualisation options. For instructions on
selecting these options, follow Modifying reports.

10. (OPTIONAL) Define the scheduling parameters for the report.


Note!
The scheduling feature is optional and you need a licence for it.
For more information, see Caching and scheduling reports.

11. View the report. For more information, see Displaying reports.

12. Click Finish.

The new report appears in the Report view of the main Report Builder window.

.1 Report creation - first Report Wizard window

In this window, you define the name of your report or folder and select its location in the Report Tree.

For more information, see Report Wizard.

The first Report Wizard window consists of the following components:

• Report Name field in which you can enter the name of the new report.
• Create In pane that shows the Report Tree for you to select to position of the new report.
• Description pane in which you can provide additional information about the report.
• Buttons

Button Description
Adds a new folder into a selected folder in the Report Tree pane. The new folder is selected and you
can edit its name.
Allows you to rename a selected folder or report in the PI Tree pane.

Allows you to delete a selected folder or report from the PI Tree pane.
Closes the first Report Wizard window and opens the second one. The name of the new folder or
Next
report is added to the Report Tree in the Report Builder main window.
Cancel Closes Report Wizard window and cancels all the changes you made in this window.
Provides information on this Report Wizard window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

8.2 Performance Indicator Selection - second Report Wizard window

In this window, you can add, remove, or modify PI/KPIs for a selected report.

The Performance Indicator Selection window consists of the following components:

• Tree tab that shows the PI Tree.


• Find tab that allows you to search for a PI/KPI or formula in the PI Tree. This tab is also available in other
windows. For information, see Find tab.
• Selected Performance Indicators pane
o shows the original name of the PI/KPIs (PIs)
o shows the name of the PI/KPI used inside this particular report (Refer to as...)
o shows whether the PI/KPI is calculated from the measurement tables according to the PI/KPI
definition or whether the data is fetched from the raw or the aggregated measurement tables
(Agg.Choice).
• PI tables pane that is visible only for basic PIs and lists all the measurement tables in which the PI is
included: all the tables of different aggregation levels, for example Raw, Day, Week are visible. This pane
allows you to check that you have selected the correct PI for the report.

Note!
By default, the reports that you create in Report Builder fetch the data from the raw or from the aggregated
measurement tables according to the definition of the PI/KPI or formula. For instructions on how to determine the
system settings for the PI/KPI, see How can I check which summary method is used by a report?
You can, however, override the system settings for a PI/KPI in reports - similarly to the report-specific renaming of a
PI/KPI in a report in the Refer to as... field:

• System:
Default setting to follow the PI/KPI definition whether the data is fetched from the raw or from the aggregated
measurement tables.
Reports that you have created earlier and default reports delivered by Nokia always use the System setting.
.
• Raw
The PI/KPI is calculated with the data fetched from the raw measurement tables when the report is
generated.
• Agg
The PI/KPI is calculated with the data fetched from the aggregated measurement tables when the report is
generated.

When the report is generated, the query engine checks all the raw and aggregated measurement tables, filters the
results according to the setting of the Agg.Choice column and uses only the raw or aggregated data for calculating
the value of the PI/KPI.
If the table for, for example, aggregated data is empty, an empty chart is displayed in Report Builder and Report
Browser. If the table is not found, Report Builder and Report Browser display an error message.

Note!
The modifications that you perform in Report Builder for a PI/KPI in a particular report do not have any impact on the
aggregation settings for NetAct. For information on administering aggregations at the NetAct level, see Reporter
Admin Toolkit Online Help.

Note!
Same PI/KPI can be added more than once and the steps are as follows:

• Select the PI/KPI which you want to add more than once from the list of available performance
indicators,click on the ADD button to add it to the Selected Performance Indicators
• The PI/KPI gets added and the ADD button gets disabled
• Select some other PI/KPI
• Now select the already added PI/KPI, ADD button will be enabled again. Click on the ADD button to add it to
Selected performance indicators.

Button Description
Adds the PI/KPI(s) selected in the Available Performance Indicators pane to the Selected
Performance Indicators pane. The selected PI/KPI appears also in the Report Tree in the Report
Builder main window under the report name.
Removes the selected PI/KPI(s) from the Selected Performance Indicators pane. The selected
performance indicator is removed also from the Report Tree in the Report Builder main window
under the report name.
Ok (Not visible when you are using Report Wizard).
Closes the Performance Indicator Selection window.
Cancel Cancels your current action and closes the Performance Indicator Selection window.
Provides information on this Report Builder window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.
(Visible only when you are using Report Wizard). Closes this Report Wizard window and opens the
Next
next one.
(Visible only when you are using Report Wizard).
Finish
Closes Report Wizard. A report is created in the Report Tree with default values for the report
properties, for example the Time and other dimensions, that you have not specified.

8.3 Dimension Selection - third Report Wizard window


In this window, you can define and edit time and other dimension selections for selected PI/KPIs.

The Dimension Selection window consists of the following components:

• Selected PIs pane that contains all the PI/KPIs and formulas that you have selected in the second window
of Report Wizard.
• BH checkbox in the Selected PIs pane for each PI/KPI for which BH is available.
BH is only available under certain conditions. For more information, see Why I do not get the Busy Hour
option when creating some reports? for further details.
• Time dimension tab
• Other dimensions tab that contains the tree and the Find tab
• Buttons

Button Description
Ok (Not visible when you are using Report Wizard)
Closes the Dimension Selection window and confirms all the changes you have made.

Cancel Cancels your current action and closes the Dimension Selection window.

Provides information on this Report Builder window.


Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.
(Visible only when you are using Report Wizard).
Back
Opens the previous Report Wizard window.

(Visible only when you are using Report Wizard).


Next
Closes this Report Wizard window and opens the next one.

(Visible only when you are using Report Wizard).


Finish
Closes Report Wizard.

Find Tab in Dimension Selection


You can specify the search criteria with the Find tab that is visible in Dimension Selection window.

Item Description

(search icon) Enter in the search field the search criteria for the item that you want to find, and click or
press Enter to start the search.
Note!
Report Builder searches for an exact string by default. When you search for substrings, you
can use the asterisk (*) as a placeholder for one or more characters. No other wildcards are
supported in the search.
Max. Results Select a maximum number of results you want displayed. The overall maximum is 80 results.
The default is 50 results.
Case Sensitive
Check this box to ensure the search results exactly match the search criteria.
checkbox
Search results pane Displays the list of results matching the search criteria.
Search Level This field is only present when searching dimension selections (other than the time
dimension). Select the MO level at which you want the search to be performed.

1. Enter the search criteria of the managed object for which you want to search.
Select a search level, for example, 'BSC'.

2. Select the maximum number of search results you want to display.

3. Start the search:

o Click the (Search) icon


or
o press Enter.

4. The search result pane displays the list of managed objects that matches the search criteria and for which
you have read permission. A search result displays the name of the item and its type represented as an
icon. The pathname of the item is shown at the bottom of the pane. If the pathname is not completely visible,
use the Tooltip to display the full name.

5. Select one or more managed objects from the search results that you want to include in the report and click
the (Add) icon to put them in the report. You can use drag-and-drop to perform the same operation.

8.4 Time dimension tab

Item Description
Hierarchy option list Allows you to select the hierarchy for the time dimension summary levels, Start Time
(Month) or Start Time (Week).
Summary Level option list Allows you to select the summary level for the selected PI/KPI(s). If you select monthly
hierarchy from the Hierarchy option list, the summary levels available are:
All/Year/Quarter/Month/Day/Hour/Raw.
Note!
The 'raw' summary level mostly describes measurements on quarters of hours (15
minutes).
If you create a formula, combining two facts of which the first exists only on monthly
level (or higher) and the second on hourly level, the smallest summary level for this
formula can only be 'month' (and not below).
BH is only available under certain conditions. For more information, see Why I do not get
the Busy Hour option when creating some reports? for further details.
If you select weekly hierarchy from the Hierarchy option list, the summary levels
available are: All/Year/Week/Day/Hour/Raw.
Time Frame Selection pane The pane includes two options:

• Absolute
• Relative

Absolute
If you click the Absolute option, From and To buttons and entry fields appear in the
Time Frame Selection pane.
From opens a calendar from which you can select the start date for the time period from
which the data is included in your report.
To opens a calendar from which you can select the end date for the time period from
which the data is included in your report.

Relative
If you click the Relative option, the Length entry field and option list, End Point option
list, and a calendar appear in the Time Frame Selection pane.
Note!
Before you can use the calendar, you have to select Absolute in the End Point option
list.

The Length option list includes the following time periods:

• Minutes
• Hours
• Days
• Weeks
• Months

In the Length entry field you can enter a number (for example, if you want the length of
the time period be 1 month, enter 1 to the entry field and select Month from the Length
option list).

The End Point option list includes the following options:

• Current Time
• Last Night at Midnight
• Previous Weekend
• End of Previous Month
• Absolute (to select an end date and time)

Day Selection pane This pane includes:

• Day boxes (Mon - Sun)


• Select All button
• Clear Selection button

Hour Selection pane This pane includes:

• Hour boxes (0 - 23)


• Select All button

• Clear Selection button

8.5 Other dimension tabs

The selection of dimensions tabs depends on the selection of measurements. Other dimensions can include, for
example, Network or Clear Code. For information on the Time dimension tab has other components, see Time
dimension tab.

Item Description
Hierarchy option list Allows you to select the hierarchy for the summary levels. The selection of this list
depends on the dimension.
Summary Level option list Allows you to select the summary level for the selected PI/KPI(s). The contents of the list
depend on the selection made in the Hierarchy option list.
List Type options If you click an option, you can either Include the selected objects in your report or
Exclude the selected objects from it.
List of available objects A list of available objects ( ) which differs according to dimensions. You can select the
objects to be either included in your report or excluded from it depending on whether you
select Include or Exclude in the List Type options.
List of selected objects A list of objects that you have selected from the list of available objects. These objects
are either included in your report ( ) or excluded from it ( ) depending on whether
you select Include or Exclude in the List Type options. You can either use the and
icons to compile the Selected list or you can drag and drop objects between the list
of available objects and the Selected list.

8.6 Find dimension Tab

You can specify the search criteria with the Find tab that is visible in Dimension Selection window.

Item Description

(search icon) Enter in the search field the search criteria for the item that you want to find, and click or
press Enter to start the search.
Note!
Report Builder searches for an exact string by default. When you search for substrings, you
can use the asterisk (*) as a placeholder for one or more characters. No other wildcards are
supported in the search.
Max. Results Select a maximum number of results you want displayed. The overall maximum is 80 results.
The default is 50 results.
Case Sensitive
Check this box to ensure the search results exactly match the search criteria.
checkbox
Search results pane Displays the list of results matching the search criteria.
Search Level This field is only present when searching dimension selections (other than the time
dimension). Select the MO level at which you want the search to be performed.

1. Enter the search criteria of the managed object for which you want to search.
Select a search level, for example, 'BSC'.

2. Select the maximum number of search results you want to display.

3. Start the search:

o Click the (Search) icon


or
o press Enter.
4. The search result pane displays the list of managed objects that matches the search criteria and for which
you have read permission. A search result displays the name of the item and its type represented as an
icon. The pathname of the item is shown at the bottom of the pane. If the pathname is not completely visible,
use the Tooltip to display the full name.

5. Select one or more managed objects from the search results that you want to include in the report and click
the (Add) icon to put them in the report. You can use drag-and-drop to perform the same operation.

.7 Report Visualisation options - fourth Report Wizard window

In this window, you can edit report settings and decide how the data is grouped when a table or a chart is created.

The Report Visualisation window consists of the following components:

• Type tab
• Axis tab
• Chart Data tab
• Table Data tab
• 8.8 Type tab

The Type tab defines TopN reports. A TopN report displays a list of a selected number 'N' of the largest or
smallest values in the range. TopN reports are reports with no time series. For example, a report may show
the 10 BSC's with the most traffic or the most counted Clear Codes. For more information, see Defining
TopN reports for more details.
Note: The TopN report feature can only support a single PI/KPI. If the PI selection contains more PIs than
the one selected, the others are ignored.
Even if a TopN (for example, Top20) report produces only N (20) values, the database processing has to
handle the whole query.

The following figure is an example showing the top 10 (Top10) Clear Codes as a bar chart.

Item Description
TopN option list You can enter a number which limits the report to displaying the number of highest or lowest
values. A drop down menu offers you a selection of the top or bottom 10, 20, 30... 100 values
selected for your report. The default is 'Unlimited' meaning all values are selected, in which
case no PI/KPI option is available. The report shows the highest or lowest Top-N values
depending on the setting of the Filter For option.

Select PI/KPI option You can select which PI/KPI is to be affected by the TopN range. Only one PI/KPI can be
list selected. The default is 'Unlimited', meaning that no PI/KPI is selected.

Note!
If TopN is activated, a selection must be made.

Filter For option list You can select Lowest Values (Descending) or Highest Values (Ascending), depending on
whether you want the highest or lowest TopN values displayed in the report. If the PI/KPI
option is 'Unlimited', no choice is made available.

Buttons
Ok (Not visible when you are using Report Wizard).
Closes the Report Visualisation window.

Cancel Cancels your current action and closes the Report Visualisation window.

Provides information on this Report Visualisation window.

(Visible only when you are using Report Wizard).


Back
Opens the previous Report Wizard window.

(Visible only when you are using Report Wizard).


Finish
Closes Report Wizard.

8.9 Axis tab

The Axis tab consists of the following components:

Primary Y-Axis pane

Item Description
Performance Indicators pane This pane contains a list of PI/KPIs included in your report. You can move these PI/KPIs
from the Primary Y-Axis to the Secondary Y-Axis (or vice versa) by selecting them from
the list and clicking the and icons between the two panes. You can perform the
same operation with drag-and-drop.

Chart Type menu This drop-down menu allows you to select the style of your chart from the following
options: Plot, Bar, Area, Pie, Candle, Hilo, Hilo open/close, Scatter plot.

Settings selection The settings consist of a Title text field and scaling options for the Y-Axis.

In the Title text field, you can enter a name and unit for the primary axis. By default, the
first value from the PI/KPIs list is displayed in this field.

The scaling options allow you to select a minimum value (Min. Value), a maximum
value (Max. Value) and a tick interval (Tick Intervals) for the Y-Axis. The tick interval
defines the interval between divisions on the axes. If you do not enter any values for the
scaling options and leave the fields empty, Report Builder automatically calculates
values for you.

Secondary Y-Axis pane

Item Description
Performance Indicators pane This pane contains a list of PI/KPIs included in your report. You can move these PI/KPIs
from the Primary Y-Axis to the Secondary Y-Axis (or vice versa) by selecting them from
the list and clicking the and icons between the two panes. You can perform the
same operation with drag-and-drop.

Chart Type menu This drop-down menu allows you to select the style of your chart from the following
options: Plot, Bar, Area, Pie, Candle, Hilo, Hilo open/close, Scatter plot.

Settings selection The settings consist of a Title text field and scaling options for the Y-Axis.

In the Title text field, you can enter a name and unit for the primary axis. By default, the
first value from the PI/KPIs list is displayed in this field.

The scaling options allow you to select a minimum value (Min. Value), a maximum
value (Max. Value) and a tick interval (Tick Intervals) for the Y-Axis. The tick interval
defines the interval between divisions on the axes. If you do not enter any values for the
scaling options and leave the fields empty, Report Builder automatically calculates
values for you.

Titles pane

This pane has two fields where you can enter text as follows:

• X-Axis: enter a name for the X-Axis.


• Chart: enter a name for the chart, the default is the report name.

Buttons
Button Description
Ok (Not visible when you are using Report Wizard).
Closes the Report Visualisation window.

Cancel Cancels your current action and closes the Report Visualisation window.

Provides information on this Report Visualisation window.

(Visible only when you are using Report Wizard).


Back
Opens the previous Report Wizard window.

(Visible only when you are using Report Wizard).


Finish
Closes Report Wizard.

8.10 Chart Data tab

The chart data settings determine the data structure and layout of the chart. The appearance depends on the choice
of chart type and is colour-coded for easier use. For some typical examples of tables, see Chart and Table Data
Examples. The first example shows a series of graphs plotted over time for signal loading on two Base Transceiver
Stations (BTS1 and BTS2).

Item Description
Y-Axis Display one You can define how the dimensions appear in the chart. There is one data series (one plot on
Data Series per pane the graph) displayed per list of dimensions selected. The Move Up and Move Down buttons
allow you to modify the order of the dimensions in the pane. The and icons are used to
move dimensions in and out of the X-Axis Display pane. You can perform the same operation
with drag-and-drop. A typical chart, reflecting the settings in the pane, is displayed below the
pane.

Example: In the first chart shown, the dimension Network Element holding BTS1 and BTS2
and the dimension Type holding Downlink, Signalling, and Uplink are placed in the 'One Data
Series' per list. Data series are built for BTS1-Downlink, BTS1-Signalling, and BTS1-Uplink
and similarly for BTS2-Downlink, BTS2-Signalling, and BTS2-Uplink.

X-Axis Display pane You can define the dimensions used for the X-axis of the chart. The Move Up and Move Down
buttons allow you to alter the order of the dimensions in the pane. The and icons are
used to move dimensions in and out of the Y-Axis Display one Data Series per pane. You can
perform the same operation with drag-and-drop. A typical chart, reflecting the settings in the
pane, is displayed below the pane. The generation of values for the X-axis works the same
way as for the generation of series.

Time Series Data You can define whether a time series should be completed if missing values are filled up by
Completion checkbox null values. For example, you could have data from the 1st, 2nd, and 4th day of the month, but
not from the 3rd day. If the Time Series Data Completion checkbox is enabled, the missing
day is still shown in your chart although the value is missing. If the checkbox is disabled, your
chart only shows those dates for which there is data.

Note!
The Time Series Data Completion checkbox is disabled by default. If you want to enable it,
select the checkbox.

Buttons
Ok (Not visible when you are using Report Wizard).
Closes the Report Visualisation window.

Cancel Cancels your current action and closes the Report Visualisation window.

Provides information on this Report Visualisation window.

(Visible only when you are using Report Wizard).


Back
Opens the previous Report Wizard window.

(Visible only when you are using Report Wizard).


Finish
Closes Report Wizard.

8.11 Table Data tab

The table data settings determine the data structure and layout of the table. The settings define what information is
applied to the columns and what information is applied to the rows. For some typical examples of tables, see Chart
and Table Data Examples.
Item Description
Columns - Display one You can define how the columns appear in the table. The Move Up and Move Down buttons
Column per pane
allow you to alter the order of the dimensions in the pane. The and icons are used to
move dimensions in and out of Rows - Display one Row per pane. You can perform the same
operation with drag-and-drop. A typical table, reflecting the column layout in the pane, is
displayed below the pane.

Example: In the first table shown, the dimension Network Element holding BTS1 and BTS2
and the dimension Type holding Downlink, Signalling, and Uplink are placed in the 'One Data
Series' per list. Data columns are built for BTS1-Downlink, BTS1-Signalling, and BTS1-Uplink
and similarly for BTS2-Downlink, BTS2-Signalling, and BTS2-Uplink.

Rows - Display one You can define how the rows appear in the table. The Move Up and Move Down buttons allow
Row per pane
you to alter the order of the dimensions in the pane. The and icons are used to move
dimensions in and out of the Columns - Display one Column per pane. You can perform the
same operation with drag-and-drop. A typical table, reflecting the row layout in the pane, is
displayed below the pane. The generation of values for a row works the same way as for the
generation of columns.

Time Series Data You can define whether a time series should be completed if missing values are filled up by
Completion checkbox null values. For example, you could have data from the 1st, 2nd, and 4th day of the month, but
not from the 3rd day. If the Time Series Data Completion checkbox is enabled, the missing
day is still shown in your chart although the value is missing. If the checkbox is disabled, your
chart only shows those dates for which there is data.

Note!
The Time Series Data Completion checkbox is disabled by default. If you want to enable it,
select the checkbox.

Buttons
Ok (Not visible when you are using Report Wizard).
Closes the Report Visualisation window.

Cancel Cancels your current action and closes the Report Visualisation window.

Provides information on this Report Visualisation window.

(Visible only when you are using Report Wizard).


Back
Opens the previous Report Wizard window.

(Visible only when you are using Report Wizard).


Finish
Closes Report Wizard.

8.12 Chart and Table Data Examples


Cols Per: [Network Element,Type]
Rows Per: [Time,]

Cols Per: [Type]


Rows Per: [Time,Network Element]

Cols Per: [Type]


Rows Per: [Network Element,Time]

Series Per: [Type,Network Element]


XAxis Order: [Time]
Chart Type: PLOT
Series Per: [Type]
XAxis Order: [Time,Network Element]
Chart Type: BAR

Series Per: [Type]


XAxis Order: [Network Element,Time]
Chart Type: BAR

8.13 Report Scheduling options - fifth (optional) Report Wizard window

In this window, you can define the settings for a scheduled report.
The Set Scheduling Parameters window consists of the following components:
Note!
The parameters become visible only when you have ticked the Scheduled checkbox.

• Scheduled checkbox

• Scheduling Time Interval option list

• Generation Time option list

• Email Addresses text field

Scheduling Time Interval option list

You can select the frequency of the report generation.


Match this interval with both the time settings of the report and the frequency with which you evaluate it. For example,
if you schedule a report on a daily interval but only access it once a month, you put an unnecessary load on the
system.

The following interval options are available:

• Daily
• Weekly
• Biweekly
• Monthly

Note!
The cache in which the cached reports are stored is cleaned up by an automated process every midnight. The
cleanup process removes the expired cached reports and performs cache tablespace supervision. When the size of
the cache exceeds its limit, a warning message is logged and reminds the system administrator to increase the cache
tablespace. For more information on the cache, see Caching and scheduling reports.

Generation Time option list

The options in the Generation Time list depend on which scheduling time interval (Daily, Weekly, Biweekly, or
Monthly) you have selected in the corresponding list.

• If you have selected the Daily scheduling time interval, you can select only the hour of the day when the
report is generated from the Time list.

• If you have selected the Weekly or Biweekly scheduling time interval, you can select the hour of the day
when the report is generated from the Time list and the day of the week from the Day of Week list.
Note!
If you schedule the report as a biweekly report, Reporter generates it on the selected day of every odd
calendar week.

• If you have selected the Month scheduling time interval, you can select the hour of the day when the report
is generated from the Time list and the day of the week from the Day of Month list.
Note!
You can only select a day between the 1st and the 28th of the month, or the last day of the month.

Note!
There is a black-out timeslot for scheduling reports between 12 AM and 3 AM. Scheduling is not allowed during this
time because this is the usual time of the day during which new measurements arrive and could cause validity
problems for the freshly generated reports. Otherwise, Reporter does not check the generation time that you select in
this field. It is recommended that you set up scheduled reports to be generated during the night. Contact your NetAct
System Administrator for information on time-slots that are suitable for scheduling because of low system load.

Email Addresses text field

You can specify e-mail addresses to which Reporter sends a notification when a scheduled report has been
generated.
• You can enter several e-mail addresses at the same time if you separate them by a comma in the Email
Addresses field.

• You can remove several e-mail addresses at the same time if you highlight them and click the Remove
button.

9 FORMULA WIZARD

You can define new formulas and edit existing formulas with Formula Wizard. Formula Wizard consists of three
windows.

1. Start Formula Wizard:


o Select Formula -> New -> Formula Ctrl-n from the menu bar.
o Click the (Formula Wizard) icon in the Toolbar.
o Press the Ctrl-n keys.

The first Formula Wizard window opens.

In this window, you can select which formula you want to edit or insert a new formula in the PI Tree.

2. Change the permission of an existing formula if necessary:


o For instructions on how to modify permissions in the Private/Public permission mode, see
Assigning permissions with the Private/Public approach.
o For instructions on how to modify permissions in the Role-based permission mode, see Assigning
permissions with the Role-based approach.

For information on permissions, see Managing permissions.

3. Expand the PI Tree by double-clicking it.

4. Depending on whether you want to edit or insert a new formula:


o Highlight the formula that you want to edit. Click Next and go to step 8.
o Insert a new formula by highlighting the folder in the PI Tree.
5. Enter a name for the new formula.

Note!
A formula name needs to be unique in the entire system. It is also recommended to use meaningful names
for the formulas.

6. If appropriate, select an entry from the list of most common formula definitions.

7. You can optionally insert or edit some text to describe the formula or KPI.

8. Click Next.
The second Formula Wizard window opens.

In this window, the name of your new formula appears in the PI Tree. You can also define the calculation
rule for the time dimension. By right-clicking the formula, you can use the Description window to describe the
formula.
9. Define or edit a calculation rule for the time dimension in the Time Aggregation Rule pane.
Note!
You must enter a specific syntax ($metadata_owner.performance indicator$) in the Time Aggregation Rule
pane, otherwise Formula Wizard does not validate your formula. To avoid mistakes, use drag-and-drop only
to place PI/KPIs from the Available Performance Indicators pane on to the Time Aggregation Rule pane.

Use SQL commands such as 'sum', 'avg', 'min', or 'max' as mathematical operations. The example below
shows a formula with the correct syntax:

sum($_nokbss.SDCCH_busy_att$ / $_nokbss.SDCCH_seiz_att$)*100

10. (OPTIONAL) Enter an extra SQL delimiter in the Selector pane (for example, $_nokbss.SDCCH_seiz_att$ >
0).

Use drag-and-drop to place PI/KPIs from the Available Performance Indicators pane on to the Selector
pane.

Once Formula Wizard validates your formula, you can proceed.

11. Click Next.


The third Formula Wizard window opens.

In this window, you can define other dimension formulas (other than time dimension).

12. (OPTIONAL) Define a formula for other dimensions except the time dimension.

Use SQL commands such as 'sum', 'avg', 'min', or 'max' as mathematical operations.

Note!
All the calculations are based on the result of the time dimensions. If you define other formulas, they must
contain the 'result' keyword.

13. Click Finish.

9.1 Create a Formula or select a Formula to edit- first Formula Wizard window

In this window, you can insert a new formula in the PI Tree or select which formula you want to edit.

The first Formula Wizard window consists of the following components:

• Formula Name field in which you can add the system-wide unique name of the formula.
• Create In pane that shows the PI Tree for you to select to position of the new report.
• Find tab that allows you to search for a PI/KPI or formula in the PI Tree. This tab is also available in other
windows. For information, see Find tab.
• Unit Definition field which is an editable drop-down menu that includes the most common formula
definitions.
• Formula Description pane that provides a text area where you can add information on the purpose and
operation of the formula.

Buttons
Button Description
Adds a new formula into a selected folder in the PI Tree pane. The new formula is selected and you
can edit its name.
Allows you to rename a selected folder or formula in the PI Tree pane.

Allows you to delete a selected folder or formula from the PI Tree pane.

Next Closes the first Formula Wizard window and opens the second one.
Cancel Cancels your current action in Formula Wizard and closes Formula Wizard.
Provides information on this Formula Wizard window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

9.2 Define the Calculation Rule for the Time Dimension - second Formula Wizard window

You can define the calculation rule for the time dimension.
Note!
All formulas must be defined for the time dimension.

The second Formula Wizard window consists of the following components:

• Available Performance Indicators pane which contains the PI Tree.


• Find tab that allows you to search for a PI/KPI or formula in the PI Tree. This tab is also available in other
windows. For information, see Find tab.
• Time Aggregation Rule pane in which you can define a new formula.
You can use all the SQL functions that are available in Oracle. The following is the list of the most important
SQL functions for PM reports. For detailed information, see the Oracle documentation.
o mathematical functions: ABS, FLOOR, SIGN, SQRT, and ROUND
o number functions: ROUND, TRUNC, and MOD
o aggregates or SQL functions: ALL, DISTINCT, SUM, AVG, MAX, MIN, and COUNT
o other: DECODE, NVL, STDDEV, and VARIANCE
• Selector pane that defines the WHERE part of the SQL statement. You can ensure that only particular
values are taken into account for a formula by defining them in this field.
o If you define a formula as sum(counter1/counter2) and you want to avoid a division by
zero you have to define a selector: counter2<>0.
o If you define a formula sum(counter1 + counter2) and you want to make sure that it only
takes into account values for which counter2 is greater than 100, you can define the following
selector: counter2>100.

Buttons

Button Description
Adds the selected PI/KPI to the Time Aggregation Rule pane or to the Selector pane.
Validate When you click Validate, Formula Wizard starts validating your new formula. The validation is done
by applying the formula in a database query.
If the validation fails, an error message appears. If you click Details, you receive information on the
failed SQL query.
Closes the second Formula Wizard window and opens the third one. The button is only enabled
Next
when a value has been entered for the time aggregation rule and the validation has successfully
run.
Finish Closes Formula Wizard.
Cancel Cancels your current action in Formula Wizard and closes Formula Wizard.
Provides information on this Formula Wizard window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

Time Aggregation Rule pane

You can define new formulas in the Time Aggregation Rule pane. Define the calculation rule for the time dimension
first. Enter an SQL specific syntax, otherwise Formula Wizard does not validate your formula. It is recommended that
you use drag-and-drop to place PI/KPIs from the Available Performance Indicators pane into the Time Aggregation
Rule pane. All formulas have to be aggregated (avg, sum, count,..) values, for example:
sum($nokbss.avg_busy_tch$) / sum($nokbss.avg_avail_full_tch$)
Note!
The drag-and-drop feature always inserts the PI/KPI at the cursor position.
To build an aggregation, for example, a summary based on certain PI/KPIs, use drag-and-drop to place the
aggregation in the Time Aggregation Rule pane.
For example, if you want to place a formula such as avg(Performance Indicator A / Performance Indicator B) into the
Time Aggregation Rule pane type:
avg( / )
use drag-and-drop to add the counters:
sum($nokbss.avg_busy_tch$) / sum($nokbss.avg_avail_full_tch$)
To avoid a division by zero, use drag-and-drop to build a selector as well. For example:
$nokbss.avg_avail_full_tch$ > 0

Selector pane

You can enter an additional SQL delimiter in the optional Selector pane. It is recommended that you use drag-and-
drop to place PI/KPIs from the Available Performance Indicators pane to the Selector pane. The delimiter allows
invalid records to be filtered out (SQL: where statement) and to avoid divisions by zero in the query. An example of
avoiding division by zero:
$nokbss.avg_avail_full_tch$ > 0
Note!
The drag-and-drop feature always inserts the PI/KPI at the cursor position.

9.3 Define the available Dimensions - third Formula Wizard window

You can define formulas for other dimensions than the time dimension.

The third Formula Wizard window contains all dimension tabs but the Time Dimension tab. These dimensions are
based on the result of the calculation rule for the time dimension. If you change your time dimension formula, some of
the other dimension tabs can disappear and some new ones may appear.

Defining calculation rules for the non-time dimensions is optional. Furthermore, all the calculations are based on the
result of the time dimensions.

Note!
result is assumed by Report Builder for all the formulas for all the non-time dimensions. If you define other
formulas, you must have a keyword result in them.

• You can define the calculation rule for a formula as sum(counterXY) in time dimension and as
max(result) in the 3G Network dimension. This means that all the counterXY values are summarised
over the selected time period but at the end only the Network elements with the maximum value are taken
into account.
• You can define another calculation role for a formula as avg(counterXY) in time dimension and as
result in the 3G Network dimension. This means that a average value for counterXY is calculated over
the selected time period and that this result is not aggregated again in the 3G Network dimension.

Buttons

Button Description
Validate When you click Validate, Formula Wizard starts validating your new formula.

Back Opens the previous Formula Wizard window.

Finish Closes Formula Wizard.


Cancel Cancels your current action in Formula Wizard and closes Formula Wizard.
Provides information on this Formula Wizard window.
Note!
You can launch the context-sensitive help from the main Report Builder GUI with the F1 key but with
the Alt-h key combination from the Report Wizard and Formula Wizard windows.

10 KNOWN PROBLEMS

10.1 Printing reports

The two dialogs Page Setup and Print give you a wide range of formats, for example portrait or landscape printing. If
necessary, table print-outs are split over several pages.

However, you need to be aware of the following two restrictions.

• When you are printing a report, a Page Setup dialog pops up before the Print dialog. You can make certain
page settings, which prevail over the settings you are making in the subsequent print dialog. Due to system
software restrictions, it is not possible to transfer the settings made in Page Setup dialog to the Print dialog.
The settings you have made in the Page Setup dialog cannot be overwritten by the settings made in the
Print dialog.

• If you click Cancel in the Page Setup dialog, you can only cancel the Page Setup dialog, but not printing. To
cancel printing, you need to click Cancel in the Print dialog.
10.2 Existing reports with RNC measurements can require manual editing after upgrading to OSS4

Object model changes for RNC network elements in OSS4 can cause problems for the existing Report Builder
reports. The changes concern managed objects that have no Global ID, that is, all RNC-related objects except
PMLN, RNC, WBTS, or WCEL.

If you have reports in which RNC measurements are used from objects that lack a Global ID, you must edit the
legacy reports manually for the reports to work. For such reports, the object dimension selections in OSS4 appear on
separate object dimension tabs in the Report Properties: Define settings for Time and Plain dimensions dialog in
Report Builder. You need to reselect the dimension values on each object dimension tab. For more information on
how to edit the settings, see Modifying reports.

10.3 Incorrect values in the Excel sheet that is attached to the e-mail of a scheduled report

The values in the Excel sheet (.xls) that you receive with the e-mail notification for a scheduled report can be
incorrect if the locale settings of your client machine differ from the locale settings of the server on which the .xls
file is generated, especially if the difference is the selection of the decimal separator.

Note!
The default locale on servers is usually US English.

If you encounter formatting problems in the .xls file that was attached to the notification e-mail, you can

• synchronise the server and client locale settings by selecting the same locale on the client in the Windows
Regional Options menu for the client as on the server.

• open the report, which is likely to be cached, in Report Browser or Report Builder on your client and export it
to a .xls file from the Reporter application. Since exporting to a .xls file on the client uses the locale
settings of the client, the locally exported .xls shows the report results with the correct values in the
correct format. This solution allows for keeping the locale settings on your client.

10.4 Special Characters in Description

Characters are stored in UTF-8 format in the database and some special characters need more than one byte to be
stored in database.
UTF-8 (8-bit UCS/Unicode Transformation Format) is a variable-length character encoding for Unicode created by
Ken Thompson and Rob Pike. It is able to represent any universal character in the Unicode standard, yet the initial
encoding of byte codes and character assignments for UTF-8 is coincident with ASCII.
UTF-8 uses one to four bytes (strictly, octets) per character, depending on the Unicode symbol. Only one byte is
needed to encode the 128 US-ASCII characters (Unicode range U+0000 to U+007F). Two bytes are needed for Latin
letters with diacritics and for characters from Greek, Cyrillic, Armenian, Hebrew, Arabic, Syriac and Thaana alphabets
(Unicode range U+0080 to U+07FF). Three bytes are needed for the rest of the Basic Multilingual Plane (which
contains virtually all characters in common use).
Four bytes are needed for characters in other planes of Unicode.
If the description that is entered in Report Builder contains some special characters then a message is displayed.
More than 4000 characters of Description cannot be entered. Hence please ensure this before adding the description
of the report.

10.5 PIs not to be used in same report

The following PIs in Nokia SGSN SG5.1/Load should not be used in the
same report:

1. peak_load_time(Load)
2. period_duration(Load)

11 FREQUENTLY ASKED QUESTIONS

11.1 How can I check which version of Report Builder is installed?

Answer:
Open the information pane by selecting Help -> About. The Reporter version number, for example
Reporter 3.1, also applies to Report Builder.
11.2 How do you show different PI/KPIs in one column as one data series?

Description:
that you want a report to show a table with a single column in which different PI/KPI are treated the same.

Example:
In this example, the table lists the 'Nokia KPI' and 'Other vendor KPI' values in two different columns.

Network Nokia KPI Other vendor KPI


BSC 1 59
BSC 2 30

By changing the names of both report components to 'KPI', for example, the result is as follows:

Network KPI
BSC 1 59
BSC 2 30

For more information, see Modifying or deleting Reporter nodes.

Category:
A report design issue.

Actions:
1. Select the report in Report Tree.

2. Give the same name to the PI/KPIs that have to appear in the same column.

11.3 How do you show different report components based on the same dimension in separate columns?

Description:
Normally, report components based on the same dimension are shown in the same column.

Example:
The table shows two values of KPIs for each BSC. One value is, for example, the normal KPI the other is for the Busy
Hour KPI:

Network KPI
1.5.05 99.4
1.5.05 99.7
2.5.05 98.4
2.5.05 98.9

By changing the name of the report component Busy Hour to 'KPI_BH', for example, the result is as follows:

BSC KPI KPI_BH


1.5.05 99.4 99.7
2.5.05 98.4 98.9

For more information, see Modifying or deleting Reporter nodes.

Category:
A report design issue.

Actions:

1. Select the report in Report Tree.

2. Rename the report components to make their names unique within the report scope.
3. 11.4 Why does a TopN report shows only one PI/KPI even if the report has more than one PI/KPI?
4.
Description:
A report is defined with several PI/KPIs and yet the TopN report shows only a single PI/KPI when it is run.

The TopN feature supports only a single PI/KPI. Even if a report has more than one PI/KPI, only a single
PI/KPI is shown. In the Type tab of the Report Visualisation window, the Filter For option list defines which
PI/KPI is shown. The other PI/KPIs defined in the report are shown elsewhere, for example, in the Report
Tree and in the Chart and Table displays. They are also listed in the Axis tab of the Report Visualisation
window.

Actions:
Define TopN reports only with a single PI/KPI.

11.5 How do you deal with a large number of objects in a report?


1.
Description:
You have, for example, a 1000 objects which are too many to handle in one report in a reasonable way. One
way to approach this is to produce a higher level report which only displays a selected number of the
objects.

Actions:
Use the TopN feature to display, for example, the top 20 best performing and the bottom 20 worst
performing objects.

11.6 How many values can you fetch in a query?

Description:
The number of values you can fetch in a query is limited to 200 000. If a query exceeds this limit, an error message is
displayed. The limit is established to avoid a very large query exceeding the system resources.

Category:
A capacity limitation.

Actions:

• Select the dimensions and PI/KPIs so a single report query does not fetch more than 200 000 values.

• You can decrease the amount of values in a report in the following ways:

o Increase the time summary level or decrease the time frame selection period.
o Increase the PI/KPIs summary level or decrease the number of objects.
o Decrease the number of PI/KPIs.

For more information, see Modifying reports.

11.7 Why does Report Builder change the summary level when I add PI/KPIs to an existing report?

You can create a report with several selected PI/KPIs and some specific Dimension Selection settings. The example
describes what might happen when you add a new PI/KPI to this existing report.

1. A 'Maintenance' report is created with selected 'A' and 'B' PI/KPIs. The selected time summary level is, for
example, 'week' for 'A' PI/KPI and 'month' for 'B' PI/KPI. Also the other dimensions for both 'A' and 'B'
PI/KPIs are different

2. Later if you want to add another PI/KPI called 'C' to the report 'Maintenance'. You can select the
Performance Indicator Selection window to add the PI/KPI 'C' to the report. The Dimension Selection window
shows the time summary level as 'all'. If no summary level is defined for the new PI/KPI 'C', a default value is
used, for example, 'day'. Each of these PI/KPIs have different time dimensions i,e 'week' for PI/KPI 'A' and
'month' for PI/KPI 'B' and 'day' for PI/KPI 'C'. Hence no common level can be defined for all the PI/KPIs. The
default behavior, in this case, is to show the highest common available level which is 'All'.

3. If you want all three PI/KPIs (in the example, 'A', 'B', and 'C') to have the same summary level 'week' in the
Dimension Selection window, you need to select each PI/KPI in the Dimension Selection window and check
its specific summary level. In the case of PI/KPI 'C', you need to change the summary level to 'week'. The
time summary level changes from 'all' to 'week' indicating that all three PI/KPIs have the same summary
level.

11.8 Why I do not get the Busy Hour option when creating some reports?

Busy Hour (BH) data is not always available.

• BH is only available for certain PI/KPIs.

• BH is not available with the 'raw' and 'hour' summary levels.

11.9 Why does Report Builder use the wrong keyboard when I have more than one keyboard installed?

When you have more than one keyboard installed, Report Builder may switch to a wrong keyboard when it starts. For
example, you may have a German and an English keyboard installed and you find that Report Builder always
switches to the English keyboard when it starts.

To ensure that Report Builder uses the right keyboard:

1. Set up the keyboard in your Windows Regional Settings. Click Start -> Settings -> Control Panel ->
Regional Options -> Input Locales and set up the Installed input locales for the keyboard.

If you want to use a German keyboard as the default, and also an English keyboard, use Installed input
locales for both keyboards and select the input language which is to be the default and click Set as Default:
.

2. To set the correct locale in your Windows Regional Settings: click Start -> Settings -> Control Panel ->
Regional Options -> General and set Your locale (location) to the same as that of the single or default
keyboard that you are using:
11.10 How can I access report component descriptions separately?

Reporter does not support separate report component descriptions.

You can enter report and formula descriptions in Reporter.

To display the description of a PI/KPI or a formula while a report component is selected

• Click Description in the Report menu.


or
• Description in the local menu.

11.11 How can I ensure that the column structure is preserved in a file that I export?

1.
The recommended extension is .xls, the native file format of Microsoft Excel, when you export a file from
a Reporter application. The column structure can be destroyed during export to other file formats, for
example to .csv.

You can also use the .txt extension when you save the file. Microsoft Excel guides you through a wizard.
Always click Next.
The column structure is as expected, although in a simple tabulated presentation, when you later open the
file with any plain text editor.

11.12 How can I check which summary method is used by a report?

You can check the summary method (aggregation level) by running the a report and viewing the SQL statement:

• Select Report -> Show SQL from the menu bar.


• Select Show SQL from the local context menu

If you are interested in the summary method that a formula uses:

1. Open the second window of Formula Wizard:


o Select Report -> Time Dimension or Report -> Other Dimension from the Menu bar.
o Select Time Dimension or Other Dimension from the local context menu.
2. Check the summary method in the Time Aggregation Rule pane for the time dimension or in the
dimension-specific panes for the other dimensions.

11.13 How can I define the summary level in Report Builder if several measurement types are activated for
only some hours per day?

1.
Since you can define a source level differently from the target summary level in Report Builder, you can
define day as target level and unselect the hours for which the measurement is not activated in the time
selection tab. This way you can ensure that Report Builder automatically selects only the relevant raw data
aggregates it to daily level with the specified aggregation method in the formula.

11.14 Why does Report Builder does not show Raw and Hour summary levels when a busy hour counter is
added to a report?

1.
You create a report by selecting busy_hour counters.The summary levels for busy_hour counters will be
always higher than ‘Day’‘Raw’ and ‘Hour’ summary levels will not be available as aggregation will happen
and no raw data will be found.
Some counters support busy hour and those will have the ‘Raw’ and ‘Hour’summary levels.Normal
counters which do not have the busy hour support also contains ‘Raw’ and ‘Hour’summary levels.

When you create a report by selecting a couple of PIs/Counters of which some are busy_hour PIs and some
PIs support busy hour and some do not,then the summary levels which will be defined will be taken by the
intersection of all the summary levels for these PIs.
In otherwords a common summary level will be defined like ‘All,Year,Week,Day’ and hence ‘Raw’ and
‘Hour’ summary level will not be available.

11.15 Why does Y-axis title of the chart is displayed wrongly in a report generated when multiple counters
are selected?
1.
Normally when a report is created with multiple counters ,the title of the y-axis in the chart will be displayed
as the first counter that is selected. This is a default setting.This setting can be modified by selecting the
"Report Visualisation" and "Axis" tab and "Primary Y-axis".
Once this setting is changed , the Y-axis title of the chart will change respectively. Moreover the legend of
the chart contains all the selected counters representing each one with a specific colour.So this indicates the
number of counters selected in the report and the data that is displayed in the chart.
Hence the title of the Y-axis of the chart is not displayed wrongly.

11.16 Why is it not possible to create BH report with Aggregation Choice as 'System'?

1.
There are 3 aggregation choices available in report builder using which you can create a report.
The choices are 'System','Raw'and 'Agg'. 'System' is a default setting which means the report builder checks
if there is aggregated data for the whole reporting time period for which the report is created.
If aggregated data is not available then 'Raw' choice is used.It uses 'Agg' automatically if the aggregation is
switched on for the whole reporting period.
Hence its not possible to create BH and WeekBH reports using the agg choice 'System'. An error occurs as
follows : "Formula uses Facts that cannot be joined in a Formula! Or no data available because of
Aggregation Of Aggregates configuration!"
Therefore when a report is created for a long time period and during which for certain period of time
aggregation is switched off then the report generation fails.

You might also like