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. 2. Select the report that you want to use as a template. 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. 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. 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.

3.

4.

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. 2. Define a report with a single counter. Enter the Report Visualisation window. Use the Type tab to define the report as a TopN report. Use the Chart Data tab to o Move all dimensions to the X-axis Display pane.

3. 4.

5. Use the Table Data tab to 6.
Move all dimensions to the Rows - Display one Row per pane. Disable the Time Series Data Completion checkbox, if selected. Click Ok.

o o o

Disable the Time Series Data Completion checkbox, if selected.

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. 2. Select the folder in which you want to add the new URL. Create the new URL: o Select Report -> New -> URL from the Menu bar. Click the (Create URL) icon in the Toolbar. Select New -> URL in the local context menu. Press the F4 key. 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.

o o o

3.

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 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. (Enforce Query) icon or press the F5

• •

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 resummarising 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 precalculated 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. 2.

Select the report to which you want to add PI/KPIs or formulas. 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
chose appears in the Selected Performance Indicators pane.

(Add) icon. The PI/KPI(s) you

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. (Remove) icon. The PI/KPIs disappears from the Selected Performance Indicators pane.

3. Click the

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. Open the second window of Report Wizard:

2.

o Select System if you want the report to fetch data from the measurement tables according to the PI/KPIs definition.. in the local context menu. 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. o Select Raw or Agg if you want that the PI/KPI fetches data from the raw or from the aggregated measurement tables. This closes the Performance Indicator Selection window and saves the modifications to your report in the Report Tree of the main window.. 4.third Report Wizard window. Select the PI/KPI or formula that you want to modify in the left pane of the window. 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.. this particular PI/KPI is not available for busy hour reports. The three aggregation options become visible in a pull-down list. Note! You must reload the report before you can see the impact of your modifications in the aggregation settings. from the Menu bar.. 3. For instructions. from the Menu bar. For a description of this window. see Dimension Selection .. . Open the third window of Report Wizard: o Select Report -> Dimension Selection. o Select Dimension Selection. Press the F6 key on the keyboard. Click the cell with the current value in the Agg. see Performance Indicator Selection . Select Performance Indicator Selection.. If a PI/KPI does not have a checkbox. 3.Choice column.o o o Select Report -> Performance Indicator Selection. respectively. 5. o Press the F11 key on the keyboard.. see Reloading reports. in the local context menu. Select the PI/KPI or formula for which you want to modify the settings in the Selected Performance Indicators pane.. 2. Click Ok. for example object hierarchy 1. For a description of this window.second Report Wizard window.

all PI/KPIs are selected and you can define dimensional settings for all PI/KPIs in the report. are visible on the right hand side. for example. or Start Time (Week). Depending on which dimensions you want to edit. Depending on which dimensions you want to edit. The dimension tabs group dimensional settings together. for example. Any prior changes are stored in the database. see To edit other dimension selections.o Select the tab for the time or other dimension that you want to modify in the right pane of the window. . the dimension tabs display all dimensions shared by the selected PI/KPIs. for example. Start Time (Month). Note! Some summary levels are available in more than one Dimension Hierarchy. As a result. click the corresponding dimension tab. see To edit the time dimension selection. In the Dimension Selection window. Specifying both Dimension Hierarchy and Summary Level gives Report Builder sufficient amount of information to generate the report. see Time dimension tab. click the corresponding dimension tab. For instructions on how to edit other dimension selections. 2. For information. Select the dimension hierarchy. Time or Network. As a result. see To edit other dimension selections. For instructions on how to edit other dimension selections. see To edit the time dimension selection. 3. Select Dimension Selection to open the Dimension Selection window. For instructions on how to edit the time dimension selection. Any prior changes are stored in the database. Time or Network. 2. To edit the time dimension selection 1. 3. 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. Note! Since PI/KPIs do not necessarily have the same dimensions. Select the PI/KPI(s) that you want to edit from the list on the left of the Dimension Selection window. the selected PI/KPIs of your report are visible on the left and dimension tabs. By default. Select the summary level from the Summary Level option list. Note! Since PI/KPIs do not necessarily have the same dimensions. To edit dimension selections 1. the dimension tabs are updated when the selection of PI/KPIs changes. the dimension tabs are updated when the selection of PI/KPIs changes. the dimension tabs display all dimensions shared by the selected PI/KPIs. by clicking the Hierarchy option list. For instructions on how to edit the time dimension selection. 'time' and 'network'.

you must first reload it by clicking the (Enforce Query) button. 7. 4. you must first reload it by clicking the (Enforce Query) button. Click Ok to close the Dimension Selection window and apply the properties to your report. You can select all hours at the same time by clicking Select All and deselect selected hours by clicking Clear Selection. 5. all PI/KPIs are selected and can define dimensional settings for all PI/KPIs in the report. see Time dimension tab.. select either the Include or Exclude option depending on whether you want to include the selected objects in your report or exclude them. Click the boxes 0 . Note! To see these changes in your report. Select the PI/KPI(s) that you want to edit from the list on the left of the Dimension Selection window. Select the summary level by clicking the Summary Level option list. 2. Expand the Available objects list by double-clicking the icons. Note! At least one day and one hour should be selected. If a single object is . For more information on how to select the time frame. To edit other dimension selections 1. Note! To see these changes in your report. 6.. Depending on whether you want to include or exclude objects: o o Select the object(s) that you want to include and click the Selected objects pane. it has been removed from the database. By default. 6. 3. 7. The object appears in the (Remove) icon.'.4. In the List Type pane. Select the time frame by clicking either the Absolute or Relative option in the Time Frame Selection pane. Specifying both Dimension Hierarchy and Summary Level gives Report Builder sufficient amount of information to generate the report. Click Ok to close the Dimension Selection window and apply the properties to your report.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.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. Select the hierarchy dimension by clicking the Hierarchy option list. Note! Some summary levels are available in more than one Dimension Hierarchy. 5. Note! If a object is shown as 'OBJECT NOT FOUND. Select the object(s) that you want to exclude and click the (Add) icon. Tick the Mon . You can select all days at the same time by clicking Select All and deselect selected days by clicking Clear Selection.

the Rename option is inactive (grayed out) in the Edit menu and in the local context menu. reports. For information on permissions. o Select Report -> New -> Folder or Formula -> New -> Folder from the local context menu o Press Ctrl-Alt-n. modify. For instructions on other folder-related tasks. 2. Select the folder in which you want to create the new folder.6 Managing folders You can create. You can also modify the permission to a folder. 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. Note! You can also create a folder in the first window of Report Wizard and Formula wizard. URLs. For more information. o Select the (Report View) or (Formula View) toggle button in the Toolbar. Edit the name of the new folder and press Enter. see Managing permissions. 2. it might have been removed from the network.7 Modifying or deleting Reporter nodes You can modify the Reporter nodes (folders. Create the new folder in one of the following ways: o Select Report -> New -> Folder or Formula -> New -> Folder from the Menu bar.missing. In this case. You cannot modify PI/KPis which are the built-in formulas of NetAct Reporter. 4. The new folder inherits the permission of its parent folder. If you only have Read permission to a node. Note! You can only rename and delete nodes. To create a new folder 1. 4. it is recommended that you remove this object from the selection. the modification has an immediate impact on all the reports in which the formula is . see Managing permissions. see Modifying or deleting Reporter nodes. or delete folders in the Report Tree and in the PI Tree. Toggle to the relevant view: o Select View -> Report View or View -> Formula View from the Menu bar. and formulas) in Report Builder. When you modify a formula. 1. 3. A new folder is created. or change the permission to nodes if you have Modify permission to them.

Select the node that you want to rename.. Select a URL node that you want to modify. or Formula -> Permissions. in the local context menu. 2.. Select the node for which you want to change the permission. To delete a node 1. o o o Click the (Delete) icon in the Toolbar.txt. http://www. or nodes that are locked and are marked with the lock icon. o o Click the (Rename) icon in the Toolbar.. Rename the node in one of the following ways: o Select Edit -> Rename from the Menu bar. Select Delete from the local context menu. 2. Edit the URL: o Select Report -> Edit from the Menu bar. To rename a node 1. o o o Click the (Permissions) icon in the Toolbar. .included.. Note! You cannot rename default Nokia reports. Press Ctrl-x. The URL window opens where you can edit the properties of the URL node: o URL: the Web link.. 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. Note! 3. Press Ctrl-x.google.. To change the permissions of a node 1. Delete the node in one of the following ways: o Select Edit -> Delete from the Menu bar.de or file://c:/readme. see Searching in the Report Tree. from the Menu bar. Before you modify a formula. o Description: edit the current URL description. Select the node that you want to delete. 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. for example. Select Permissions from the local context menu. 2. 2. To modify a URL 1. Select Rename from the local context menu. o Select Properties. Change the permission of the node in one of the following ways: o Select Report -> Permissions.

4. Administrators have to create user groups and roles for the users of the . Therefore. that is. • • 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 also modify the permission of a default report. 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. Read A user with Read permission is able to view and copy the report or formula. nodes inherit the permission value from their parent node. and the administrator users can always see and modify the node. or have no permission to it at all. 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. Otherwise they cannot use the PIs for creating new reports. Click Ok to save the changes. • Role-based approach You can set a node so that users who are assigned the same NetAct role can either read or modify it. Modify A user with Modify permission is able to modify the permission of the node. This choice only applies to Report Browser and KPI Browser but not to Report Builder. and save the changes. 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. respectively. PIs must have at least Read permission to be visible in the PI tree for all the users. The owner of a node. URLs. By default. reports. and folders. 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. or to Private so that only the owner and the administrator can see and modify it. For Report Builder a new Web browser window is always opened for each URL that is selected. 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. You can change the permission of all the element types in the Report Tree. that is. to Public Read and Public Modify. However. all the nodes: PI/KPIs or formulas. but you can hide it from other users if you assign No Access right to it. no other user can see or modify the node. the user cannot change the characteristics of the report or formula in any way. edit the characteristics of the report or formula. the user who has created it. You cannot making it editable even if you assign Modify access to it.

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. For instructions. and any changes in the Report Tree will make the permission settings obsolete and therefore not usable any more. so that various permission settings can be associated with different user groups.and group-based permission management. For more information and for instructions on how to create user groups and roles. If you have changed the permission of a folder. the folder collapses in the tree.USE_ROLE_BASED_INSTEAD permission to the Reporter_Public_Role role in NetAct Permission Manager. which are available. see Assigning permissions with the Private/Public approach and Assigning permissions with the Role-based approach. 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. For instructions. You need to restart Reporter for the change to take effect by restarting WebSphere. If you want to use the Role-based instead of the Private/Public approach. including reports or KPIs. 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. The Permission Operations are ADMIN and LAUNCH. 5. The Report Tree and the PI Tree are updated automatically after you have changed the permissions in the tree. It is also possible to switch between the two solutions later on with NetAct Permission Manager. which is created when the application is installed on the Application Server. o o o The Permission Object for Reporter is APP_SC_REPORTER. an approach which would eventually undermine the concept of the role. because the settings for the permissions are stored separately. Default Permission Object and Operations exist in NetAct Permission Manager for creating user groups and roles for the Reporter applications as well. However. You can select between these two options at installation time. this approach is not recommended because it would require continuous and manual control of permissions for each object. Administrators can create as many user groups and roles as required.Reporter applications with NetAct Permission Manager before the users can log into Report Builder and access nodes or modify permissions to nodes.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 . assign the APP_SC_REPORTER. see NetAct Permission Manager Help in the 'Helps' category in the NetAct documentation. the default is the Private/Public approach. on a per-object basis. 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.

otherwise you can deny yourself access to the node. Other users cannot see or modify the node. or you are the owner or an administrator user. o o . Right-click the node in the Report Tree or in the PI Tree and select Permissions. if you want to allow any user to see or modify the node. untick the As inherited checkbox and select one of the radio buttons: o Select Private.permissions for the nodes in the Report Tree and the PI Tree. Note! It is recommended that you only set a permission to Private if you are the owner or an administrator. 1. you can also select Report -> Permissions. Select Public Read. Select Public Modify. To change the permission to a node. The Node Permissions window appears with the nodes to which you have Modify permission. if you want to reserve the modification rights to yourself. If you want to modify the permissions for a node in the Report Tree (a folder. If you want the node to inherit the permission settings of its parent. 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. 2. if you want to reserve all the rights to the node for yourself. a report. leave the As inherited checkbox ticked. or a URL). Other users can see the node but cannot modify it.

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. Click OK to save the changes. or you are the owner or an administrator user.3. . 5.

The tree is very long. untick the As inheritance checkboxes and select one of the radio buttons in the row of the role: o o o Select No Access. leave the As inheritance checkboxes ticked for those roles to which this inheritance should apply. for example. You know the name of the item. If you want to modify the permissions for a node in the Report Tree (a folder. You can use the asterisk in all the search procedures and it can stand for one or several characters in the string. 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. a report. Right-click the node in the Report Tree or in the PI Tree and select Permissions. In Report Builder you can search a particular tree and obtain matches based on given search criteria. You can use only the asterisk (*) as a wildcard in your search. for example. in *wsv*. but you do not want to click through the tree to find it. To change the permission to the node for the users who are assigned a particular NetAct role. or an invalid string. 3. If you want the node to inherit the permission settings of its parent. Note! Report Builder searches for an exact string by default.1. You want to find a specific item to use. with wildcards that are not supported. 6 SEARCHING Trees can be very long and can contain numerous folders of reports or PI/KPIs and formulas. in a formula you are working on. Select Modify. You want to find all items that match a certain search criteria. You may want to search a tree for the following reasons: • • • • • You cannot find particular items in the tree. You have used an empty search string. If you have Modify permission to the node. . if you want to allow any user with the role to see or modify the node. If the search has not provided any results. for example. or a URL). you can also select Report -> Permissions. Click OK to save the changes. in which case searching is faster and easier than browsing. if you want to revoke the permission to the node from all the users who are assigned the role. ensure that the following conditions do NOT apply: • • The tree exists but is empty. Select Read. Other users can see the node but cannot modify it. 2. 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.

3. Select the filter for your search with the radio buttons. 6. Select the Find tab in Report View. 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. and folders in the Report Tree and for PIs and formulas in the PI Tree. Select the maximum number of search results that you want to display. 1. or report components. A search result displays the name of the item and its type represented as an icon. on the selected node(s): o Click the relevant icon in the Toolbar.• No items are found that match the search criteria. 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. 2. 7. use the Tooltip to display the full name. The search result pane displays the list of Report Tree objects that matches the search criteria and for which you have Read permission. You can search for reports. for example Show Chart or Delete. o Select the relevant menu item from the local context menu. 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. 6. reports. 5. 4. 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. If the pathname is not completely visible. Select one or more Report Tree nodes from the search results.2 Searching in the PI Tree . report components. Start the operation that you want to perform. o Press the relevant key or key combination.1 Searching in the Report Tree You can search for any node in the Report Tree: folders. URLs. press Enter. o Select Reports referencing PI if you want to know which reports include the component whose name is a match for the search string. URLs. Start the search: o o Click the (Search) icon. The pathname of the item is shown at the bottom of the pane.

The Time tab is not relevant. 2. Enter the search criteria of the managed object for which you want to search. Open the third window of Report Wizard: o Select Report -> Dimension Selection. Start the search: o o Click the (Search) icon. from the Menu bar.. o Press the relevant key or key combination. The pathname of the item is shown at the bottom of the pane. o Select the relevant menu item from the local context menu. on the selected node(s): o Click the relevant icon in the Toolbar. see Performance Indicator Selection .. If the pathname is not completely visible. For a description of this window. . 5. The selected PI/KPIs of your report are visible on the left and dimension tabs. 4. 3. Select the Find tab.. 3. Select the maximum number of search results you want to display. Start the operation that you want to perform. o Select Dimension Selection. 'BSC'. Select a search level.3 Searching for managed objects when modifying a dimension 1. '3G network' are visible on the right. Select the maximum number of search results that you want to display. press Enter. for example.You can search for PI/KPIs or formulas 1. 2. A search result displays the name of the item and its type represented as an icon. for example. Select the Find tab in Formula View. 5.second Report Wizard window. o Press the F11 key on the keyboard.. Select one or more PI Tree nodes from the search results. for example Show Chart or Delete. use the Tooltip to display the full name. Select the report in which you want to edit dimension selections. Start the search: o o Click the (Search) icon or press Enter. 6. The search result pane displays the list of PI Tree objects that matches the search criteria and for which you have Read permission. 6. 4. in the local context menu.

You can use drag-and-drop to perform the same operation. The search result pane displays the list of managed objects that matches the search criteria and for which you have read permission.6. 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. when the toggle button has been selected) toggle button has been selected) • • Formula menu (visible only in Formula View. The pathname of the item is shown at the bottom of the pane. use the Tooltip to display the full name. A search result displays the name of the item and its type represented as an icon. If the pathname is not completely visible. when the Edit menu View menu Window menu Help menu Toolbar buttons Report Tree or PI Tree . 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 o o o o o Report menu (visible only in Report View. 7.

third Formula Wizard window • • For instructions on how to search the PI Tree. 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.first Formula Wizard window o Define the Calculation Rule for the Time Dimension . see: o Create a Formula or select a Formula to edit.. see Find tab. .. For instructions on how to use the Node Permission window.third Report Wizard window o Report Visualisation options .second Report Wizard window o Dimension Selection .first Report Wizard window o Performance Indicator Selection .1 File menu Menu item Save as Description. New Starts Report Wizard with an empty template for creating a new report..2 Report menu This menu is not visible in Formula View.• • Frame for the report charts or tables Status bar • For instructions on how to use Report Wizard. Exits the application. Print.second Formula Wizard window o Define the available Dimensions .. Menu item Description..fifth (optional) Report Wizard window • For instructions on how to use Formula Wizard. (Ctrl-p) Exit 7..fourth Report Wizard window o Report Scheduling options . 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. see: o Report creation . Opens the Print dialog to print the table or chart in the right-hand frame.

Dimension Selection. (F11) Opens the third window of Report Wizard which displays the PI/KPIs that you have selected for your report. Opens the second window of Report Wizard in which you can select which PI/KPIs (F9) you want to include in your report.. modify the description of the report. For instructions. The SQL information is mainly of interest to Report Builder administrators who need to debug. Description.Edit Starts Report Wizard with the information of the report that you have selected in the Report Tree... Opens the third Formula Wizard window.. Opens the second Formula Wizard window. you can also modify the settings. For instructions. 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. For instructions..3 Formula menu This menu is not visible in ReportView. you can also modify the time aggregation rule for the formula. see Displaying reports... Displays the report as a chart. Opens the Node Permission window in which you can check and if you have sufficient permissions. Other Dimension . Menu item Description New Starts Formula Wizard with an empty template for creating a new formula. Displays the report as a table. The Enforce Query functionality is only available if you have the licence for the optional caching and scheduling feature. Performance Indicator Selection. modify the permissions of a node in the Report Tree. Time Dimension Opens a dialog in which you can see and if you have sufficient permission you can modify the description of the formula. Report Visualisation. see Displaying reports. Show Report F6 Show Chart F7 Show Table F8 Show SQL Displays the report both as a chart and a table. Opens a window which displays the SQL query associated with the report. You can see the time dimension settings of the formula and if you have sufficient permissions. The cached version of the report is overwritten. For instructions. Enforce Query F5 Permissions. For instructions. for example to determine why a certain report in Reporter Builder does not work or does not produce the expected results. 7. Displays the active report or updates it by enforcing a query from the database. Edit Starts Formula Wizard with the information of the formula that you have selected in the PI Tree. Description. For instructions.. see Modifying reports. see Managing permissions.. see Displaying reports. You can change the settings for the PI/KPIs in all dimensions.. see Displaying reports.. You can see the various dimension settings of the formula and if you have sufficient permissions. Opens a dialog in which you can see and if you have sufficient permission.. (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.

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. and contacts. builds. tables or dialogs that you have opened earlier in the righthand frame of the Report Builder GUI.. Allows you to rename Reporter nodes (except pre-defined or locked reports and PI/KPIs). When you open any first report. Opens a window that provides information on Report Builder releases. Menu item Cascade Tile Horizontally Tile Vertically Close all Description Displays the charts and tables on top of each other in cascading style for all the reports that you have opened. Displays all the charts and tables in horizontally divided panes next to each other for all the reports that you have opened so far. Allows you to delete Reporter nodes (except pre-defined or locked reports and PI/KPIs). Displays all the charts and tables in vertically divided panes below each other for all the reports that you have opened so far. Toggles to Formula View. When you start Report Builder. Report View is displayed by default.7 Help menu Icon Help Topics.8 Toolbar buttons .. 7. Allows you to paste any Reporter nodes except folders.6 Window menu Description Toggles to Report View. 7. Opens the Node Permission window in which you can check and if you have sufficient permissions. Closes all the charts.. 7. Menu item Report View Formula View 7.4 Edit menu Menu item Copy (Ctrl-c) Paste (Ctrl-v) Delete (Delete) Rename 7.. modify the permissions of a node in the PI Tree. 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.5 View menu Description Allows you to copy any Reporter nodes except folders. For instructions.Permissions. (F1) About Description Contains instructions on how to use Report Builder and a description of the user interface components. see Managing permissions.

URL. report. For instructions. Not visible in Report View. Prior cached versions are overwritten. Calls Formula Wizard to create or edit a formula. The first of the four Report Wizard windows opens. or Formula Wizard to edit the PI/KPI or formula. Depending on the active View and the type of the node that you have selected in the Report Tree or PI Tree. Not visible in Formula View. For instructions. Displays a selected report or updates an existing report by enforcing a query from the database. see How can I ensure that the column structure is preserved in a file that I export?. One of the two icons is always enabled. The first of the three Formula Wizard windows opens. the other is disabled. (Ctrl-p) (F7) (F8) (F5) Opens the Print dialog which allows you to print a table or chart selected in the Report view.Button (Ctrl-n) (Ctrl-n) (F4) Description Toggle between Report View and Formula View. 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. integrating into a Microsoft Word document or viewing in a Web browser. calls Report Wizard to edit the report. You can use the chart for further processing. (Delete) Deletes a selected folder. the URL properties window to modify the URL. This format allows the file to be displayed in applications such as Microsoft Excel. PI/KPI.png) format. report. see Displaying reports. Displays the table of the selected report. modify the permissions of a node. see Displaying reports. see Displaying reports. opens the Node Permission window in which you can check and if you have sufficient permissions. Depending on the active View and the type of the node that you have selected in the Report Tree or PI Tree. Displays the chart of the selected report. Opens Report Builder Online Help. Creates a new URL node. URL. or PI/KPI. for example. Calls the Report Wizard to create a report. Not visible in Formula View.9 Report Tree and PI Tree Icon Description Unexpanded folder for reports or URLs . The table is saved as tabular data in .xls file format. • • The chart is saved as a graphic in portable network graphic (. or formula. Opens a list where you can select to create a new URL or a new folder. For instructions. A file browser opens where you can select or create a folder in which to save your table. For instructions. The Enforce Query functionality is only available if you have the licence for the optional caching and scheduling feature. . Renames the selected Reporter node (folder. A file browser opens where you can select or create a folder in which to save your chart or table. For information on exporting in other file formats. Not visible in Formula View. Not visible in Formula View. see Report Wizard.

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. For example. see Defining and using URLs.. The padlock often indicates a Nokia default report. For information. the sort order of a column may be reversed by clicking the column title... Non-editable report. 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. 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. non-editable reports delivered to you by Nokia. If you click a column title and holding the mouse button. Click the second icon to enlarge the window to fill the Data View area. These reports are predefined. Activity message displayed during a certain activity. For example. URL link to a report. If the table is selected. Fetching report. PI/KPI Non-editable PI/KPI Customer defined formula Non-editable customer-defined formula 7. 7. Note! The column changes in the display do not affect the data model on which the table is based. For more information. 7.12 Local context menus • • . Report scheduling is only available if you have the licence for the optional caching and scheduling feature. The activity indicator is running until copying is finished. the position of the column in the table may also be changed.11 Status bar The status bar consists of the following components: • Activity bar indicating calculations through continuous movement. 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. see Managing permissions.Expanded folder for reports or URLs Folder for which you have Read permission and therefore you cannot edit. You can modify the permission of a default report but cannot make it editable.

or . . see Displaying reports.• Folders: Context menu item New -> Report Ctrl-n New -> New -> Folder Ctrl-Alt-n URL F4 Description Starts Report Wizard with an empty template for creating a new report. Displays a selected report or updates an existing report by enforcing a query from the database. Allows you to enter a new name for the folder node within the tree. Opens a window in which you can select the PI/KPIs you want to include in your report. or . . Displays the report as a table in the right-hand frame. For instructions. Displays the report as a chart in the right-hand frame. Allows you to delete the report from the Report Tree. Creates a new URL node in the Report Tree and opens the Properties dialog in which you can enter the address and other details for the URL. Not available for .. why a certain report in Reporter Builder does not work or does not produce the desired result.. Opens a window which displays the SQL query associated with a selected report. Creates a new folder in Report Tree... Not available for .. This operation is mainly of interest to Report Builder administrators who need to debug. Allows you to change the name of the report. F9 Dimension Selection. For instructions. Delete Ctrl-x Rename Permissions. F11 Starts Report Wizard with an empty template for creating a new report. modify the permissions of a node in the Report Tree. For more information. Prior cached versions are overwritten. Opens a window which displays the PI/KPIs that you have selected for your report. . Not available for . You can change the settings for the PI/KPIs in all dimensions. • • • Reports and URLs: Context menu item Show Report F6 Show Chart F7 Show Table F8 Show SQL Description Displays the report both as a chart and a table in the right-hand frame. The Enforce Query functionality is only available if you have the licence for the optional caching and scheduling feature. Not available for . Enforce Query F5 Copy Ctrl-c Delete Ctrl-x Rename Report Wizard (Ctrl-n) Performance Indicator Selection. for example. Allows you to copy a report. Deletes the selected folder node(s) from the Report Tree. see Modifying reports. Opens the Node Permission window in which you can check and if you have sufficient permissions. see Defining new reports..

. For information.. style definitions and titles). and formulas.Report Visualisation. see Displaying properties of reports... For more information. • • • 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: . Allows you to enter a new name for PI Tree node within the tree..... Deletes the node(s) from the PI Tree.. Opens a dialog for the PI/KPI or formula in which you can use to describe the characteristics of the report. modify the permissions of a node in the Report Tree. Delete Ctrl-x Rename Description. • • • PI/KPIs and formulas: Context menu item Copy Ctrl-c Description Allows you to copy a report. see Defining new reports. see Modifying reports. not available for PI/KPIs. Not available for and . For instructions.. PI/KPIs. For instructions. see Managing permissions. modify the permissions of a node in the PI Tree. PI/KPIs. For instructions. For instructions. F12 Report Scheduling. For instructions. Opens the Node Permission window in which you can check and if you have sufficient permissions. Available only for formulas.. Permissions. Opens a dialog for the report in which you can use to describe the characteristics of the report. For instructions. Permissions. see Report Scheduling options .13 Node Permissions window (Private/Public) If you are using the Private/Public approach to assign permissions. see Modifying reports. and formulas. not available for PI/KPIs. 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 (for example. 7. Opens a window in which you can schedule cacheable reports or modify the schedules for a scheduled report.fifth (optional) Report Wizard window.. Opens the Node Permission window in which you can check and if you have sufficient permissions. the Node Permission window contains the following components. Description. see Managing permissions. Not available for and . see Displaying properties of reports. Available only for formulas.

modify. • • 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. that is. Private automatically means Modify access to the node. Administrators can view. Buttons The Node Permissions window contains the following buttons: Button Ok Cancel Description Closes the Node Permissions window and saves the changes. the user who created it.ADMIN permission in Nokia NetAct. that is. a user with APP_SC_REPORTER. Cancels any changes that you have made and closes the Node Permission 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. Provides information on the Node Permissions window. Public Modify Every user who can launch Report Builder can see and modify the node. As Inherited checkbox Shows whether the permission is inherited from the parent node. Public Read Every user who can launch Report Builder can see the node but they cannot modify it. the Node Permission window contains the following components. Permission Type pane This pane consists of three radio buttons: • • • Private Only you have access to the node. Note! The restrictions do not apply when an administrator user.14 Node Permissions window (Role-based) If you are using the Role-based approach to assign permissions. is using Report Builder. 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.• • • Node Name The name of the node. . Node Owner The owner of the node.

a user with APP_SC_REPORTER. o Modify Users who have Modify permission to the node can see and modify it when they log into Report Builder. • • Select Reports name if you want to see all the nodes in the Report Tree whose name is a match for the search string. For more information. is using Report Builder. that is. see Searching. 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. o Read Users who have Read permission to the node can see it when they log into Report Builder. Provides information on the Node Permissions window. For instructions on how to execute a search.15 Find tab You can specify the search criteria with the Find tab that is visible in several Report Wizard and Formula Wizard windows. modify.ADMIN permission in Nokia NetAct. Note! The restrictions do not apply when an administrator user. see Managing permissions. . Buttons The Node Permissions window contains the following buttons: Button Ok Cancel Description Closes the Node Permissions window and saves the changes. Administrators can view. 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. However. 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. 7. 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. Modify These three columns cover all possible permissions. • As Inherited checkboxes Shows whether the permission is inherited from the parent. Cancels any changes that you have made and closes the Node Permission window.• No Access. Select Reports referencing PI if you want to know which reports include the component whose name is a match for the search string. Read. you can choose to list only the reports or all of the nodes.

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. you can use the asterisk (*) as a placeholder for one or more characters. Displays the list of results matching the search criteria. Note! Report Builder searches for an exact string by default.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. Check this box to ensure the search results exactly match the search criteria. The overall maximum is 80 results. Ctrl-v Pasting. Select a maximum number of results you want displayed. Ctrl-Alt-n Creating a new folder. Ctrl-c Copying. Select the MO level at which you want the search to be performed. Ctrl-p Printing. and click or press Enter to start the search. Ctrl-n Creating a new report or formula by launching Report Wizard from the Report Tree or Formula Wizard from the PI Tree. a PI/KPI or formula in Formula Wizard. Note! Ctrl-x is not the combination of Ctrl-c and Ctrl-v in Report Builder. or the description dialog for an URL. No other wildcards are supported in the search. Double-clicking a node Expanding a folder or opening the report in Report Wizard. Drag&Drop . Results Case Sensitive checkbox Search results pane Search Level 7. This field is only present when searching dimension selections (other than the time dimension). Ctrl-x Deleting. When you search for substrings. (search icon) Enter in the search field the search criteria for the item that you want to find. The default is 50 results. Max. Clicking a selected note again Making a node name editable for renaming in the Report Tree or in the PI Tree. respectively.

2. For information on the icons. o o Click the (Report Wizard) icon in the Toolbar. and ) are enabled. Press the Ctrl-n keys. • • When you select several nodes to execute the same operations on them. the icons are disabled. Note! Report Wizard opens in Create or Edit mode depending on the permission of the node (folder or report) which you have selected. it deletes he selected nodes. the three button icons in the top-right corner ( . 8 REPORT WIZARD Report Wizard consists of four windows (five if you have the licence for the optional caching and scheduling feature).first Report Wizard window. If you want to add a new folder. also define the folder name. Show SQL Activated from the Menu bar (Report -> Show SQL) or from the local context menu. or selecting a PI or formula in PI Tree and dragging it into the Time Aggregation Rule or Selector panes in Formula Wizard. Show SQL is not included in the context menu. . Delete Activated from the Menu bar (Edit -> Delete) or from the local context menu. the context menus show only the operations that you can execute on all of the nodes. it opens the description dialog for all the nodes that you have selected.Selecting a report in Report Tree and dragging it onto the Report view pane of the Main Window. it opens the SQL dialog for all the selected reports. define the name of your report and select its location in the Report Tree. only the Delete operation is available. The first Report Wizard window opens. see Report creation . In Create mode. For example.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. If you do not use all the options. . 7. . Expand the Report Tree on the left hand side with a double-click. Report Builder assumes default values. Start Report Wizard: o Select Report -> New Report Ctrl-n from the menu bar. In the first Report Wizard window. 3. 1. when you select a report and an URL or a report and a report component in the Report Tree. in Edit mode.

. In the third Report Wizard window. The window may also contain. see Report Wizard. For instructions. (OPTIONAL) Define the scheduling parameters for the report. Click Next. For more information. In the fourth Report Wizard window. Note! Steps 7 to 9 provide the same functionality as described in Modifying reports. you can select the report visualisation options. 8. follow steps 1 and 2 in Modifying reports.4. For more information. The second Report Wizard window opens. see Caching and scheduling reports. Select the folder for the new report. follow steps 1 to 3 in Modifying reports. for example. 10. but the wizard provides additional buttons for navigating through the wizard itself. you can select the dimensions for your report. 6. Note! The scheduling feature is optional and you need a licence for it. you can use the Description window for further information. To add or remove PI/KPIs: o o To add PI/KPIs. In the window. HTML links that you can see in Report Browser. you can also add a description of the report. The HTML code is displayed with HTML tags as a source code in Report Builder. To remove PI/KPIs. you define the name of your report or folder and select its location in the Report Tree. Enter the name of the new report in the Report Name field. The fourth Report Wizard window opens. follow Modifying reports. After you have selected the PI/KPIs for your report. The third Report Wizard window opens. Create In pane that shows the Report Tree for you to select to position of the new report.1 Report creation . . click Next. For more information. In the second Report Wizard window. Click Save to store the description. click Next. 5. you can select the PI/KPIs for your report. By right-clicking the PI/KPIs. View the report. Description pane in which you can provide additional information about the report. For instructions on selecting these options. Click Finish. The first Report Wizard window consists of the following components: • • • Report Name field in which you can enter the name of the new report. After you have selected the dimensions for your report. The new report appears in the Report view of the main Report Builder window. follow Modifying reports. 12. see Displaying reports.first Report Wizard window In this window. 9. 11. The window can contain up to 4000 characters of text. 7.

Day.2 Performance Indicator Selection .second Report Wizard window In this 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. This tab is also available in other windows.. 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. remove. The new folder is selected and you can edit its name.) 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. 8. The name of the new folder or report is added to the Report Tree in the Report Builder main window. Allows you to delete a selected folder or report from the PI Tree pane. you can add. see How can I check which summary method is used by a report? You can. Provides information on this Report Wizard window. Allows you to rename a selected folder or report in the PI Tree pane. .. Closes Report Wizard window and cancels all the changes you made in this window. 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. This pane allows you to check that you have selected the correct PI for the report. The Performance Indicator Selection window consists of the following components: • • • • Tree tab that shows the PI Tree. For instructions on how to determine the system settings for the PI/KPI. override the system settings for a PI/KPI in reports . Week are visible. Reports that you have created earlier and default reports delivered by Nokia always use the System setting. Next Cancel Closes the first Report Wizard window and opens the second one. see Find tab. or modify PI/KPIs for a selected report.similarly to the report-specific renaming of a PI/KPI in a report in the Refer to as. For information. field: • System: Default setting to follow the PI/KPI definition whether the data is fetched from the raw or from the aggregated measurement tables. 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. Find tab that allows you to search for a PI/KPI or formula in the PI Tree.Choice). . Note! By default.• Buttons Button Description Adds a new folder into a selected folder in the Report Tree pane.. however.

the query engine checks all the raw and aggregated measurement tables. for example. that you have not specified. filters the results according to the setting of the Agg. Click on the ADD button to add it to Selected performance indicators. The selected PI/KPI appears also in the Report Tree in the Report Builder main window under the report name. 8. Report Builder and Report Browser display an error message. an empty chart is displayed in Report Builder and Report Browser. (Not visible when you are using Report Wizard).3 Dimension Selection . Agg The PI/KPI is calculated with the data fetched from the aggregated measurement tables when the report is generated. Cancels your current action and closes the Performance Indicator Selection window. see Reporter Admin Toolkit Online Help. Provides information on this Report Builder window. Closes this Report Wizard window and opens the next one. (Visible only when you are using Report Wizard). Closes the Performance Indicator Selection window. Closes Report Wizard. ADD button will be enabled again.• • Raw The PI/KPI is calculated with the data fetched from the raw measurement tables when the report is generated.third Report Wizard window . aggregated data is empty.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. When the report is generated. For information on administering aggregations at the NetAct level.Choice column and uses only the raw or aggregated data for calculating the value of the PI/KPI. 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. 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 example the Time and other dimensions. (Visible only when you are using Report Wizard). The selected performance indicator is removed also from the Report Tree in the Report Builder main window under the report name. Button Ok Cancel Next Finish Description Adds the PI/KPI(s) selected in the Available Performance Indicators pane to the Selected Performance Indicators pane. If the table is not found. A report is created in the Report Tree with default values for the report properties. 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. Removes the selected PI/KPI(s) from the Selected Performance Indicators pane. If the table for.

Select a maximum number of results you want displayed. Displays the list of results matching the search criteria. 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. you can use the asterisk (*) as a placeholder for one or more characters. BH checkbox in the Selected PIs pane for each PI/KPI for which BH is available. Opens the previous Report Wizard window. Provides information on this Report Builder window. Item (search icon) Description Enter in the search field the search criteria for the item that you want to find. Cancels your current action and closes the Dimension Selection window. Closes Report Wizard. This field is only present when searching dimension selections (other than the time Max. see Why I do not get the Busy Hour option when creating some reports? for further details. Check this box to ensure the search results exactly match the search criteria. The default is 50 results. Results Case Sensitive checkbox Search results pane Search Level . Closes this Report Wizard window and opens the next one. Time dimension tab Other dimensions tab that contains the tree and the Find tab Buttons Button Ok Description (Not visible when you are using Report Wizard) Closes the Dimension Selection window and confirms all the changes you have made. No other wildcards are supported in the search. (Visible only when you are using Report Wizard).In this window. When you search for substrings. Cancel Back Next Finish Find Tab in Dimension Selection You can specify the search criteria with the Find tab that is visible in Dimension Selection window. For more information. The overall maximum is 80 results. (Visible only when you are using Report Wizard). Note! Report Builder searches for an exact string by default. you can define and edit time and other dimension selections for selected PI/KPIs. and click or press Enter to start the search. BH is only available under certain conditions. 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).

The search result pane displays the list of managed objects that matches the search criteria and for which you have read permission. the summary levels available are: All/Year/Quarter/Month/Day/Hour/Raw. Summary Level option list Allows you to select the summary level for the selected PI/KPI(s). Select the maximum number of search results you want to display. BH is only available under certain conditions. Start Time (Month) or Start Time (Week). Enter the search criteria of the managed object for which you want to search. 4. Time Frame Selection pane The pane includes two options: • • Absolute Relative Absolute If you click the Absolute option. 5. . You can use drag-and-drop to perform the same operation. the summary levels available are: All/Year/Week/Day/Hour/Raw. 3. use the Tooltip to display the full name. Note! The 'raw' summary level mostly describes measurements on quarters of hours (15 minutes). From and To buttons and entry fields appear in the Time Frame Selection pane. The pathname of the item is shown at the bottom of the pane. 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. For more information. Start the search: 2. A search result displays the name of the item and its type represented as an icon. If the pathname is not completely visible. 8.4 Time dimension tab Item Hierarchy option list Description Allows you to select the hierarchy for the time dimension summary levels. If you create a formula. the smallest summary level for this formula can only be 'month' (and not below).dimension). 1. o o Click the (Search) icon or press Enter. Select a search level. If you select monthly hierarchy from the Hierarchy option list. see Why I do not get the Busy Hour option when creating some reports? for further details. combining two facts of which the first exists only on monthly level (or higher) and the second on hourly level. 'BSC'. Select the MO level at which you want the search to be performed. for example. If you select weekly hierarchy from the Hierarchy option list.

Note! Before you can use the calendar.Sun) Select All button Clear Selection button Hour Selection pane This pane includes: • • • 8. Other dimensions can include. 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 . the Length entry field and option list.23) Select All button Clear Selection button The selection of dimensions tabs depends on the selection of measurements. and a calendar appear in the Time Frame Selection pane.5 Other dimension tabs Hour boxes (0 . 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. 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.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. for . End Point option list. 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).

you can either Include the selected objects in your report or Exclude the selected objects from it. Enter the search criteria of the managed object for which you want to search. 3. Select the maximum number of search results you want to display. Select a search level. 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.example. Start the search: 2. This field is only present when searching dimension selections (other than the time dimension). 'BSC'. 8. . The overall maximum is 80 results. you can use the asterisk (*) as a placeholder for one or more characters. For information on the Time dimension tab has other components. for example. Max. The default is 50 results. The selection of this list depends on the dimension. You can either use the icons to compile the Selected list or you can drag and drop objects between the list of available objects and the Selected list. Displays the list of results matching the search criteria. If you click an option. Results Case Sensitive checkbox Search results pane Search Level 1. Note! Report Builder searches for an exact string by default. These objects are either included in your report ( ) or excluded from it ( ) depending on whether and List of selected objects you select Include or Exclude in the List Type options. Item Hierarchy option list Summary Level option list List Type options List of available objects Description Allows you to select the hierarchy for the summary levels. and click or press Enter to start the search.6 Find dimension Tab You can specify the search criteria with the Find tab that is visible in Dimension Selection window. Check this box to ensure the search results exactly match the search criteria. Item (search icon) Description Enter in the search field the search criteria for the item that you want to find. see Time dimension tab. A list of objects that you have selected from the list of available objects. A list of available objects ( ) which differs according to dimensions. Allows you to select the summary level for the selected PI/KPI(s). No other wildcards are supported in the search. Select the MO level at which you want the search to be performed. o o Click the (Search) icon or press Enter. Network or Clear Code. Select a maximum number of results you want displayed. The contents of the list depend on the selection made in the Hierarchy option list. When you search for substrings.

For example. see Defining TopN reports for more details. Top20) report produces only N (20) values. use the Tooltip to display the full name. A TopN report displays a list of a selected number 'N' of the largest or smallest values in the range. A search result displays the name of the item and its type represented as an icon. a report may show the 10 BSC's with the most traffic or the most counted Clear Codes. Note: The TopN report feature can only support a single PI/KPI.7 Report Visualisation options . If the PI selection contains more PIs than the one selected. the database processing has to handle the whole query. You can use drag-and-drop to perform the same operation. The search result pane displays the list of managed objects that matches the search criteria and for which you have read permission. the others are ignored.8 Type tab The Type tab defines TopN reports. The pathname of the item is shown at the bottom of the pane. 5. TopN reports are reports with no time series. Even if a TopN (for example.fourth Report Wizard window In this window. If the pathname is not completely visible.4. Item TopN option list Description You can enter a number which limits the report to displaying the number of highest or lowest . . The Report Visualisation window consists of the following components: • • • • • • Type tab Axis tab Chart Data tab Table Data tab 8. you can edit report settings and decide how the data is grouped when a table or a chart is created. 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. The following figure is an example showing the top 10 (Top10) Clear Codes as a bar chart. For more information.

depending on whether you want the highest or lowest TopN values displayed in the report.. Value). Area. Value) and a tick interval (Tick Intervals) for the Y-Axis. Select PI/KPI option list You can select which PI/KPI is to be affected by the TopN range. 20. Only one PI/KPI can be selected. Pie. Hilo open/close. The default is 'Unlimited' meaning all values are selected. Scatter plot. Closes Report Wizard. The tick interval defines the interval between divisions on the axes. By default.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. The report shows the highest or lowest Top-N values depending on the setting of the Filter For option. You can perform the same operation with drag-and-drop. Finish 8. Cancels your current action and closes the Report Visualisation window. 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. 30. A drop down menu offers you a selection of the top or bottom 10. in which case no PI/KPI option is available. Buttons Ok (Not visible when you are using Report Wizard). 100 values selected for your report. Candle. Closes the Report Visualisation window. In the Title text field. Provides information on this Report Visualisation window. a selection must be made.. Opens the previous Report Wizard window. Bar. (Visible only when you are using Report Wizard). The settings consist of a Title text field and scaling options for the Y-Axis. a maximum value (Max. The scaling options allow you to select a minimum value (Min. Chart Type menu This drop-down menu allows you to select the style of your chart from the following options: Plot. the first value from the PI/KPIs list is displayed in this field. Note! If TopN is activated. meaning that no PI/KPI is selected. If the PI/KPI option is 'Unlimited'. Filter For option list You can select Lowest Values (Descending) or Highest Values (Ascending). If you do not enter any values for the Settings selection . no choice is made available. Hilo. you can enter a name and unit for the primary axis. The default is 'Unlimited'.values. Cancel Back (Visible only when you are using Report Wizard).

Closes Report Wizard. Provides information on this Report Visualisation window. Area. If you do not enter any values for the scaling options and leave the fields empty. (Visible only when you are using Report Wizard). Finish 8. a maximum value (Max. Value). Description (Not visible when you are using Report Wizard). You can perform the same operation with drag-and-drop. The appearance depends on the choice of chart type and is colour-coded for easier use. The tick interval defines the interval between divisions on the axes. Bar. Secondary Y-Axis pane Item Description Performance Indicators pane This pane contains a list of PI/KPIs included in your report. the default is the report name. see Chart and Table Data . Cancels your current action and closes the Report Visualisation window. Cancel Back (Visible only when you are using Report Wizard).10 Chart Data tab The chart data settings determine the data structure and layout of the chart. Pie. Opens the previous Report Wizard window. 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. The scaling options allow you to select a minimum value (Min. Closes the Report Visualisation window. the first value from the PI/KPIs list is displayed in this field. For some typical examples of tables. Value) and a tick interval (Tick Intervals) for the Y-Axis. Candle. Hilo open/close. you can enter a name and unit for the primary axis. Scatter plot. Report Builder automatically calculates values for you. Report Builder automatically calculates values for you. Hilo. In the Title text field. By default. Titles pane This pane has two fields where you can enter text as follows: Settings selection • • Buttons Button Ok X-Axis: enter a name for the X-Axis. Chart Type menu This drop-down menu allows you to select the style of your chart from the following options: Plot. Chart: enter a name for the chart.scaling options and leave the fields empty. The settings consist of a Title text field and scaling options for the Y-Axis.

and BTS1-Uplink and similarly for BTS2-Downlink. BTS2-Signalling. and BTS2-Uplink. The settings define what information is applied to the columns and what information is applied to the rows. For example. and Uplink are placed in the 'One Data Series' per list. Buttons Ok (Not visible when you are using Report Wizard). Signalling. Closes the Report Visualisation window. The generation of values for the X-axis works the same way as for the generation of series. Note! The Time Series Data Completion checkbox is disabled by default. the missing day is still shown in your chart although the value is missing. A typical chart. If the Time Series Data Completion checkbox is enabled.11 Table Data tab The table data settings determine the data structure and layout of the table. Cancels your current action and closes the Report Visualisation window. your chart only shows those dates for which there is data. You can perform the same operation with drag-and-drop. . Item Y-Axis Display one Data Series per pane Description You can define how the dimensions appear in the chart. but not from the 3rd day. reflecting the settings in the pane. Closes Report Wizard. and 4th day of the month. is displayed below the pane. The and icons are used to move dimensions in and out of the Y-Axis Display one Data Series per pane. reflecting the settings in the pane. Opens the previous Report Wizard window. A typical chart. select the checkbox. the dimension Network Element holding BTS1 and BTS2 and the dimension Type holding Downlink. Data series are built for BTS1-Downlink. see Chart and Table Data Examples. The Move Up and Move Down buttons allow you to alter the order of the dimensions in the pane. is displayed below the pane. Cancel Back (Visible only when you are using Report Wizard). you could have data from the 1st. BTS1-Signalling. If you want to enable it. 2nd. You can perform the same operation with drag-and-drop. X-Axis Display pane You can define the dimensions used for the X-axis of the chart. You can define whether a time series should be completed if missing values are filled up by Time Series Data Completion checkbox null values. The and icons are used to move dimensions in and out of the X-Axis Display pane. (Visible only when you are using Report Wizard). The first example shows a series of graphs plotted over time for signal loading on two Base Transceiver Stations (BTS1 and BTS2). Finish 8. There is one data series (one plot on the graph) displayed per list of dimensions selected. For some typical examples of tables.Examples. The Move Up and Move Down buttons allow you to modify the order of the dimensions in the pane. If the checkbox is disabled. Provides information on this Report Visualisation window. Example: In the first chart shown.

Provides information on this Report Visualisation window. and Uplink are placed in the 'One Data Series' per list. Closes the Report Visualisation window. and BTS1-Uplink and similarly for BTS2-Downlink. If the checkbox is disabled. Data columns are built for BTS1-Downlink. the dimension Network Element holding BTS1 and BTS2 and the dimension Type holding Downlink. is displayed below the pane. You can perform the same operation with drag-and-drop. Note! The Time Series Data Completion checkbox is disabled by default. Example: In the first table shown. The and icons are used to move dimensions in and out of Rows . You can perform the same operation with drag-and-drop. A typical table. Cancels your current action and closes the Report Visualisation window. For example. The and icons are used to move dimensions in and out of the Columns . If the Time Series Data Completion checkbox is enabled. but not from the 3rd day.12 Chart and Table Data Examples . your chart only shows those dates for which there is data. Signalling. you could have data from the 1st. The generation of values for a row works the same way as for the generation of columns. Cancel Back (Visible only when you are using Report Wizard). You can define whether a time series should be completed if missing values are filled up by Time Series Data Completion checkbox null values.Item Description Columns . is displayed below the pane. select the checkbox. If you want to enable it. A typical table.Display one Row per pane You can define how the rows appear in the table. and 4th day of the month. BTS2-Signalling.Display one You can define how the columns appear in the table. the missing day is still shown in your chart although the value is missing. Closes Report Wizard. Finish 8.Display one Column per pane. Rows . and BTS2-Uplink.Display one Row per pane. BTS1-Signalling. Buttons Ok (Not visible when you are using Report Wizard). (Visible only when you are using Report Wizard). The Move Up and Move Down buttons Column per pane allow you to alter the order of the dimensions in the pane. reflecting the column layout in the pane. reflecting the row layout in the pane. 2nd. Opens the previous Report Wizard window. The Move Up and Move Down buttons allow you to alter the order of the dimensions in the pane.

Time] Series Per: [Type.] Cols Per: Rows Per: [Type] [Time.Cols Per: Rows Per: [Network Element.Type] [Time.Network Element] Cols Per: Rows Per: [Type] [Network Element.Network Element] XAxis Order: [Time] Chart Type: PLOT .

The Set Scheduling Parameters window consists of the following components: .Series Per: [Type] XAxis Order: [Time.Network Element] Chart Type: BAR Series Per: [Type] XAxis Order: [Network Element.Time] Chart Type: BAR 8.fifth (optional) Report Wizard window In this window. you can define the settings for a scheduled report.13 Report Scheduling options .

. • • • • 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.Note! The parameters become visible only when you have ticked the Scheduled checkbox.

• • If you have selected the Daily scheduling time interval. . or the last day of the month. see Caching and scheduling reports. Note! If you schedule the report as a biweekly report. Otherwise. if you schedule a report on a daily interval but only access it once a month. Note! You can only select a day between the 1st and the 28th of the month. If you have selected the Weekly or Biweekly scheduling time interval.Match this interval with both the time settings of the report and the frequency with which you evaluate it. When the size of the cache exceeds its limit. For more information on the cache. Weekly. If you have selected the Month scheduling time interval. you put an unnecessary load on the system. Generation Time option list The options in the Generation Time list depend on which scheduling time interval (Daily. 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. Reporter does not check the generation time that you select in this field. 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. Biweekly. Email Addresses text field You can specify e-mail addresses to which Reporter sends a notification when a scheduled report has been generated. 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. Contact your NetAct System Administrator for information on time-slots that are suitable for scheduling because of low system load. It is recommended that you set up scheduled reports to be generated during the night. For example. 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. or Monthly) you have selected in the corresponding list. Reporter generates it on the selected day of every odd calendar week. • Note! There is a black-out timeslot for scheduling reports between 12 AM and 3 AM. you can select only the hour of the day when the report is generated from the Time list. a warning message is logged and reminds the system administrator to increase the cache tablespace.

5. 6. Enter a name for the new formula. the name of your new formula appears in the PI Tree. The first Formula Wizard window opens. 3. You can also define the calculation rule for the time dimension. For information on permissions. 1. 7. see Assigning permissions with the Private/Public approach. . 9 FORMULA WIZARD You can define new formulas and edit existing formulas with Formula Wizard. In this window. Change the permission of an existing formula if necessary: o For instructions on how to modify permissions in the Private/Public permission mode. Formula Wizard consists of three windows. Click Next and go to step 8. By right-clicking the formula. you can select which formula you want to edit or insert a new formula in the PI Tree. Expand the PI Tree by double-clicking it. Click Next. If appropriate. The second Formula Wizard window opens. You can remove several e-mail addresses at the same time if you highlight them and click the Remove button. see Assigning permissions with the Role-based approach. 4. select an entry from the list of most common formula definitions.• • You can enter several e-mail addresses at the same time if you separate them by a comma in the Email Addresses field. o o Click the (Formula Wizard) icon in the Toolbar. Note! A formula name needs to be unique in the entire system. o For instructions on how to modify permissions in the Role-based permission mode. o Insert a new formula by highlighting the folder in the PI Tree. You can optionally insert or edit some text to describe the formula or KPI. Depending on whether you want to edit or insert a new formula: o Highlight the formula that you want to edit. see Managing permissions. Start Formula Wizard: o Select Formula -> New -> Formula Ctrl-n from the menu bar. Press the Ctrl-n keys. 8. In this window. 2. It is also recommended to use meaningful names for the formulas. you can use the Description window to describe the formula.

Use drag-and-drop to place PI/KPIs from the Available Performance Indicators pane on to the Selector pane.1 Create a Formula or select a Formula to edit. To avoid mistakes. 11. Find tab that allows you to search for a PI/KPI or formula in the PI Tree. Use SQL commands such as 'sum'. Once Formula Wizard validates your formula. Create In pane that shows the PI Tree for you to select to position of the new report.SDCCH_busy_att$ / $_nokbss. (OPTIONAL) Enter an extra SQL delimiter in the Selector pane (for example.9. The third Formula Wizard window opens. they must contain the 'result' keyword.SDCCH_seiz_att$ > 0). Buttons .performance indicator$) in the Time Aggregation Rule pane. 12. For information. 13. or 'max' as mathematical operations. 'avg'. Click Next. 'avg'. you can insert a new formula in the PI Tree or select which formula you want to edit. $_nokbss. otherwise Formula Wizard does not validate your formula. use drag-and-drop only to place PI/KPIs from the Available Performance Indicators pane on to the Time Aggregation Rule pane. Note! You must enter a specific syntax ($metadata_owner. This tab is also available in other windows. Click Finish. In this window. Formula Description pane that provides a text area where you can add information on the purpose and operation of the formula. Note! All the calculations are based on the result of the time dimensions. If you define other formulas. The example below shows a formula with the correct syntax: sum($_nokbss. you can define other dimension formulas (other than time dimension).first Formula Wizard window In this window. see Find tab. Unit Definition field which is an editable drop-down menu that includes the most common formula definitions. 9. Use SQL commands such as 'sum'. 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. you can proceed.SDCCH_seiz_att$)*100 10. 'min'. 'min'. Define or edit a calculation rule for the time dimension in the Time Aggregation Rule pane. (OPTIONAL) Define a formula for other dimensions except the time dimension. or 'max' as mathematical operations.

Allows you to delete a selected folder or formula from the PI Tree pane. you can define the following selector: counter2>100. Note! All formulas must be defined for the time dimension. The new formula is selected and you can edit its name. o mathematical functions: ABS.2 Define the Calculation Rule for the Time Dimension . You can use all the SQL functions that are available in Oracle.second Formula Wizard window You can define the calculation rule for the time dimension. MIN. SUM. and ROUND o number functions: ROUND. Next Cancel Closes the first Formula Wizard window and opens the second one. For information. 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 in which you can define a new formula. The validation is done by applying the formula in a database query. see Find tab. TRUNC. Find tab that allows you to search for a PI/KPI or formula in the PI Tree. SQRT. Next . If the validation fails. MAX. AVG. 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. STDDEV. see the Oracle documentation. Formula Wizard starts validating your new formula. Buttons Button Validate Description Adds the selected PI/KPI to the Time Aggregation Rule pane or to the Selector pane. For detailed information.Button Description Adds a new formula into a selected folder in the PI Tree pane. The second Formula Wizard window consists of the following components: • • • • Available Performance Indicators pane which contains the PI Tree. 9. Closes the second Formula Wizard window and opens the third one. DISTINCT. and COUNT o other: DECODE. You can ensure that only particular values are taken into account for a formula by defining them in this field. SIGN. FLOOR. The following is the list of the most important SQL functions for PM reports. The button is only enabled when a value has been entered for the time aggregation rule and the validation has successfully run. an error message appears. This tab is also available in other windows. and VARIANCE Selector pane that defines the WHERE part of the SQL statement. Provides information on this Formula Wizard window. and MOD o aggregates or SQL functions: ALL. When you click Validate. NVL. If you click Details. Cancels your current action in Formula Wizard and closes Formula Wizard. you receive information on the failed SQL query. Allows you to rename a selected folder or formula in the PI Tree pane. 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.

3 Define the available Dimensions . otherwise Formula Wizard does not validate your formula. for example.. It is recommended that you use drag-anddrop to place PI/KPIs from the Available Performance Indicators pane to the Selector pane.avg_busy_tch$) / sum($nokbss. some of the other dimension tabs can disappear and some new ones may appear. For example: $nokbss. The delimiter allows invalid records to be filtered out (SQL: where statement) and to avoid divisions by zero in the query. for example: sum($nokbss. 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.Finish Cancel Closes Formula Wizard. Define the calculation rule for the time dimension first. An example of avoiding division by zero: $nokbss.avg_busy_tch$) / sum($nokbss.avg_avail_full_tch$ > 0 Selector pane You can enter an additional SQL delimiter in the optional Selector pane. For example. use drag-and-drop to place the aggregation in the Time Aggregation Rule pane. To build an aggregation. Furthermore.avg_avail_full_tch$) Note! The drag-and-drop feature always inserts the PI/KPI at the cursor position. 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. The third Formula Wizard window contains all dimension tabs but the Time Dimension tab. Time Aggregation Rule pane You can define new formulas in the Time Aggregation Rule pane. These dimensions are based on the result of the calculation rule for the time dimension. a summary based on certain PI/KPIs. If you change your time dimension formula.. Defining calculation rules for the non-time dimensions is optional. Enter an SQL specific syntax. sum. all the calculations are based on the . use drag-and-drop to build a selector as well. Cancels your current action in Formula Wizard and closes Formula Wizard.avg_avail_full_tch$) To avoid a division by zero. Provides information on this Formula Wizard window. All formulas have to be aggregated (avg.) values.third Formula Wizard window You can define formulas for other dimensions than the time dimension. 9.avg_avail_full_tch$ > 0 Note! The drag-and-drop feature always inserts the PI/KPI at the cursor position. 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. count.

Provides information on this Formula Wizard window. 10 KNOWN PROBLEMS 10.1 Printing reports The two dialogs Page Setup and Print give you a wide range of formats. a Page Setup dialog pops up before the Print dialog. 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 example portrait or landscape printing. you can only cancel the Page Setup dialog.result of the time dimensions. • Buttons Button Validate Back Finish Cancel Description When you click Validate. Formula Wizard starts validating your new formula. . You can define another calculation role for a formula as avg(counterXY) in time dimension and as result in the 3G Network dimension. The settings you have made in the Page Setup dialog cannot be overwritten by the settings made in the Print dialog. you must have a keyword result in them. Closes Formula Wizard. Due to system software restrictions. you need to click Cancel in the Print dialog. To cancel printing. However. 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 the calculation rule for a formula as sum(counterXY) in time dimension and as max(result) in the 3G Network dimension. • When you are printing a report. you need to be aware of the following two restrictions. which prevail over the settings you are making in the subsequent print dialog. If necessary. Cancels your current action in Formula Wizard and closes Formula Wizard. table print-outs are split over several pages. 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. • If you click Cancel in the Page Setup dialog. You can make certain page settings. Opens the previous Formula Wizard window. Note! result is assumed by Report Builder for all the formulas for all the non-time dimensions. If you define other formulas. but not printing. it is not possible to transfer the settings made in Page Setup dialog to the Print dialog.

WBTS. Hebrew. UTF-8 (8-bit UCS/Unicode Transformation Format) is a variable-length character encoding for Unicode created by Ken Thompson and Rob Pike. 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. Cyrillic. UTF-8 uses one to four bytes (strictly. Arabic. or WCEL.10. If you have reports in which RNC measurements are used from objects that lack a Global ID. Two bytes are needed for Latin letters with diacritics and for characters from Greek.xls file on the client uses the locale settings of the client. the locally exported . octets) per character. The changes concern managed objects that have no Global ID. especially if the difference is the selection of the decimal separator. For such reports.xls shows the report results with the correct values in the correct format. see Modifying reports.xls file that was attached to the notification e-mail.xls file is generated. open the report. If you encounter formatting problems in the . Syriac and Thaana alphabets . Since exporting to a . You need to reselect the dimension values on each object dimension tab. Note! The default locale on servers is usually US English. 10. that is. yet the initial encoding of byte codes and character assignments for UTF-8 is coincident with ASCII. Only one byte is needed to encode the 128 US-ASCII characters (Unicode range U+0000 to U+007F). For more information on how to edit the settings.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.3 Incorrect values in the Excel sheet that is attached to the e-mail of a scheduled report The values in the Excel sheet (. It is able to represent any universal character in the Unicode standard. This solution allows for keeping the locale settings on your client. depending on the Unicode symbol.xls file from the Reporter application. in Report Browser or Report Builder on your client and export it to a . Armenian. all RNC-related objects except PMLN. which is likely to be cached. 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. RNC. 10.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 .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. you must edit the legacy reports manually for the reports to work.

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.1/Load should not be used in the same report: 1. for example. 10. the result is as follows: Network BSC 1 BSC 2 KPI 59 30 For more information. Network BSC 1 BSC 2 Nokia KPI 59 30 Other vendor KPI By changing the names of both report components to 'KPI'. Actions: .5 PIs not to be used in same report The following PIs in Nokia SGSN SG5. for example Reporter 3. Example: In this example. also applies to Report Builder.(Unicode range U+0080 to U+07FF). see Modifying or deleting Reporter nodes. More than 4000 characters of Description cannot be entered. Hence please ensure this before adding the description of the report. 11.1 How can I check which version of Report Builder is installed? Answer: Open the information pane by selecting Help -> About. 2. peak_load_time(Load) period_duration(Load) 11 FREQUENTLY ASKED QUESTIONS 11. If the description that is entered in Report Builder contains some special characters then a message is displayed.1. Four bytes are needed for characters in other planes of Unicode. the table lists the 'Nokia KPI' and 'Other vendor KPI' values in two different columns. Category: A report design issue. The Reporter version number. Three bytes are needed for the rest of the Basic Multilingual Plane (which contains virtually all characters in common use).

5.3 How do you show different report components based on the same dimension in separate columns? Description: Normally. The other PI/KPIs defined in the report are shown elsewhere.5 How do you deal with a large number of objects in a report? 4.05 2.5.4 KPI_BH 99.5.05 2. 11. One value is.1. The TopN feature supports only a single PI/KPI. for example.4 98.5.05 KPI 99. 3.4 99. Even if a report has more than one PI/KPI. for example. . Select the report in Report Tree. They are also listed in the Axis tab of the Report Visualisation window.9 For more information. Actions: 1. Example: The table shows two values of KPIs for each BSC. see Modifying or deleting Reporter nodes.05 2. Category: A report design issue. 11. Select the report in Report Tree.5.4 98.4 Why does a TopN report shows only one PI/KPI even if the report has more than one PI/KPI? Description: A report is defined with several PI/KPIs and yet the TopN report shows only a single PI/KPI when it is run. 2. 11. only a single PI/KPI is shown. Actions: Define TopN reports only with a single PI/KPI. the normal KPI the other is for the Busy Hour KPI: Network 1.7 98.05 1. the result is as follows: BSC 1.7 98. the Filter For option list defines which PI/KPI is shown. in the Report Tree and in the Chart and Table displays.9 By changing the name of the report component Busy Hour to 'KPI_BH'. report components based on the same dimension are shown in the same column. In the Type tab of the Report Visualisation window.05 KPI 99. Rename the report components to make their names unique within the report scope. Give the same name to the PI/KPIs that have to appear in the same column. 2. for example.5.

'week' for 'A' PI/KPI and 'month' for 'B' PI/KPI. 'A'. for example. For more information. The default behavior. a 1000 objects which are too many to handle in one report in a reasonable way. In the case of PI/KPI 'C'. . If you want all three PI/KPIs (in the example. 'B'. If no summary level is defined for the new PI/KPI 'C'. you need to select each PI/KPI in the Dimension Selection window and check its specific summary level.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. If a query exceeds this limit. You can decrease the amount of values in a report in the following ways: o o o Increase the time summary level or decrease the time frame selection period. is to show the highest common available level which is 'All'.e 'week' for PI/KPI 'A' and 'month' for PI/KPI 'B' and 'day' for PI/KPI 'C'. Category: A capacity limitation. 11. for example. 'day'. 3. a default value is used. 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'. 11. Description: You have. One way to approach this is to produce a higher level report which only displays a selected number of the objects. Actions: • • Select the dimensions and PI/KPIs so a single report query does not fetch more than 200 000 values. Actions: Use the TopN feature to display. in this case.1. The 2.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. and 'C') to have the same summary level 'week' in the Dimension Selection window. for example. Also the other dimensions for both 'A' and 'B' PI/KPIs are different Later if you want to add another PI/KPI called 'C' to the report 'Maintenance'. an error message is displayed. The selected time summary level is. you need to change the summary level to 'week'. The limit is established to avoid a very large query exceeding the system resources. Decrease the number of PI/KPIs. Increase the PI/KPIs summary level or decrease the number of objects. the top 20 best performing and the bottom 20 worst performing objects. A 'Maintenance' report is created with selected 'A' and 'B' PI/KPIs. The example describes what might happen when you add a new PI/KPI to this existing report. Hence no common level can be defined for all the PI/KPIs. 1. see Modifying reports. for example. Each of these PI/KPIs have different time dimensions i.

For example. If you want to use a German keyboard as the default. • • BH is only available for certain PI/KPIs.time summary level changes from 'all' to 'week' indicating that all three PI/KPIs have the same summary level. Report Builder may switch to a wrong keyboard when it starts. and also an English keyboard. 11. BH is not available with the 'raw' and 'hour' summary levels. 11. Set up the keyboard in your Windows Regional Settings.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. To ensure that Report Builder uses the right keyboard: 1.8 Why I do not get the Busy Hour option when creating some reports? Busy Hour (BH) data is not always available. Click Start -> Settings -> Control Panel -> Regional Options -> Input Locales and set up the Installed input locales for the keyboard. use Installed input locales for both keyboards and select the input language which is to be the default and click Set as Default: . 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 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: . 2..

csv. . You can enter report and formula descriptions in Reporter.10 How can I access report component descriptions separately? Reporter does not support separate report component descriptions. Microsoft Excel guides you through a wizard. To display the description of a PI/KPI or a formula while a report component is selected • • Click Description in the Report menu.11. The recommended extension is . the native file format of Microsoft Excel. for example to . The column structure can be destroyed during export to other file formats.11 How can I ensure that the column structure is preserved in a file that I export? 1.xls.txt extension when you save the file. or Description in the local menu. You can also use the . when you export a file from a Reporter application. 11.

11.Always click Next. Open the second window of Formula Wizard: o Select Report -> Time Dimension or Report -> Other Dimension from the Menu bar. 11.Week. you can define day as target level and unselect the hours for which the measurement is not activated in the time selection tab. Select Show SQL from the local context menu If you are interested in the summary method that a formula uses: 1. In otherwords a common summary level will be defined like ‘All.Day’ and hence ‘Raw’ and ‘Hour’ summary level will not be available.14 Why does Report Builder does not show Raw and Hour summary levels when a busy hour counter is added to a report? 1.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. when you later open the file with any plain text editor. Some counters support busy hour and those will have the ‘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. although in a simple tabulated presentation.Normal counters which do not have the busy hour support also contains ‘Raw’ and ‘Hour’summary levels.Year. 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.15 Why does Y-axis title of the chart is displayed wrongly in a report generated when multiple counters are selected? . 11. 2. You create a report by selecting busy_hour counters. 11.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. Since you can define a source level differently from the target summary level in Report Builder. o Select Time Dimension or Other Dimension from the local context menu. Check the summary method in the Time Aggregation Rule pane for the time dimension or in the dimension-specific panes for the other dimensions. The column structure is as expected.then the summary levels which will be defined will be taken by the intersection of all the summary levels for these PIs.13 How can I define the summary level in Report Builder if several measurement types are activated for only some hours per day? 1.

The choices are 'System'. the Y-axis title of the chart will change respectively. 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.the title of the y-axis in the chart will be displayed as the first counter that is selected.It uses 'Agg' automatically if the aggregation is switched on for the whole reporting period. Once this setting is changed . 11. There are 3 aggregation choices available in report builder using which you can create a report. This is a default setting. '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. Normally when a report is created with multiple counters . Hence the title of the Y-axis of the chart is not displayed wrongly.'Raw'and 'Agg'.16 Why is it not possible to create BH report with Aggregation Choice as 'System'? 1. Hence its not possible to create BH and WeekBH reports using the agg choice 'System'.This setting can be modified by selecting the "Report Visualisation" and "Axis" tab and "Primary Y-axis". Moreover the legend of the chart contains all the selected counters representing each one with a specific colour. . If aggregated data is not available then 'Raw' choice is used.1.So this indicates the number of counters selected in the report and the data that is displayed in the chart.

Sign up to vote on this title
UsefulNot useful