66
Serve atOnce Traffica Traffica Z5.2 Traffic News Help DN0171584 Issue 3-0

Pdn 0171584

Embed Size (px)

Citation preview

Page 1: Pdn 0171584

Serve atOnce Traffica Traffica Z5.2

Traffic News Help

DN0171584

Issue 3-0

Page 2: Pdn 0171584

2 DN0171584Issue 3-0

Traffic News Help

Id:0900d805806352ed

The information in this document is subject to change without notice and describes only the product defined in the introduction of this documentation. This documentation is intended for the use of Nokia Siemens Networks customers only for the purposes of the agreement under which the document is submitted, and no part of it may be used, reproduced, modified or transmitted in any form or means without the prior written permission of Nokia Siemens Networks. The documentation has been prepared to be used by professional and properly trained personnel, and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes customer comments as part of the process of continuous development and improvement of the documentation.

The information or statements given in this documentation concerning the suitability, capacity, or performance of the mentioned hardware or software products are given "as is" and all liability arising in connection with such hardware or software products shall be defined conclusively and finally in a separate agreement between Nokia Siemens Networks and the customer. However, Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions contained in the document are adequate and free of material errors and omissions. Nokia Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which may not be covered by the document.

Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO EVENT WILL Nokia Siemens Networks BE LIABLE FOR ERRORS IN THIS DOCUMENTA-TION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDI-RECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION IN IT.

This documentation and the product it describes are considered protected by copyrights and other intellectual property rights according to the applicable laws.

The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark of Nokia Corporation. Siemens is a registered trademark of Siemens AG.

Other product names mentioned in this document may be trademarks of their respective owners, and they are mentioned for identification purposes only.

Copyright © Nokia Siemens Networks 2010/9/9. All rights reserved

f Important Notice on Product Safety Elevated voltages are inevitably present at specific points in this electrical equipment. Some of the parts may also have elevated operating temperatures.

Non-observance of these conditions and the safety instructions can result in personal injury or in property damage.

Therefore, only trained and qualified personnel may install and maintain the system.

The system complies with the standard EN 60950 / IEC 60950. All equipment connected has to comply with the applicable safety standards.

The same text in German:

Wichtiger Hinweis zur Produktsicherheit

In elektrischen Anlagen stehen zwangsläufig bestimmte Teile der Geräte unter Span-nung. Einige Teile können auch eine hohe Betriebstemperatur aufweisen.

Eine Nichtbeachtung dieser Situation und der Warnungshinweise kann zu Körperverlet-zungen und Sachschäden führen.

Deshalb wird vorausgesetzt, dass nur geschultes und qualifiziertes Personal die Anlagen installiert und wartet.

Das System entspricht den Anforderungen der EN 60950 / IEC 60950. Angeschlossene Geräte müssen die zutreffenden Sicherheitsbestimmungen erfüllen.

Page 3: Pdn 0171584

DN0171584Issue 3-0

3

Traffic News Help

Id:0900d805806352ed

Table of ContentsThis document has 66 pages.

1 About Traffic News . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.1 Change Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71.2 Launching External Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3 Workflows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81.3.1 MGW user experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.2 MSS user experience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101.3.3 All call reports for a call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111.3.4 All radio access bearer events for a call . . . . . . . . . . . . . . . . . . . . . . . . 111.3.5 Calls by the same subscriber as a calling party. . . . . . . . . . . . . . . . . . . 111.3.6 Calls in the same cell as a calling party . . . . . . . . . . . . . . . . . . . . . . . . . 11

2 Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.1 Logging into a server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.2 Changing server settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.3 Logging out from a server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.4 Changing the password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.5 Making a new query. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132.6 Running a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152.7 Editing a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162.8 Deleting a Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182.9 Saving query records in a file. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.10 Creating a new field set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192.11 Selecting a field set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202.12 Editing a field set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212.13 Deleting a field set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.14 Changing the user group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222.15 Opening the Clear Code List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.16 Launching an external tool. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232.17 Increasing the Query Result Space of Traffic News . . . . . . . . . . . . . . . 242.18 Creating a New Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242.19 Making a new linked query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252.20 Executing a relevant query to run a workflow . . . . . . . . . . . . . . . . . . . . 272.21 Running a Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282.22 Editing a Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.23 Deleting a Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292.24 Execute the MGW user experience workflow . . . . . . . . . . . . . . . . . . . . 302.25 Executing the MSS user experience workflow. . . . . . . . . . . . . . . . . . . . 30

3 User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

4 Tips and Hints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614.1 Increasing the speed of predefined workflow execution . . . . . . . . . . . . 614.2 Finding text on a list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614.3 Sorting text in a view . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614.4 Getting help on a main window component . . . . . . . . . . . . . . . . . . . . . . 614.5 Finding all calls made by a certain subscriber from a certain area . . . . 61

Page 4: Pdn 0171584

4 DN0171584Issue 3-0

Traffic News Help

Id:0900d805806352ed

4.6 Finding a clear code in a certain area and checking whether any calls to the cell are successful. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62

Page 5: Pdn 0171584

DN0171584Issue 3-0

5

Traffic News Help

Id:0900d805806352ed

List of FiguresFigure 1 Workflow with two linked queries. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8Figure 2 Linked query 1 with MM=BB as query condition . . . . . . . . . . . . . . . . . . . 9Figure 3 Linked query 2 with BB=BB as query condition . . . . . . . . . . . . . . . . . . . . 9Figure 4 Query conditions of the first linked query of MGW user experience . . . 28Figure 5 The results of the MGW user experience workflow. . . . . . . . . . . . . . . . 29

Page 6: Pdn 0171584

6 DN0171584Issue 3-0

Traffic News Help

Id:0900d805806352ed

List of TablesTable 1 Operators and their explanations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Table 2 Status messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Page 7: Pdn 0171584

DN0171584Issue 3-0

7

Traffic News Help About Traffic News

Id:0900d805807e2171

1 About Traffic NewsTraffic News is designed for analyzing Traffica data off-line.

Traffic News allows you to make queries in the database and define conditions for your query.

For more information, refer also to Traffica Principles.

1.1 Change InformationIn Z5.2

Support for creation of New WorkflowYou can now create and execute new workflows in Traffic News. For more information, see the following Workflows.

New Predefined WorkflowsThe following predefined workflows have been added.

– MSS User Experience– All call reports for a call– All radio access bearer events for a call – Calls by the same subscriber as a calling party– Calls in the same cell as a calling party

For more information, see Workflows and Executing the MSS user experience workflow

Support for changing the size of the query result spaceYou can increase or decrease the size of the query result space. For more information, see Increasing the Query Result Space of Traffic News.

Support for separate tabs for each query resultEach query result is now displayed in separate tabs in the Records View / Status View / Details View. For more details, see Tabs.

Support for free text reason codeYou can now enter free text as reason codes every time a query or workflow is executed, if the Administrator has configured Traffic News accordingly.

In Z5.1

Support for execution of Predefined WorkflowYou can now launch predefined workflows from Traffic News. For more information, see the following:

• Workflows • Executing the MGW user experience workflow

Support for Float values • You can now view float values in the query result display of Traffic News. • You can now have query conditions which include float values.

For more information, see the Edit Condition Set dialog of this document.

Page 8: Pdn 0171584

8 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

About Traffic News

Support for Negative Values

• You can now view negative values in the query result display of Traffic News. • You can now have query conditions which include negative values.

For more information, see the Edit Condition Set dialog of this document.

1.2 Launching External ToolsYou can launch external applications from Traffic News Client.

This feature is used to get specific information about a subscriber event, like ending a call or sending an SMS. You can execute a query in Traffic News for this subscriber event. A list of result records is displayed as the result. You can get more specific infor-mation about a particular result record by launching a third party probe vendor’s appli-cation for that record. For more information, see Launching an external tool.

1.3 WorkflowsYou can execute a query with the result of another query as a query condition. Such a query is called a linked query. You can execute a second linked query with the results of the first linked query as a query condition and so on. Such a series of one or more linked queries executed one after the other is called a Workflow.

Figure 1 Workflow with two linked queries

A workflow (i.e. its first linked query) can be executed from the shortcut menu (right click) of a query result row. The linked query is always part of a workflow, and all relevant workflows are visible in this menu.

A workflow (i.e. its first linked query) can be executed only from a relevant query result. For this, the query conditions must be created correctly with correlating fields.

Page 9: Pdn 0171584

DN0171584Issue 3-0

9

Traffic News Help About Traffic News

Id:0900d805807e2171

Figure 2 Linked query 1 with MM=BB as query condition

In the above image, the linked query is executed from Row 2 and 3 of Query Result 1. If the query condition is MM=BB, the linked query searches for fields with values of field MM = 3 and MM = 5 (the values of BB in row 2 and 3 of query result 1) and returns Query Result 2.

A linked query can be executed only from a relevant query result. In the same image, MM=YY is not a valid query condition as query result 1 does not have a field YY in the query result. So, a workflow that has this as the first linked query will not be visible in the shortcut menu of query result 1.

Another example of a linked query is given below.

Figure 3 Linked query 2 with BB=BB as query condition

You can create new workflows or run predefined workflows.

Workflow Use CasesFinding all calls in a cell where a failed call occured

Page 10: Pdn 0171584

10 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

About Traffic News

If the query result contains an A subscriber who experienced a failed MO call in a cell, and you would like to find all the MO and MT Calls in that same cell during the same time, this can be done using the Calls in the same cell as a calling party workflow. The condition used is the following:

A_Cell, B_Cell = A_CellThe condition returns records with A_Cell or B_Cell fields equal to the value of A_Cell taken from the query result.

Further InformationFor more information on how to create a new workflow, you can refer to Creating a New Workflow.

For information on the workflow menu on the Traffic News Menu, refer to Workflow menu.

For information on the workflow tab in the Traffic News Bar, refer to Workflows.

The following sections describe various predefined workflows. Predefined workflows are workflows that are installed as a part of the package. These are installed only if the cor-responding adaptations are also installed. You cannot delete these workflows.

1.3.1 MGW user experienceThis workflow is run from a record generated by the event type 2G/3G/SIP/UMA Call.

From the call details, this workflow finds the Quality of Service (QoS) experienced by the subscribers.

This workflow is visible only if both MGW and MSS adaptations are installed.

g The MGW user experience workflow may return an irrelevant MGW TDM, MGW ATM or MGW IP report in addition to the correct one. You can determine which of the reports is relevant by checking, for example, the values of the Orig_Call_Id or Global_Call_Ref fields.

The reason for the the irrelevant report is that the Context Id is used for merging a call report from MSS to a termination report (MGW TDM, MGW ATM or MGW IP) from MGW.

The maximum number of simultaneous Context Ids per ISU in MGW is limited and the Context Ids are dynamically allocated.

The timeframe within which the Context Id over-rotates depends on the ISU computer unit load in MGW.

If the Context Id is reused for a another call within the workflow query time limits, this might lead to an irrelevant termination report (MGW TDM, MGW ATM or MGW IP) in the results of the 'MGW user experience' workflow.

For more information, see Executing the MGW user experience workflow .

1.3.2 MSS user experienceThis workflow is run from a record generated by the event type MGW_ATM, MGW_IP or MGW_TDM.

From a record that contains details of a particular value of quality of service, this workflow finds the subscribers that experienced this quality of service.

Page 11: Pdn 0171584

DN0171584Issue 3-0

11

Traffic News Help About Traffic News

Id:0900d805807e2171

This workflow is visible only if both MGW and MSS adaptations are installed.

For more information, see Executing the MSS user experience workflow

1.3.3 All call reports for a callg The prerequisite for the All call reports for a call workflow is that Global Call Refer-

ence is supported by the mobile network.

This workflow is run from a record generated by the event type 2G/3G/SIP/UMA Call.

From the call details, this workflow gets all the MSS RTT reports generated for the call. If the call has gone through multiple MSSs, then more than one MSS RTT reports are generated.

In this workflow, the original report from which the workflow is run is included in the results.

This workflow is visible only if the MSC adaptations are installed.

1.3.4 All radio access bearer events for a callThis workflow is run from a record generated by the event type 2G/3G/SIP/UMA Call.

From the call details, this workflow finds the radio access events (Radio Resource con-nection handling, RAB events and Soft handover failures) related to the call.

This workflow is visible only if both MSC and RNC adaptations are installed.

1.3.5 Calls by the same subscriber as a calling partyThis workflow is run from a record generated by the event type 2G/3G/SIP/UMA Call.

This workflow finds all calls made by a subscriber in the last 24 hours from the details of a call made by that subscriber.

This workflow is visible only if the MSC adaptations are installed.

1.3.6 Calls in the same cell as a calling partyThis workflow is run from a record generated by the event type 2G/3G/SIP/UMA Call.

From the call details, this workflow finds all calls which originate or terminate in the par-ticular cell in which the call was made for a time period extending from the call start time to the report time.

This workflow can be used in a scenario where an A-Subscriber experiences a failed call in a certain cell.

In this workflow, the original report from which the workflow is run is included in the results.

This workflow is visible only if the MSC adaptations are installed.

Page 12: Pdn 0171584

12 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

2 Instructions

2.1 Logging into a serverTo log into a server

1. Click Traffic News → Login...

Expected outcomeThe Login dialog opens.

2. Enter the user name and password and click OK.

Expected outcomeThe client connects to the server, and the Records View with the field set that was last used is opened to the Content frame.

2.2 Changing server settingsTo change server settings

1. Click Traffic News → Settings...

Expected outcomeThe Settings dialog opens.

2. Enter the address of the Traffic News server (either the IP address or the computer name), for example the default address 127.0.0.1, into the Traffic News server address box.

3. Enter the Traffic News server port, for example the default port 1241, into the Traffic News server port box.

4. Click OK

Expected outcomeThe changed settings become active after you log out and log in again.

2.3 Logging out from a serverTo log out from a server

1. Click Traffic News → Logout.

Expected outcomeThe Logout confirmation dialog opens.

2. Click Yes

Expected outcomeThe connection to the server is closed and the settings are saved.

Page 13: Pdn 0171584

DN0171584Issue 3-0

13

Traffic News Help Instructions

Id:0900d805807e2171

2.4 Changing the passwordTo change the password

1. Click Traffic News → Change Password...

Expected outcomeThe Change Password dialog opens.

2. Enter the current password

3. Enter the new password

4. Enter the new password again to confirm it and click OK

Expected outcomeThe password is changed.

2.5 Making a new queryTo make a new query

1. Open the Query Editor dialog. To implement this, execute one of the following steps

a. Click on the icon on the toolbar.

b. Click Query → New Query...

Expected outcomeThe Query Editor dialog opens.

2. From the Select databases for the query pane, select the source database(s) where you want to make the query.For information on the options All databases, Customize, Group, and Single, see Query Editor dialog.

3. To implement this, execute one of the following steps:

a. If you want to use relative time for the query, select the time from the query start time list in the Set time limits for the query pane.

b. If you want to use absolute time for the query, select first Select absolute time from the query start time list of the Set time limits for the query pane. Set the time limits for the query by entering them into the query start time and Query end time boxes.

Further informationBy default the date value is in the dd.MM.yyyy format. You can omit the zeros in the beginning of the day and the month, for example, you can enter the date 03.04.2000 as 3.4.2000. By default the time value is in the hh:mm:ss format.

4. Select the events you want to query from the Select events pane.

Page 14: Pdn 0171584

14 DN0171584Issue 3-0

Traffic News Help

Id:

Instructions

5. To implement this step, do one of the following alternatives.

a. If the Reason code is disabled, go to step 4. The query reason is disabled because of any of the following reasons.

– The reason code is disabled in Traffica Admin Tool– The reason code has not been configured by the Administrator. – The reason code is to be entered as free text at the time of query execution.

b. If the Reason code is enabled, select a reason code from the drop down list.

6. If you want to know only the number of records that match the criteria, check the Count only button at the bottom of the Query definitions pane.

7. To add conditions for the query, click Edit Set... in the Match all the conditions pane.

Expected outcomeThe Edit Condition Set dialog opens.

8. Select the field(s) you want to use from the Available fields list and click Add.

Expected outcomeThe selected field(s) are moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

9. To implement this step, choose one of the following alternatives:

a. To add condition(s) for the field(s), click the box in the Condition column and enter the condition directly into the box.

b. If there is a predefined set of values for the condition, click the ... button in the Condition column, select the condition(s) from the Available condi-tions list of the Select Conditions dialog that opens, and click Add and OK.

Expected outcomeThe Select Conditions dialog closes, and the condition(s) are visible in the Selected fields list of the Edit Condition Set dialog.

Further informationIf the format of the entered condition is incorrect or the value is out of the accepted range, the field is highlighted in red.

10. To implement this step, choose one of the following alternatives:

a. If you want the query to return records that match all the conditions in the Selected fields list, select the Match all the conditions (AND) button.

Page 15: Pdn 0171584

DN0171584Issue 3-0

15

Traffic News Help Instructions

Id:0900d805807e2171

b. If you want the query to return records that match any of the conditions in the Selected fields list, select the Match any of the conditions (OR) button.

11. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the condition(s) are visible in the Match all/any of the conditions list of the Query Editor dialog.

12. If you want to combine conditions in the first Match all/any of the conditions list with conditions in the second Match all/any of the conditions list, first select the AND or OR operator between the lists, and repeat steps 7-11 for the second list.

13. If you want to save the query as a Query, click Save As...

Expected outcomeThe Save Query dialog opens.

14. Enter a name and description for the query into the appropriate boxes. If you are an administrator in the current user group, you can also publish the query for others by checking the Publish the query for other users button.

15. Click Save.

Expected outcomeThe query is saved as a Query, and the name and description are visible in the Query Editor dialog.

16. To run the query, click Run.

Expected outcomeThe Query Status dialog shows the progress of the query.

17. When the query is finished, click OK.

Expected outcomeThe Query Status dialog closes, and the results of the query are shown in the Records View in the Traffic News main window.

Further informationIf you want to cancel the query while it is running, click Cancel in the Query Status dialog. The results received so far are shown in the Status View in the main window.

2.6 Running a QueryTo run a Query

1. To implement this step, choose one of the following alternatives:

a. Click Query → Run Query..., select the query you want to run from the queries list of the Run Query dialog, and click Run.

Page 16: Pdn 0171584

16 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

b. Select the query you want to run from the Queries Tab, open the pop-up menu, and click Run.

c. Double-click the query you want to run in the Queries Tab, and click Run in the query Editor dialog that opens.

2. If the Query Reason dialog box opens, enter the reason code.

Expected outcomeYou can view the status of the query in the Query Status dialog. When the execution is complete, close this dialog. The results of the query are shown in the Records View in the Traffic News main window.

Further informationIf you want to cancel the query while it is running, click Cancel in the Query Status dialog. The results received so far are shown in the Status View in the main window.

2.7 Editing a QueryTo edit a Query

1. To implement this step, choose one of the following alternatives:

a. Click Query → Edit Query..., select the query you want to edit from the queries list of the Open Query dialog, and click Open.

b. Select the query you want to edit from the query Tab, open the pop-up menu, and click Edit...

c. Double-click the query you want to edit in the query Tab.

Expected outcomeThe selected Query is opened in the Query Editor dialog.

2. From the Select databases for the query pane, select the source database(s) where you want to make the query.For information on the options All databases, Customize, Group, and Single, see Query Editor dialog.

3. To implement this step, choose one of the following alternatives:

a. If you want to use relative time for the query, select the time from the query start time list in the Set time limits for the query pane.

b. If you want to use absolute time for the query, select first Select absolute time from the query start time list of the Set time limits for the query pane. Set the time limits for the query by entering them into the query start time and Query end time boxes.By default the date value is in the dd.MM.yyyy format. You can omit the zeros in the beginning of the day and the month, for example, you can enter the date 03.04.2000 as 3.4.2000. By default the time value is in the hh:mm:ss format.

4. Select the events you want to query from the Select events pane.

Page 17: Pdn 0171584

DN0171584Issue 3-0

17

Traffic News Help Instructions

Id:

5. If you want to know only the number of records that match the criteria, check the Count only button at the bottom of the Query definitions pane.

6. If you want to modify the values of the fields in the Match all/any of the condi-tions panes, you can type them directly to the Value boxes. You can also leave the Value boxes empty.

7. To add or remove conditions for the query, click Edit Set... in the Match all/any of the conditions pane(s).

Expected outcomeThe Edit Condition Set dialog opens.

8. Select the field(s) you want to use from the Available fields list and click Add.

Expected outcomeThe selected field(s) are moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

9. To implement this step, choose one of the following alternatives:

a. To add condition(s) for the field(s), click the box in the Condition column and enter the condition directly into the box.

b. If there is a predefined set of values for the condition, click the ... button in the Condition column, select the condition(s) from the Available condi-tions list of the Select Conditions dialog that opens, and click Add and OK.

Expected outcomeThe Select Conditions dialog closes, and the condition(s) are visible in the Selected fields list of the Edit Condition Set dialog.

Further informationIf the format of the entered condition is incorrect or the value is out of accepted range, the field is highlighted in red.

10. Select the fields you want to remove from the Selected fields list and click Remove.

Expected outcomeThe removed fields are moved to the Available fields list.

11. To implement this step, choose one of the following alternatives:

a. If you want the query to return records that match all the conditions in the Selected fields list, select the Match all the conditions (AND) button.

Page 18: Pdn 0171584

18 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

b. If you want the query to return records that match any of the conditions in the Selected fields list, select the Match any of the conditions (OR) button.

12. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the condition(s) are visible in the Match all/any of the conditions list of the Query Editor dialog.

13. If the second Match all the conditions list is unavailable and you want to use it, select the AND or OR operator between the lists, and repeat steps 7-12 for the second list.

14. If the second Match all/any of the conditions list is available, but you do not want to use it, select the DISABLE operator between the lists.

Expected outcomeThe second list is no longer available.

15. To implement this step, choose one of the following alternatives:

a. You can overwrite an existing version of a private Query, or if you are an administrator in the current user group a public Query, by clicking Save.

b. You can save the query with a different name by clicking Save As... and entering a name and description for the query into the Name and Descrip-tion boxes of the Save Query dialog. If you are an administrator in the current user group, you can also publish the query for others by checking the Publish the query for other users button before clicking Save.

Expected outcomeThe query is saved as a Query, and the name and description are visible in the Query Editor dialog. You can run the query by clicking Run.

2.8 Deleting a QueryPurposeYou can delete private queries that you have created yourself. Only the administrator(s) of the current user group can delete public queries.

To delete a Query

1. To implement this step, choose one of the following alternatives:

a. Click Query → Delete Query..., select the query you want to delete from the queries list of the Delete Query dialog, and click Delete.

b. Select the query you want to delete from the Query Tab, open the pop-up menu and click Delete...

Expected outcomeA confirmation dialog opens, and, asks you to confirm that you really want to delete the query.

Page 19: Pdn 0171584

DN0171584Issue 3-0

19

Traffic News Help Instructions

Id:0900d805807e2171

2. Click Yes.

Expected outcomeThe selected Query is deleted.

2.9 Saving query records in a fileTo save query records in a file

PurposeIf you want to save only selected records in a file, you should select those records first and then proceed as follows:

1. Click Traffic News → Save Records in File...

Expected outcomeThe Save Records in File dialog opens.

2. In the Records to save pane, select the range which you want to save.For information on different options, see the Save Records in File dialog.

3. In the Use fields from pane, select where the fields are saved from. If you select the Fields from field set button, also select the field set from the list, and either the Fields from Records View or Fields from Details View button.

4. In the File layout style pane, select how you want the fields to be presented in the saved file. If you select the Fields as columns (Records View) button, also select the field separator character from the list.

5. To implement this step, choose one of the following alternatives:

a. In the File name pane, enter the path and the file name into the Save as box.

b. Click Browse..., navigate to the file where you want to save the records, and click Select.

6. Click Save.

Expected outcomeThe records are saved to the selected file.

2.10 Creating a new field setTo create a new field set

1. Click Field Set → New Field Set...

Expected outcomeThe Edit Field Set dialog opens with the Records View tab on top.

2. If you want to use an existing field set as a base for the new field set, select the field set from the Select field set list.

Page 20: Pdn 0171584

20 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

3. Select the field(s) you want to add to the field set from the Available fields list, and click Add.

Expected outcomeThe selected field(s) are added to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

4. If you want to remove fields from the Selected fields list, select the fields and click Remove. If you want to remove all the fields from the Selected fields list, click Remove All.

Expected outcomeThe selected fields or all the fields are removed from the Selected fields list and added to the Available fields list.

5. Click the Details View tab, and select the fields the same way as you did in the Records View tab.

6. Click Save As...

Expected outcomeThe Save Field Set dialog opens.

7. Enter a name for the field set into the Name box. If you are an administrator in the current user group, you can also publish the field set for others by checking the Publish the field set for other users button

8. Click Save.

Expected outcomeThe field set is saved.

2.11 Selecting a field setTo select a field set

1. To implement this step, choose one of the following alternatives:

a. Click Field Set → Select Field Set..., select the field set you want to use from the Field sets list of the Select Field Set dialog, and click Select.

b. Select the field set you want to use from the Field Sets pane, open the pop-up menu. and click Select.

c. Double-click the field set you want to use in the Field Sets pane.

Page 21: Pdn 0171584

DN0171584Issue 3-0

21

Traffic News Help Instructions

Id:0900d805807e2171

Expected outcomeThe selected field set is opened in the current view.

2.12 Editing a field setTo edit a field set

1. To implement this step, choose one of the following alternatives:

a. Click Field Set → Edit Field Set...

Expected outcomeThe Edit Field Set dialog opens with the field set that was last opened in this dialog. If you want to edit another field set, select it from the Select field set list.

b. Select the field set you want to edit from the Field Sets pane, open the pop-up menu and click Edit.

Expected outcomeThe selected field set opens in the Edit Field Set dialog.

2. Select the field(s) you want to add to the field set from the Available fields list, and click Add.

Expected outcomeThe selected field(s) are added to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

3. If you want to remove fields from the Selected fields list, select the fields and click Remove. If you want to remove all the fields from the Selected fields list, click Remove All.

Expected outcomeThe selected fields or all the fields are removed from the Selected fields list and added to the Available fields list.

4. Click the Details View tab, and select the fields the same way as you did in the Records View tab.

5. To implement this step, choose one of the following alternatives:

a. You can overwrite an existing version of a private field set, or if you are an administrator in the current user group a public field set, by clicking Save.

Page 22: Pdn 0171584

22 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

b. You can save the field set with a different name by clicking Save As... and entering a name and description for the field set into the Name and Description boxes of the Save Field Set dialog. If you are an administrator in the current user group, you can also publish the field set for others by checking the Publish the field set for other users button before clicking Save.

Expected outcomeThe field set is saved.

2.13 Deleting a field setPurposeYou can delete private field sets that you have created yourself. Only the administra-tor(s) of the current user group can delete public field sets.

To delete a field set

1. To implement this step, choose one of the following alternatives:

a. Click Field Set → Delete Field Set..., select the field set you want to delete from the Field sets list of the Delete Field Set dialog, and click Delete.

b. Select the field set you want to delete from the Field Sets pane, open the pop-up menu, and click Delete.

Expected outcomeA confirmation dialog opens, which asks you to confirm that you really want to delete the field set.

2. Click Yes.

Expected outcomeThe field set is deleted.

2.14 Changing the user groupTo change the user group

1. Click Traffic News → Change User Group...

Expected outcomeThe Select User Group dialog opens.

2. Select the user group you want to use from the Available user groups list, and click Select.

Expected outcomeA confirmation dialog opens, which asks you to confirm that you really want select the particular user group.

3. Click Yes.

Page 23: Pdn 0171584

DN0171584Issue 3-0

23

Traffic News Help Instructions

Id:0900d805807e2171

Expected outcomeThe user group is changed and the possible results in the view disappear.

2.15 Opening the Clear Code ListTo open the Clear Code List

1. To implement this step, choose one of the following alternatives:

a. In the Details View, select a field with a clear code and press F2 on your keyboard.

b. In the Select Conditions dialog, select a condition (clear code) and press F2 on your keyboard.

Expected outcomeThe Clear Code List opens in a separate window.

2.16 Launching an external toolBefore you start

1. Ensure that records are present in the View.2. Ensure that applications have been configured to launch from a record. For more

information, see Configuring the launch of external applications from Traffic News Client.

1. From the View Menu, click Show Records View or Show Details View.

2. From the Records view, right-click a record or right-click anywhere on the Details View.In the Records View, instead of right-clicking the record, you can select the record and do the following.

1. Click the Record menu.2. Click Show Templates.

You can also use the keyboard shortcut Shift + Right Arrow on a selected record.

Expected outcomeThe shortcut menu is displayed.

3. Click an application from the list of applications displayed in the popup menu.

Expected outcomeThe selected application opens.

Page 24: Pdn 0171584

24 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

2.17 Increasing the Query Result Space of Traffic NewsYou can increase the query result space or Records View / Status View / Details View.

The buttons on the top left corner of this view are used to maximize and minimize the query result space by closing or opening the Traffic News bar. The left arrow button on the top is used to close the Traffic News bar and the right arrow button on the bottom is used to open the Traffic News bar.

2.18 Creating a New WorkflowYou can create a user defined workflow with the same name as a predefined workflow. You can differentiate between the two in the Workflow pane, where the workflows have different icons.

To understand Workflows better, refer to Workflows.

1. Open the Workflow Editor dialog.

a. Click Workflow → New Workflow.

b. Click .

Expected outcomeThe Workflow Editor Dialog opens.

2. In the Workflow Editor dialog, enter the Name and Description of the Workflow

3. To implement this step, do one of the following alternatives.

a. If the Reason code is disabled, go to step 4. The query reason is disabled because of any of the following reasons.

– The reason code is disabled in Traffica Admin Tool– The reason code has not been configured by the Administrator. – The reason code is to be entered as free text at the time of query execution.

b. If the Reason code is enabled, select a reason code from the drop down list.

4. Click Add to configure linked queries. To configure a linked query, ensure that query conditions are configured correctly. Refer to Workflows to understand workflow. For details on how to configure a linked query, refer to Making a new linked query.

5. Click Save As. In the Save Workflow dialog, click Save. A new workflow is now created.

Page 25: Pdn 0171584

DN0171584Issue 3-0

25

Traffic News Help Instructions

Id:0900d805807e2171

2.19 Making a new linked queryTo make a new linked query

1. Open the Workflow Editor dialog. To implement this step, execute one of the following steps.

a. Click Workflow → New Workflow.

b. Click .

Expected outcomeThe Workflow Editor Dialog opens.

2. Click Add

Expected outcomeThe Linked Query Editor Dialog opens.

3. From the Select databases for the query pane, select the source database(s) where you want to make the query.For information on the options All databases, Customize, Group, and Single, see Linked Query Editor Dialog.

4. Configure the query start and end time of the linked query. To implement this step, choose one of the following alternatives:

a. If you want to use current time for the query, edit the query start time or Query end time directly.

Further informationBy default the time format is Current Time.

b. Click the button of the query start time or Query end time fields.The Select Time Fields dialog opens. You can choose one of the following alter-natives.

1. Select Absolute Time and click OK.2. Select Current Time and click OK.3. Select Time Field and select a field from the table below and then click OK.

You can modify the relative offset if the time format selected is not Absolute Time.

5. Select the events you want to query from the Select events pane. Only records generated by this event(s) are queried.

6. If you want to view the results of this linked query during the execution of the workflow, check the Display Results check box.

Page 26: Pdn 0171584

26 DN0171584Issue 3-0

Traffic News Help

Id:

Instructions

7. To add conditions for the query, click Edit Set... in the Match all the conditions pane. If you do not want to add any conditions, go to step 17.

Expected outcomeThe Edit Condition Set dialog opens.

For information on how to add relevant query conditions, see Workflows.

8. To add each condition to the Selected fields table, repeat steps 9 to 15.

9. Select the field(s) you want to use from the Available fields list and click Add.

Expected outcomeThe selected field(s) are moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

10. To add condition(s) for the field(s), choose one of the following alternatives:

a. Click the cell of the Condition column to directly enter values. Go to step 15.

b. Click the button in the Condition column.

Expected outcome Select Conditions for Field: ’Field_Name’ opens.

11. In the Select Conditions dialog, to add condition(s) for the field(s), choose one of the following alternatives:

a. Select the fields from the Available condition fields table and click Add.

b. Select CCD values from the Available CCD mappings and click Add. CCD values are present only for fields that have CCD mappings defined.

c. Click the Add Own Values button to enter your values.

Expected outcomeA row is added to the Selected Conditions table.

12. If the Add Own Values button was pressed in the Step 10, click the Value cell of the added row and enter a value.

13. Click the Operator cell and select an operator from the drop down menu.

Page 27: Pdn 0171584

DN0171584Issue 3-0

27

Traffic News Help Instructions

Id:0900d805807e2171

14. Click OK.

Expected outcomeThe Select Conditions for Field: ’Field_Name’ closes, and the condition(s) are visible in the Match all/any of the conditions list of the Edit Condition Set dialog .

15. Choose one of the following alternatives:

a. Select Match all of the conditions (AND) to make the query return all con-ditions in the Selected Fields table. Click OK.

b. Select Match any of the conditions (OR) to make the query return any of the conditions in the Selected Fields table. Click OK.

Expected outcomeThe Edit Condition Set dialog and the conditions configured are visible in the query conditions table of the Linked Query Editor Dialog. The table name is also updated as Match all of the conditions or Match any of the conditions according to the selec-tion made in this step.

16. If you want to combine conditions in the first Match all/any of the conditions list with conditions in the second Match all/any of the conditions list, first select the AND or OR operator between the lists, and repeat steps 7-15 for the second list.

17. Click OK.

Expected outcomeThe Linked Query Editor Dialog closes and the linked query is now visible in the Workflow Editor Dialog .

For more information, see Workflows.

2.20 Executing a relevant query to run a workflowTo run a workflow, you must first execute a relevant query. You can select one or more rows of the query result, right click, and then select the workflow. Refer to Running a Workflow for other ways of running a workflow.

If you have not executed a relevant query, the workflow will not be visible in the right-click menu.

A relevant query result record must contain the fields listed in the Conditions column of the first linked query of a row.

For example, the MGW User experience workflow is visible only if the query result records contains the fields Orig Call Id and Global Call Ref because these are the con-ditions listed in its first linked query.

Page 28: Pdn 0171584

28 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

Figure 4 Query conditions of the first linked query of MGW user experience

For information on relevant query results of predefined workflows, see Workflows.

2.21 Running a WorkflowA workflow is executed from one or more query result rows. For more information on workflows, refer to Workflows.

1. Execute a relevant query from where the workflow can be launched. A workflow can be launched only from the results of a relevant query. Otherwise it is not available for selection in the next step.

For more information, see Executing a relevant query to run a workflow.

2. Execute one of the following.

a. Select one or more query result rows. Right click on them and select the workflow of your choice. To select more than one row click CTRL.

b. Select one or more query result rows. Select a relevant workflow from the Workflow pane, right-click and click Run.

c. Click Workflow → Run Workflow. Select the workflow of your choice from the Run Workflow dialog.

3. If the Reason code dialog box opens, enter the reason code. The workflow result is displayed.

Page 29: Pdn 0171584

DN0171584Issue 3-0

29

Traffic News Help Instructions

Id:0900d805807e2171

Figure 5 The results of the MGW user experience workflow.

2.22 Editing a Workflow1. Execute one of the following.

a. Right click a workflow from the Workflow pane and click Edit.If you edit a predefined workflow, the changes last for only that session of Traffic News.

b. Click Workflow → Edit Workflow. Select the workflow of your choice from the Edit Workflow dialog.

2. In the Workflow Editor Dialog, select a linked query from the Linked Queries table and click Edit.

3. In the Linked Query Editor Dialog , make the required changes and close the dialog box.

4. Click Save. The workflow has now been changed. For more information on workflows, refer to Work-flows.

2.23 Deleting a Workflow1. Execute one of the following.

a. Right click a workflow from the Workflow pane and click delete.You cannot delete predefined workflows from Traffic News. This can be done by the Administrator using Traffica Admin Tool.

b. Click Workflow → Delete Workflow. Select the workflow of your choice from the Delete Workflow dialog.

The workflow result is now deleted. For more information on workflows, refer to Workflows.

Page 30: Pdn 0171584

30 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Instructions

2.24 Execute the MGW user experience workflowPurposeThis workflow is used to find the Quality of Service (QoS) experience of subscribers. For more information on this workflow, see MGW user experience workflow.

The subscriber is identified by the Global Call Ref and Orig Call Id. The quality of service experienced by the subscriber(s) is found by fetching the user plane information of the subscriber(s) from the MGW database.

1. Make a new query with 2G/3G/SIP/UMA Call selected as an event. Ensure that Global Call Ref, Orig Call Id, Call Start Time and Report Time are present in the Field set used.When adding these fields to the field set, ensure that these fields belong to database records generated by the event 2G/3G/SIP/UMA Call. For more information on how to create a new field set, see Creating a new field set.

To make a new query, see Making a new query. In step 4 of this procedure, select 2G/3G/SIP/UMA Call as the event.

2. Select query result rows that have values for Global Call Ref and Orig Call Id fields. You can select more than one query result rows by pressing the Ctrl key.

3. Execute the MGW user experience workflow. Refer to Running a Workflow to execute the workflow.

Expected outcomeTraffic News starts execution of the the linked queries of this workflow in the config-ured order. A Workflow Status Dialog displays the status of each linked query. If more than one rows have been selected, the linked queries are executed for each row.

4. Once the querying is complete, press OK to see the query results. The query results are displayed as per the configured settings in the Workflow Editor Dialog

Query results are appended to the rows on which the workflow has been executed.

You can now observe the quality of service (For example, Noise Level Reliable) of a customer identified by his Global Call Ref and Orig Call Id.

For more information on workflows, refer to Workflows.

2.25 Executing the MSS user experience workflowPurposeThis workflow is used to find the control plane information of subscribers experiencing a particular Quality of Service (QoS). For more information on this workflow, see MSS user experience workflow.

The subscriber is identified by the Global Call Ref, A Msisdn and Orig Call Id. The sub-scribers experiencing a particular Quality of Service (QoS) is found by fetching the control plane information of the subscriber(s) from the MSS database.

Page 31: Pdn 0171584

DN0171584Issue 3-0

31

Traffic News Help Instructions

Id:0900d805807e2171

1. Make a new query with MGW_ATM, MGW_IP or MGW_TDM selected as an event. Ensure that H248 Ctx Id and Report Time are present in the Field set used.When adding the field to the field set, ensure that the field belongs to database records generated by the event MGW_ATM, MGW_IP, MGW_TDM . For more infor-mation on how to create a new field set, see Creating a new field set.

To make a new query, see Making a new query. In step 4 of this procedure, select MGW_ATM, MGW_IP or MGW_TDM as events.

2. Select query result rows that have values for H248 Ctx Id and Report Time fields. You can select more than one query result rows by pressing the Ctrl key.

3. Execute the MSS user experience workflow. Refer to Running a Workflow to execute the workflow.

Expected outcomeTraffic News starts execution of the the linked queries of this workflow in the config-ured order. A Workflow Status Dialog displays the status of each linked query. If more than one rows have been selected, the linked queries are executed for each row.

4. Once the querying is complete, press OK to see the query results. The query results are displayed as per the configured settings in the Workflow Editor Dialog

Query results are appended to the rows on which the workflow has been executed.

For more information on workflows, refer to Workflows.

Page 32: Pdn 0171584

32 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

3 User Interface

Main window The Traffic News main window consists of the following:

• Menu bar • Toolbar • Traffic News bar • Field Sets pane • Queries pane • Workflows pane • Records View / Status View / Details View • Tabs • Status bar

Menu barThe menu bar of the main window consists of:

• Traffic News menu • Edit menu • View menu • Record menu • Query menu • Workflow menu • Field Set menu • Help menu

Traffic News menuLogin...

Allows you to log into a server.

LogoutAllows you to log out from a server.

Save Records in File...Opens the Save Records in File dialog where you can save the query records in a file.

Change User Group...Opens the Select User Group dialog where you can change the user group.

The fields that are visible in the Records and Details Views depend on the active user group. User groups are defined in Traffica Admin Tool.

g The existing field sets, queries and results are cleared when the user group is changed.

Change Password...Opens the Change Password dialog where you can change the password.

Settings...Opens the Settings dialog where you can change the server settings.

Page 33: Pdn 0171584

DN0171584Issue 3-0

33

Traffic News Help User Interface

Id:0900d805807e2171

ExitExits Traffic News.

Edit menuCopy

Copies the selected text to the clipboard.

Find...Opens the Find dialog where you can search for text in the active dialog.

View menuShow Status Bar

Shows or hides the status bar.

This item is a toggle. When it is ON, the box on the left of the menu item is checked. When it is OFF, the box is not checked.

Show Traffic News BarShows or hides the Traffic News bar on the left of the main window. The Traffic News bar contains the Field Sets, Queries and Workflows lists.

This item is a toggle. When it is ON, the box on the left of the menu item is checked. When it is OFF, the box is not checked.

Show Records ViewShows the Records View.

This and the following two menu items form a range of radio buttons out of which only one can be selected at a time.

Show Status ViewShows the Status View.

Show Details View Shows the Details View.

Enable Field DivisionDivides the records in the Details View into a general pane, A pane and B pane, or forces them all into the general pane.

This item is a toggle. When it is ON, the box on the left of the menu item is checked. When it is OFF, the box is not checked.

Record menuFirst Record

Shows the first record in the current view.

Previous RecordShows the previous record in the current view.

Next RecordShows the next record in the current view.

Last RecordShows the last record in the current view.

Page 34: Pdn 0171584

34 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Show TemplatesDisplays the list of applications that can be launched for the selected record.

This menu item is disabled

• If the Status View is active. • When no records are present in the Records View or the Details View. • If no applications are configured to be launched for the selected record.

For more information on how to configure applications for a record, see Configuring the launch of external applications from Traffic News Client

Query menuNew Query...

Opens the Query Editor dialog where you can make new queries, save them as queries and run them.

Run Query...Opens the Run Query dialog where you can select and run the query.

Edit Query...Opens the Open Query dialog where you can select and open the query you want to edit.

Delete Query...Opens the Delete Query dialog where you can delete queries if you are an administrator in the current user group (public queries) or have created the queries yourself (private queries).

Clear All Workflow ResultsClears the workflow results from the current tab. This option is enabled only if a workflow has been executed.

Workflow menuNew Workflow

Opens the Workflow Editor Dialog for creation of a new workflow.

Edit WorkflowOpens the Open Workflow dialog box. Select a workflow to edit and click Open.

Run WorkflowOpens the Run Workflow dialog box. Select a workflow to execute and click Run.This option is enabled only if a relevant query result is selected in Records View / Status View / Details View.

Delete WorkflowOpens the Delete Workflow dialog. Select a workflow to delete and click Delete.

Field Set menuNew Field Set...

Opens the Edit Field Set dialog where you can create new field sets.

Page 35: Pdn 0171584

DN0171584Issue 3-0

35

Traffic News Help User Interface

Id:0900d805807e2171

Select Field Set...Opens the Select Field Set dialog where you can select the field set you want to use.

Edit Field Set...Opens the Edit Field Set dialog where you can select and edit a field set.

Delete Field Set...Opens the Delete Field Set dialog where you can delete a field set if you are an administrator in the current user group (public field sets) or have created the field set yourself (private field sets).

Help menuHelp on this Application

Opens this Help.

DocumentationOpens the Nokia Siemens Networks NetAct Electronic Documentation browser, which contains all the Traffica Online Helps and Library docu-ments.

AboutOpens a dialog that gives information about the application.

ToolbarThe toolbar contains nine icons. You can see the name of each icon by holding the cursor over it until a tooltip opens with the name.

New QueryOpens the Query Editor dialog where you can make new queries, save them as queries and run them.

New WorkflowOpens the Workflow Editor Dialog where you can add a new workflow. For more information on how to add a workflow, refer to Creating a new workflow.

Save RecordsOpens the Save Records in File dialog where you can save the query records in a file.

First RecordShows the first record in the current view.

Previous RecordShows the previous record in the current view.

Next RecordShows the next record in the current view.

Last RecordShows the last record in the current view.

Show Records ViewShows the Records View.

Page 36: Pdn 0171584

36 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Show Status ViewShows the Status View.

Show Details ViewShows the Details View.

Traffic News barTraffic News bar is the area on the left of the main window, which consists of the Field Sets list , queries list and Workflows List.

Field Sets Shows all the field sets available for the current user. A field set defines which fields are visible in the view. However, the TNES and Event fields are always visible.

You can select and open a field set into the main window by double-clicking the name on the list. You can also open a pop-up menu with the following menu items by clicking the field set name with the right mouse button:

Select Selects the field set and opens it into the main window.

Edit... Opens the field set in the Edit Field Set dialog where you can edit the field set.

Delete... Opens a confirmation dialog, which asks you to confirm that you really want to delete the field set. To be able to delete public field sets you have to be an administrator in the current user group.

QueriesShows all the queries available for the current user. A Query defines the criteria that are used for fetching information from the database.

If you double-click the name of a Query on the list, the query is opened in the Query Editor dialog. You can also open a pop-up menu with the following menu items by clicking the name of the query with the right mouse button:

Run... Runs the Query. You can follow how the query is progressing in the Query Status dialog.

Edit... Opens the query in the Query Editor dialog where you can edit the query, save it, and run it.

Delete... Opens a confirmation dialog, which asks you to confirm that you really want to delete the query. To be able to delete public queries you have to be an administrator in the current user group.

WorkflowsShows all the workflows available for the current user. A workflow is a sequence of linked queries executed one after another. The linked query is executed from the result of the first query.

If you double-click the name of a workflow on the list, the workflow is opened in the dialog. For more information, see Workflow Editor Dialog.

You can create a user defined workflow with the same name as a predefined work-flow. You can differentiate between the two in the Workflow pane, where the work-flows have different icons.

You can also open a pop-up menu with the following menu items by clicking the name of the workflow with the right mouse button:

Page 37: Pdn 0171584

DN0171584Issue 3-0

37

Traffic News Help User Interface

Id:0900d805807e2171

The icons in this pane symbolize the following.

Records View / Status View / Details ViewRecords View lists all the records that resulted from a query and also lists values for the fields. Typically, there are less fields listed in this view than in Details View. The used field set defines which fields are visible both in Records View and in Details View. However, the TNES and Event fields are always visible.

Status View shows the databases that are connected to the client, statuses of the queries, record counts and elapsed times.

Details View gives more detailed information about the selected record: an extended selection of fields, values, and explanations for the fields. When the results are divided into A, B, and general results, also the view is divided into three panes. However, it is possible to force all the fields into the general pane by clicking View → Enable Field Division.

The buttons on the top left corner of this view are used to maximize and minimize the query result space by closing or opening the Traffic News bar. The left arrow button on the top is used to close the Traffic News bar and the right arrow button on the bottom is used to open the Traffic News bar.

TabsEvery time a query is executed, the query results are displayed in separate tabs in the Records View / Status View / Details View. The tabs are independent of each other. Each tab can have its own field sets, i.e. when a user sets a profile for a tab, it is applicable for that tab only.

Run Execute the selected workflow. This option is available only when a relevant query result row(s) has been selected.

Edit.. Opens the Workflow Editor Dialog. You can edit the properties of the workflow here.

Delete Delete the workflow.

Only the administrator of a user group can delete a public workflow.

This option is not enabled for predefined workflows.

Predefined published workflow.

User defined published workflow.

Predefined private workflow.

User defined private workflow

Page 38: Pdn 0171584

38 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

There is no limitation on the number of tabs that can be opened.

Each tab has its own Records/Details/Status View and field set properties. Whenever a query is executed, the results are displayed in a separate tab.

The field set applied on the last active tab is also applied on the new tab.

If the last active tab had the Field division property enabled, it is also enabled for the new tab.

You can also open a pop-up menu with the following menu items by clicking a tab with the right mouse button:

– Close Tab- Close the current tab. – Close All Tabs- Close all the tabs.– Close Other Tabs- Close all tabs except the current tab.

The results of the current tab can be saved to a file.

☞ You can sort the rows in all the views alphabetically and chronologically either in ascending or descending order by clicking the column header.

Status barThe status bar shows the following:

• The number of records that resulted from the query (in Records View and Status View) or the record number of the selected record (in Details View).

• The connection status: either Connected to: <IP address of the server> or Not connected.

• Active User Group: Displays the name of the active user group of the user. • Available Memory: x%: Shows the remaining Java Virtual Memory. If this value

goes below 30%, no more queries or workflows can be executed. To increase the available memory, try closing tabs or clearing workflow results.

Login dialog This dialog allows you to log into the server.

User nameEnter your user name.

PasswordEnter your password.

Save Records in File dialog

In this dialog you can save the query records in a file.

☞ If you want to export the records later in Excel format, you should select the Fields as columns (Records View) button and the TAB separator in the File layout pane, and save the file with the .txt file extension.

Records to save pane

All recordsSelect this button if you want to save all records of a view in a file.

Selected record(s)Select this button if you want to save the records that were selected in the view in a file.

Page 39: Pdn 0171584

DN0171584Issue 3-0

39

Traffic News Help User Interface

Id:0900d805807e2171

RecordsSelect this button if you want to save certain records in a file. Enter the numbers of the records you want to save into the box. Separate individual numbers with commas. You can also enter a number range, for example: 1,3,5-12 or 8.1 - 8.10.

Status View contentsSelect this button if you want to save the contents of Status View in a file. If this button is selected, the Use fields from pane is unavailable.

Use fields from pane

Current viewSelect this button if you want to save fields from the current view.

Selected fieldsSelect this button if you want to save the selected fields from the columns of the current view in a file. You can select a column by pressing CTRL and clicking the column header. If no columns have been selected in the current view, this option is unavailable.

Fields from field setSelect this button if you want to save fields in a certain field set. When this option is selected, you have to select the field set you want to use from the list. Also, select whether you want to save the fields given in Records View or Details View.

All available fieldsSelect this button if you want to save all the available fields in a file.

File layout style pane

Fields as columns (Records View)Select this button if you want the columns displayed horizontally, as they are given in Records View. When this option is selected, you can also define the field separator character by selecting it from the list.

Fields as separate lines (Details View)Select this button if you want the columns displayed vertically, as they are given in Details View.

File name paneSave as

In this box you can enter the path and the name of the file where you want to save the query results or selected parts. You can use any file extension, for example .txt

Browse...Opens the Select File dialog, which allows you to navigate to the desired file.

Change User Group dialog

In this dialog you can change the user group.

Page 40: Pdn 0171584

40 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Available user groups listThis list shows all the available user groups.

NameThis box shows the user group that is currently selected in the Available user groups list. If you want to change the user group to this group, click Select.

Change Password dialog

In this dialog you can change the password.

Enter old passwordEnter the current password.

Enter new passwordEnter the new password.

Confirm new passwordEnter the new password again.

Settings dialog In this dialog you can change the server settings.

Server settings paneTraffic News server address

In this box you can enter the IP address or the computer name of the server where the client logs in.

Traffic News server portInto this box you can enter the number of the TCP/IP port. You can use 1241, for example, which is used in the default data source settings in Traffica for Traffic News.

Query Editor dialog In this dialog you can run queries, make new queries, edit queries, and save queries as queries.

Template nameDisplays the name of the query template. If you are creating a new template, this field is empty until you save the query.

DescriptionDisplays the description of the query template. This field can be empty if the template does not have a description or if you are creating a new template.

Query definitions paneThe Query definitions pane contains three panes: Select databases for the query, Set time limits for the query, and Select events. In addition, it contains the Count only button.

Select databases for the query paneIn this pane you can select the source databases where you want to make the query. If your Traffica is licensed to make only single database queries, Single is the only available option in this pane.

For information on how to configure the source databases for the options All databases, Customize, Group and Single, see the Administering Traffica docu-ment.

Page 41: Pdn 0171584

DN0171584Issue 3-0

41

Traffic News Help User Interface

Id:0900d805807e2171

All databasesSelect this button if you want to query the data in all the TNES databases in the network.

CustomizeSelect this button if you want to form a customized selection of the avail-able TNESs. To define the selection, click the Define... button, and the Select Database dialog opens. In this dialog you can see the timestamp of the oldest available data for each TNES.

GroupSelect this button if you want to use a configured group of TNESs for the query. Also select the group from the list.

SingleSelect this button if you want to use a single TNES for the query. Also select the TNES from the list.

Set time limits for the query paneIn this pane you can set the time limits for the query.

Query start timeIn queries using absolute time, select first Select absolute time from the list, and then enter the day in the dd.MM.yyyy format (if you are using the default format for date). You can omit the zero in the beginning of the day and the month, which means that the date 02.04.2000 can also be entered as 2.4.2000. Enter the time in the hh:mm:ss format (if you are using the default format for time).

In queries using relative time, select the time from the list.

Query end timeIn queries using absolute time, enter the day in the dd.MM.yyyy format (if you are using the default format for date). You can omit the zero in the begin-ning of the day and the month, which means that the date 02.04.2000 can also be entered as 2.4.2000. Enter the time in the hh:mm:ss format (if you are using the default format for time).

In queries using relative time, this field is unavailable.

Select events paneIn this pane you can select the events that you want to include in the query by checking the boxes in front of the relevant events.

Count onlyIf you want to know only the number of records that match the criteria, check this box.

Query reason codeThe administrator could have configured Traffic News to behave in any of the following manner.

Page 42: Pdn 0171584

42 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

– No query reason code required - In this case, the user does not have to provide a query reason code to execute a query.

– Select query reason code from a drop down list of configured options - In this case, the user must select a query reason code from a list of available options. A query reason code is required to execute a query. When a query is executed, a Reason code dialog opens if the reason code was not provided at the time of creation.

– Enter a reason in the text field provided - In this case, a Reason Code Dialog opens when the query is executed and the user must enter a reason in the text field provided.

Query conditions paneThe Query conditions pane is divided into two Match all/any of the conditions lists, with operator buttons between them. The names of the lists depend on which operator has been selected to combine the conditions inside a list.

Match all/any of the conditions listsIf you are creating a new query, the list is empty when this dialog is opened. If you open a Query, the list shows the fields that are defined to be shown here.

You can add fields to the list by clicking Edit Set... and selecting the fields in the Edit Condition Set dialog. You can add or change the values for the fields by entering them directly into the Value boxes, or by defining the values in the Edit Condition Set or Select Conditions dialog. The Edit Condition Set dialog is opened by clicking Edit Set... in the Edit Query dialog, and the Select Conditions dialog is opened by clicking the ... button in the Edit Condition Set dialog. You can also leave the Value boxes empty.

Edit Set...Opens the Edit Condition Set dialog where you can define the conditions for the fields.

DISABLESelect this button if you only want to use the conditions in the first Match all/any of the conditions list as criteria for the query.

ANDSelect this button if you want to use the conditions in both Match all/any of the conditions lists as criteria for the query.

ORSelect this button if you want the query to return records where the conditions in either the first list or the second list match the criteria.

RunStarts the query, and opens the Query Status dialog which gives you information about the query process.

Open... Opens the Open Query dialog where you can select the query you want to open in the Query Editor dialog.

Page 43: Pdn 0171584

DN0171584Issue 3-0

43

Traffic News Help User Interface

Id:0900d805807e2171

SaveAllows you to overwrite private queries and, if you are an administrator in the current user group, also public queries. If you are not an administrator in the current user group, this option is unavailable.

Save As...Opens the Save Query dialog where you can save the query under a different name or overwrite one of your private queries with the current query.

ClearClears all the selections from the dialog, and restores the default settings.

Workflow Editor dialog

The Workflow Editor dialog opens when you double click on a workflow in the Workflows pane.

It also used to create a new workflow. Workflow Editor Dialog.

g For information on how to create a new workflow, refer to Creating a New Workflow. This procedure can be modified and applied for workflows for any adaptation.

NameName of the Workflow

DescriptionDescription of what the workflow is designed to do.

Linked QueriesThis section has a table with a list of linked queries that are part of this workflow.

If a query result supports this workflow, the workflow can be run from a row of the query result. When the workflow is executed, it is the linked queries in this table that are executed in the given order. Each linked query is run from the results of its previous linked query.

This table has the following sections.

Query NameName of the linked query

Display ResultsIf this box is checked, the results of the linked query are displayed in the Records or Details view after the workflow execution.

If this box is not checked, the results of the linked query are not displayed in the Records or Details view after the workflow execution.

Add buttonOpens the Linked Query Editor with a new tab to create a new linked query. You can add a new linked query and configure properties for it. Separate tabs are used for each existing queries of the workflow. For more information, see Linked Query Editor

Edit buttonOpens the Linked Query Editor for the selected linked query. For more informa-tion, see Linked Query Editor.

This button is enabled only if there are rows in the Linked Queries table.

Page 44: Pdn 0171584

44 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Copy & Edit buttonOpens the Linked Query Editor with a new tab to create a new linked query with pre defined values of the selected query. You can change the values of the copied linked query template. For more information, see Linked Query Editor

This button is enabled only if a row is selected from the Linked Queries table.

Delete buttonDeletes the selected linked query. For more information, see Linked Query Editor

This button is enabled only if a row is selected from the Linked Queries table.

Up button Moves the selected linked query upwards so that the order of execution of linked queries of the workflow is changed.

Down button Moves the selected linked query downwards so that the order of execution of linked queries of the workflow is changed.

Reason codeThe administrator could have configured Traffic News to behave in any of the follow-ing manner.

– No reason code required - In this case, the user does not have to provide a reason code to execute a workflow.

– Select reason code from a drop down list of configured options - In this case, the user must select a reason code from a list of available options. A reason code is required to execute a workflow.When a workflow is executed, a Reason Code Dialog opens if a reason code is not provided at the time of creation.

– Enter a reason in the text field provided - In this case, a Reason Code Dialog opens when the workflow is executed and the user must enter a reason in the text field provided.

SaveThis option is enabled only for saving changes to an existing workflow. Use the Save As button to save a newly created workflow.

In case of a predefined workflow, this button is enabled only when changes are made to databases on which the linked query is executed, and the time limits between which a linked query is executed. These changes are lost once the Traffic News session ends.

Save AsThis button is used to save a newly created workflow. It opens the Save Workflow dialog.

CloseClose this dialog box.

HelpOpens the help for this dialog box.

Page 45: Pdn 0171584

DN0171584Issue 3-0

45

Traffic News Help User Interface

Id:0900d805807e2171

Linked Query Editor dialog

This dialog is used to configure and view the properties of linked queries of a workflow. Each linked query is displayed as a separate tab. The components of this dialog box are described below.

Linked Query NameThis field has the name of the linked query.

DescriptionDisplays the description of the linked query. This field can be empty if the linked query does not have a description.

Reset All ButtonClears the values configured for this linked query and fills it with the default values..

Display Results Check boxCheck this box to display the results of this linked query during the execution of the workflow.

Select databases for the query paneIn this pane you can select the source databases where you want to run the linked query.

g If you have a Traffica license only for single database queries, only the Single option is available in this pane.

All databasesSelect this button if you want to run the linked query on all the TNES databases in the network. This option is selected by default.

g Running a query on all the databases in the network can slow down the querying process. It is recommended that the query is run only on selected databases.

CustomizeSelect this button if you want to form a customized selection of the available TNESs. To define the selection, click the Define... button, and the Select Database dialog opens. In this dialog you can see the timestamp of the oldest available data for each TNES.

GroupSelect this button if you want to use a configured group of TNESs for running the linked query. Also select the group from the list.

SingleSelect this button if you want to use a single TNES for running the query. Also, select the TNES from the list.

Set time limits for the query paneIn this pane you can see the time limits for the linked query. The linked query only returns records that have been generated between the time limits defined in this pane. The time limits can be defined in terms of Absolute time, Current time or a selected time field.

Page 46: Pdn 0171584

46 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Query start timeThis is the start time of the linked query. You can edit the contents of this text

field by clicking the button. This button opens the Select Time Fields dialog.

A tool tip is available for this field.

Query end timeThis is the end time of the linked query. You can edit the contents of this text field

by clicking the button. This button opens the Select Time Fields dialog.

A tool tip is available for this field.

Plus/Minus Toggle ButtonSelect plus or minus here. For example, if plus is selected for the query start time, then the query start time is taken as the value in the query start time field plus the value in the corresponding Relative Offset time.

This option is disabled if Absolute time is selected as the time field.

Relative offset timeSet the offset value with respect to the query start time or the query end time.

The maximum possible value of this field is 23:59:59.

This option is disabled if Absolute time is selected as the time field.

Select eventsIn this pane you can select the events that should be included in this linked query by selecting the corresponding check box. Query result returns only those records gen-erated by the selected events.

Query conditionsThe query conditions pane is divided into two Match all/any of the conditions lists, with operator buttons between them. The names of the lists depend on which operator has been selected to combine the conditions inside a list.

Match all/any the conditionsThis list shows the conditions defined for this linked query. The list has the name of the field in the Field column and the condition specified for this field in the Condition column.

If you are creating a new linked query, the list is empty when this dialog is opened. If you open a linked query of a predefined workflow, the list displays the conditions that are predefined for this linked query.

You can add fields to the list by clicking Edit Set... and selecting the fields in the Edit Condition Set dialog. You can add or change the values for the fields by entering them directly into the text fields of the Condition column (if it is a value) or by defining the values in the Edit Condition Set or Select Conditions dialog. The Edit Condition Set dialog is opened by clicking Edit Set... button and the

Select Conditions dialog is opened by clicking the button in a row of this list. You can also leave the Value boxes empty.

Page 47: Pdn 0171584

DN0171584Issue 3-0

47

Traffic News Help User Interface

Id:0900d805807e2171

Edit SetOpens the Edit Condition Set dialog where you can define the conditions for the fields.

DISABLESelect this button if you only want to use the conditions in only the first Match all/any of the conditions list as criteria for the query.

ANDSelect this button if you want the query to return records in both the first and second Match all/any of the conditions lists as criteria for the query.

ORSelect this button if you want the query to return records where the conditions in either the first or second Match all/any of the conditions list match the criteria as criteria for the query.

OKClose this dialog box after saving the configured properties.

CancelCancel the changes made to the properties of the linked query.

HelpOpen the help button for this dialog box.

Reason Code dialog This dialog opens if you have not selected a reason code for the query or workflow at the time of creation.

Enter Reason codeThis component is a text field or a drop down list depending on the configurations made by the Administrator.

If it is a drop down list, select the reason code from the list.

If it is a text field, you can enter the reason code in it.

OKClick this button to make the reason code in Enter Reason Code as reason code.

CancelClick this button to leave this dialog box without configuring a reason code.

HelpClick this button to open the help for this dialog.

Workflow Status Dialog

This dialog is displayed when a workflow is being executed. This dialog has the status of the different linked queries that are being executed for the workflow. Linked queries are executed for each row selected from the Records or Details view.

The components of this dialog are described below.

Workflow NameThe name of the workflow.

Ref #The number of the row from where the workflow was executed.

Page 48: Pdn 0171584

48 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Linked Query NameThe name of the linked query.

TNES NameName of the TNES database where the query is getting executed.

StatusStatus of the linked query execution for the particular query result record. For a description of status displayed here, refer to Status messages.

Record CountThe number of query result records found for this linked query.

Time elapsedThe time taken for the execution of this linked query.

Total count of recordsTotal number of result records returned by the Workflow execution.

OKThis button is enabled only after the workflow execution is complete. Clicking this button closes this dialog and displays the results.

CancelYou can click this button to interrupt the workflow execution and display the partial results acquired. This button is disabled after the workflow execution is complete.

HelpThis button is used to open the help information for this dialog.

Select Database dialog

In this dialog you can select the databases that together form a customized database selection for a query. In this dialog you can also see the time from which the oldest data is available.

Available databases listShows the available databases from which you can choose the ones you want to use.

AddAdds the selected database(s) from the Available databases list to the Selected databases list.

RemoveRemoves the selected database(s) from the Selected databases list.

Remove AllRemoves all the databases from the Selected databases list.

Selected databases listShows the databases that are selected for the temporary database group.

Edit Condition Set dialog

In this dialog you can select the fields for the query and the conditions for the fields.

Available fields listThis list shows the available fields from which you can choose the ones you want to use.

Page 49: Pdn 0171584

DN0171584Issue 3-0

49

Traffic News Help User Interface

Id:0900d805807e2171

Find...Opens the Find dialog where you can search for text in the Available fields list.

Add Adds the selected field(s) from the Available fields list to the Selected fields list.

RemoveRemoves the selected field(s) from the Selected fields list.

Remove allRemoves all the fields from the Selected fields list.

Selected fields listThis list shows the selected fields and the conditions for them.

You can modify or add a condition for a field by typing it directly to the Condition box. Or if the row has the ... button, you can click it and select the condition in the Select Conditions dialog (for queries) or in the Select Conditions for Field: ’Field_Name’ (for linked queries of Workflow). You can also leave the Condition boxes empty.

If the format of the entered condition is incorrect or the value is not in the accepted range, the field is highlighted in red.

In addition, you can organize the fields in the list by using the buttons on the right side of the list. You can move the selected field to the beginning of the list, one up, one down, or to the end of the list.

General principles for entering the query conditions:

• Numbers must be integers. They can be entered either in the decimal (123456789) or hexadecimal (0x1fff674) format. Hexadecimals always have the prefix "0x".

• Negative values can be used. For example, -3. • Float values can be used. For example, 123.45. Float values are always dis-

played with two decimal places. The same precision should be used when querying fields with float values. Example of fields with float values are "MOS Nb" and "MOS Wb"

• Spaces can be used freely. However, a space may be required in some date and time formats.

• Wildcard * or % replaces any number of characters. However, it cannot be used in all format types.

• Wildcard _ replaces one character. However, it cannot be used in all format types.

• Fields can also be compared with other Traffic News Fields. This is applicable only for Workflows.

• CCD Mapping values can also be compared with Traffic News Fields. This is applicable only for Workflows and only if CCD mappings are available for that field.

• In all fields you can enter either "NULL" or "EXISTS". Neither of them are case sensitive.

• To search for fields that do not have a value, enter NULL. • To search for fields that have any value, enter EXISTS.

Page 50: Pdn 0171584

50 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Match all the conditions (AND)Select this button if you want the query to return records that match all the con-ditions in the Selected fields list.

Match any of the conditions (OR)Select this button if you want the query to return records that match any of the conditions in the Selected fields list.

Select Time Fields In this dialog you can select how time text fields can be represented. This dialog box opens from a button associated with a time text field. The time representation selected here is applied to the associated time text field when this dialog box is closed.

Select Current TimeSets the time in the time field to current time. You cannot edit the field when the dialog box is closed but you can set an offset to this time.

Select Absolute Time Sets the time text field to an absolute time format. You can edit the text field once the dialog box is closed.

Operator Explanation

, (comma) A logical OR. For example, if you enter "3,4,5" any field in the database that has any of the values 3 or 4 or 5 matches the query.

- (dash) A range, for example 4-8. The range is inclusive, which means that values 4 and 8 are also included. A range can be combined with commas, for example: "4-8,20-30, 49".

Note: the operator cannot be used in all format types. It is not allowed for, for example, 'Country Code'... In case the operator is wrongly used, the field is highlighted in red.

Negative values. Negative values can also be used in ranges as given in the below examples.

1--10 (All values from 1 to -10)

-1--10 (All values from -1 to -10)

-1-10 (All values from -1 to 10)

< (less than)

> (greater than)

<1000

>2000.11.20 00:00:00 (When used with time, greater than means after the given time.)

Note: the operators cannot be used in all format types. They are not allowed for, for example, 'Country Code', 'Mobile Country Code', 'Mobile Station', 'Mobile Operator'... In case the operators are wrongly used, the field is high-lighted in red.

! (NOT) A logical 'NOT'. It returns all the existing values that are something else than the given value. For example, the expression '!2' will return all the values of the specified field that are other than '2'.

Note: the operator cannot be used in all format types. It is not allowed for types that accept only the values 'true (1)' and 'false (0)', for example, 'Serv. A Aoc'. In case the operator is wrongly used, the field is highlighted in red.

Table 1 Operators and their explanations

Page 51: Pdn 0171584

DN0171584Issue 3-0

51

Traffic News Help User Interface

Id:0900d805807e2171

Select Time FieldSets the time text field to a time field selected from the table below. You can check this radio button and select a field from the table below. Once the dialog box is closed, you can set an offset to this time field.

You can only see those time fields that you have permission to see. This is defined by the user group settings defined by the Administrator.

Find... ButtonOpens a Find dialog which can be used to find fields in the Select Time field table.

OKClose the dialog box and apply the selected option to the time text field.

CancelCancel the dialog box and the selection made.

HelpOpens the help information for this dialog box.

Save Workflow This dialog box opens when you click on the Save As button of the Workflow Editor Dialog.

WorkflowsContains a list of workflows to which the changes can be saved to. Select a workflow from this list and click Save. The changes are overwritten into the selected work-flow.

NameEnter the name of the new workflow to which the changes should be saved to. The changes can be saved to a new workflow. Enter the name of the new workflow and click Save.

DescriptionEnter the description of the workflow. Description provided in the Description field of the Workflow Editor Dialog is seen here.

Publish the workflow for other usersCheck this box if the workflow has to be published and visible to all members of the user group to which the user belongs to.

SaveClick this button to create a new workflow or overwrite the changes on an existing workflow.

CancelClick this button to cancel the changes made.

HelpClick this button to open a help for this dialog.

Select Conditions for Field: ’Field_Name’

The dialog box opens from the Selected fields pane of the Edit Condition Set dialog. Each row added to this table is a query condition using a selected field. This condition can be further configured using this dialog box.

Page 52: Pdn 0171584

52 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

The title of this dialog box contains the name of the field from which this dialog was opened. Conditions created in this dialog is compared to this field. Conditions can be created using another field, a CCD value, or with values that you define.

Available conditions fields paneIn this pane, you can select fields from the Available conditions table to compare with the selected field. This is done by clicking the Add button to add the fields to the Selected conditions table.

Available conditions fields tableField Column

This column has the fields that are available to you to create conditions. Only fields of the same data type are listed here.

Event ColumnThis column lists the events that trigger reports containing the field of the Field Column.

Find...Opens the Find dialog where you can search for text in the Available condi-tions table.

AddAdds the selected field and the corresponding event from the Available condi-tions table to the corresponding columns in the Selected conditions table.

You can now create a condition with this field by selecting an operator from the drop down menu that opens when you click the corresponding cell in the Selected conditions table. The default operator (blank) is the equals operator.

Available CCD Mappings paneIn this pane, you can select CCD values from the Available CCD Mappings table to compare with the selected field. This is done by clicking the Add button to add the CCD value to the Selected conditions table.

This pane is enabled only if the selected field has CCD mappings.

Available CCD Mappings tableCondition Column

This column has the CCD values that are available to you to create condi-tions.

Explanation ColumnThis column lists the description of the CCD value in the Condition Column.

Find...Opens the Find dialog where you can search for text in the Available CCD Column table.

AddAdds the selected field from the Available CCD Mappings table to the Selected conditions table. You can now create a condition with this field.

Page 53: Pdn 0171584

DN0171584Issue 3-0

53

Traffic News Help User Interface

Id:0900d805807e2171

You can now create a condition with this field by selecting an operator from the drop down menu that opens when you click the corresponding cell in the Selected conditions table. The default operator (blank) is the equals operator.

Selected Conditions paneShows the conditions that have been added. When the OK button is clicked, all the conditions selected here are configured as conditions, separated by commas. The conditions are bound by the OR operator.

Selected conditions tableThis is a table containing the selected conditions. The columns in this table are listed below.

OperatorA drop down menu opens up when a cell in this column is clicked. You can select an operator that defines the relation between a parameter in this row and the selected field from which the Select Condition Field dialog was opened.

Field This column is populated by adding Fields from the Available conditions fields table.

You cannot directly edit this column.

Events This column is populated when Fields are added from the Available condi-tions fields table. The corresponding Events from the Available condi-tions fields table are added in this column.

You cannot directly edit this column.

Condition This column can be edited only in a row that has been added using the Add Own Value button.

You can also populate this column by adding events from the Available CCD Mappings table.

Explanation This column is populated when Conditions are added from the Available CCD Mappings fields table. The corresponding Explanations from the Available CCD Mappings fields table are added in this column.

You cannot directly edit this column.

Add Own ValueAdd a condition row in the Select conditions table. You can edit the Value cell of this row by single clicking it.

f Do not double click the cell/row. The row is deleted when it is double-clicked.

RemoveRemoves the selected condition(s) from the Selected conditions table. More than one condition can be selected by holding down the SHIFT key.

Page 54: Pdn 0171584

54 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Remove AllRemoves all the conditions from the Selected conditions table.

Delete Workflow This dialog box has a list of workflows. You can select a workflow from this list and click the Delete button to delete it. Predefined workflows cannot be deleted.

Workflows Contains a list of workflows visible to the user.

NameName of the workflow selected from the Workflows list.

DescriptionsDescription of the selected workflow.

DeleteSelect a workflow from the Workflows list and click on this button to delete it.

CancelCancel the dialog box without deleting any workflow.

HelpOpen help information for this dialog box.

Open Workflow This dialog box has a list of workflows. You can select a workflow from this list and open it for editing.

Workflows Contains a list of workflows visible to the user.

NameName of the workflow selected from the Workflows list.

DescriptionsDescription of the selected workflow.

OpenSelect a workflow from the Workflows list and click on this button to open it in the Workflow Editor Dialog.

CancelCancel the dialog box without deleting any workflow.

HelpOpen help information for this dialog box.

Run Workflow This dialog box has a list of workflows. You can select a workflow from this list and execute it.

Workflows Contains a list of workflows that are relevant to the query result row(s) selected.

NameName of the workflow selected from the Workflows list.

DescriptionsDescription of the selected workflow.

Page 55: Pdn 0171584

DN0171584Issue 3-0

55

Traffic News Help User Interface

Id:0900d805807e2171

RunSelect a workflow from the Workflows list and click on this button to execute it.

CancelCancel the dialog box without executing any workflow.

HelpOpen help information for this dialog box.

Select Conditions dialog

In this dialog you can select predefined values to be used as criteria for the query.

Available conditions listShows the available conditions and explanations from which you can choose the ones you want to use.

Find...Opens the Find dialog where you can search for text in the Available conditions list.

AddAdds the selected condition(s) from the Available conditions list to the Selected con-ditions list.

RemoveRemoves the selected condition(s) from the Selected conditions list.

Remove AllRemoves all the conditions from the Selected conditions list.

Selected conditions listShows the selected conditions.

Find...Opens the Find dialog where you can search for text in the Selected conditions list.

Save Field Set dialog In this dialog you can save a field set under a new name. You can overwrite private field sets, and if you are an administrator in the current user group also public field sets, with the current field set. If you are an administrator in the current user group, you can also publish the field set for others.

Field sets listThis list shows all the available field sets.

NameThis box shows the name of the field set that is selected in the Field sets list. You can overwrite an existing field set only if you are an administrator in the current user group (public field set) or have created the field set yourself (private field set).

If you want to save the field set under a different name, write the name into this box.

Publish the field set for other usersCheck this box if you want to publish the field set for others. You can publish field sets for others only if you are an administrator in the current user group.

Run Query dialog In this dialog you can select and run a Query.

queries listThis list shows all the available queries.

Page 56: Pdn 0171584

56 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

NameThis box shows the query that is selected in the queries list. You can run the query by clicking Run.

DescriptionThis box shows the description for the query that is currently selected in the queries list. This box can also be empty if no description has been defined for the query.

Open Query dialog In this dialog you can select the query you want to open in the Query Editor dialog.

queries listThis list shows all the available queries.

NameThis box shows the query that is selected in the queries list. You can open the query by clicking Open.

DescriptionThis box shows the description for the query that is currently selected in the queries list. This box can also be empty if no description has been defined for the query.

Query Status dialog In this dialog you can view the status information from the queried TNES(s).

Query template nameDisplays the name of the template that is used.

TNES nameShows the name of the TNES whose database is being queried.

StatusShows any of the following status messages:

Status message Explanation

Query started... Indicates that a querying process has started.

Query running... Indicates that the query is being executed.

Query failed (no connection) Connection to the server was closed during the query, usually due to an error.

Query completed Query was completed successfully.

Query completed (maximum limit for result set reached)

Query was completed successfully but there were more matching records in the database than were defined for the user group in Traffica Admin Tool as the maximum size for a result set.

Query result count returned Query was completed successfully, and the number of records (not the actual records) that matched the criteria is displayed.

Query in queue: initial position is Query was successfully received and put on hold. Shows the initial position of the query in the queue.

Query in queue (high database load) Query was successfully received and was put on hold because the database temporarily overloaded.

Query failed (database switchover) Query failed because a database switchover was started while the query was in progress.

Table 2 Status messages

Page 57: Pdn 0171584

DN0171584Issue 3-0

57

Traffic News Help User Interface

Id:0900d805807e2171

Record countShows the number of records that matched the query conditions.

If the record count shows the maximum value, for example 200, it can indicate that there are exactly 200 matches, or that there are still more records that would match your query but they are not shown because the maximum size for a result set has been reached.

Time elapsedShows the time that has elapsed since the starting of the query process.

Total count of recordsDisplays the total number of records that matched the query.

Save Query dialog In this dialog you can save a query as a new Query. You can also overwrite private queries, and if you are an administrator in the current user group also public queries, with the current query. If you are an administrator in the current user group, you can also publish the query for others.

queries listShows all the queries that are available.

Query failed (high database load) Query was cancelled to free processor time for Traf-fica’s use.

Query failed (empty databases) The Query Execution Process (QEP) failed to find any data from the databases, or there are no data-bases running.

Query failed (server lost connection to TNES) The server lost the connection to the TNES.

Query failed (internal error in the query execution process)

Possibly an error in the configuration files. For more information about the error, refer to the QEP log files.

Query cancelled on user request Query was successfully cancelled upon a user request.

Query failed (invalid query conditions) The format of the given query conditions is invalid.

Query failed (no data available for the given time period)

There are two possible reasons: either there is no data available for the time period defined by the user, in which case the user has to modify the query start or end time in the Query Editor dialog, or there are no tables containing data for the events the user selected.

Query failed (configuration files changed) Configuration files were changed while the query was running. To remedy the situation, rerun the query.

Query failed (database does not contain the queried field X)

Database does not contain the specified field X for which the user has entered a condition. To remedy the situation, the user has to remove the condition from the field X.

Status message Explanation

Table 2 Status messages (Cont.)

Page 58: Pdn 0171584

58 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

NameThis box shows the name of the query that is selected in the queries list. You can overwrite an existing query only if you are an administrator in the current user group (public queries) or have created the query yourself (private queries).

If you want to save the query under a different name, write the name into this box.

DescriptionThis box shows the description of the query that is selected in the queries list. If you are overwriting a Query, you can modify this description by entering the desired text into this box.

If you are saving the query under a different name, write a description for it in this box.

Publish the query for other usersCheck this box if you want to publish the query for others. You can publish queries for others only if you are an administrator in the current user group.

Delete Query dialog In this dialog you can delete a Query. Only an administrator of the current user group can delete public queries. However, anyone can delete their own private queries.

queries listThis list shows all the available queries.

NameThis box shows the name of the query that is selected in the queries list. If you want to delete it, click Delete.

DescriptionThis box shows the description of the query that is selected in the queries list. This box can also be empty if no description has been defined for the query.

Edit Field Set dialog In this dialog you can edit a field set, create a new field set, and save the field set.

Select field set Select the field set that you want to edit from this list.

Records View tabAvailable fields list

This list shows all the available fields for Records View.

Find...Opens the Find dialog where you can search for text in the Available fields list.

Add Adds the selected field(s) from the Available fields list to the Selected fields list.

RemoveRemoves the selected field(s) from the Selected fields list.

Remove AllRemoves all the fields from the Selected fields list.

Selected fields listShows the fields that are selected to be shown in the field set in Records View.

Page 59: Pdn 0171584

DN0171584Issue 3-0

59

Traffic News Help User Interface

Id:0900d805807e2171

You can also organize the fields by using the arrow buttons on the right side of the list. You can move the selected field to the beginning of the list, one up, one down, or to the end of the list.

Find...Opens the Find dialog where you can search for text in the Selected fields list.

Details View tabAvailable fields list

This list shows all the available fields for Details View.

Find...Opens the Find dialog where you can search for text in the Available fields list.

Add Adds the selected field(s) from the Available fields list to the Selected fields list.

RemoveRemoves the selected field(s) from the Selected fields list.

Remove AllRemoves all the fields from the Selected fields list.

Selected fieldsShows the fields that are selected to be shown in the field set in Details View.

You can also organize the fields by using the arrow buttons on the right side of the list. You can move the selected field to the beginning of the list, one up, one down, or to the end of the list.

Select Field Set dialog

In this dialog you can select the field set that you want to open.

Field sets listThis list shows all the available field sets.

NameThis box shows the field set that is selected in the Field sets list. You can open the field set by clicking Select.

Delete Field Set dialog

In this dialog you can delete a field set. Only an administrator of the current user group can delete public field sets. However, anyone can delete their private field sets.

Field sets listThis list shows all the available field sets.

NameThis box shows the name of the field set that is selected in the Field sets list. If you want to delete it, click Delete.

Find dialog In this dialog you can search for text in the dialog from which this dialog was opened.

Text to findIn this box you can enter the text you want to search for.

Match caseCheck this box if you want to search for text that has the same pattern of upper and lower case letters as the text you entered into the Text to find box.

Page 60: Pdn 0171584

60 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

User Interface

Match whole words onlyCheck this box if you only want to search for whole word occurrences of the text written in the Text to find box.

Wrap aroundCheck this box if you want the search to continue from the other end of the list when an end is reached.

Direction pane

UpSelect this button if you want to search toward the beginning of the list for the text written into the Text to find box.

DownSelect this button if you want to search toward the end of the list for the text written into the Text to find box.

Page 61: Pdn 0171584

DN0171584Issue 3-0

61

Traffic News Help Tips and Hints

Id:0900d805807e2171

4 Tips and Hints

4.1 Increasing the speed of predefined workflow executionYou can increase the speed of execution of a predefined workflow execution by select-ing only the necessary databases on which the linked query can be run. This selection is done in the Linked Query Editor dialog.

4.2 Finding text on a listWhen the focus is on a list, you can start writing the text you want to find and the list is automatically scrolled so that the first item that matches what you have written is selected.

4.3 Sorting text in a view You can sort the rows in all the views alphabetically and chronologically either in ascending or descending order by clicking the column header.

4.4 Getting help on a main window componentYou can get help on a main window component by clicking the right mouse button, and selecting What’s This.

4.5 Finding all calls made by a certain subscriber from a certain area

To find all calls made by a certain subscriber from a certain area

1. Click Query → New Query....

Expected outcomeThe Query Editor dialog opens.

2. Specify the source databases for the query in the Select databases for the query pane.

Further informationIf you know the TNES and MSC which the area belongs to, you can select the Single button, and then the relevant database from the list. If you do not know the TNES and MSC which the area belongs to, select the All databases button.

3. To implement this step, choose one of the following alternatives:

a. If you want to use relative time for the query, select the time from the query start time list in the Set time limits for the query pane.

Page 62: Pdn 0171584

62 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Tips and Hints

b. If you want to use absolute time for the query, select first Select absolute time from the query start time list of the Set time limits for the query pane. Set the time limits for the query by entering them into the query start time and Query end time boxes.

4. Select GSM_Call from the Select events pane.

5. Click Edit Set... in the Match all the conditions pane.

Expected outcomeThe Edit Condition Set dialog opens.

6. Select the "A Cell," "A Lac," "A Bsc" or "A Direction Number" field from the Available fields list and click Add.

Expected outcomeThe selected field is moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right of the list.

7. Add one of the following conditions for the fields by clicking the relevant box in the Condition column and entering the condition directly into the box:

• A Cell: the cell ID, for example 101 • A Lac: the location area code, for example 300 • A Bsc: the BSC ID, for example 200 • A Direction Number, for example 1234567890

Expected outcomeThe condition is visible in the Selected fields list.

8. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the conditions are visible in the Match all/any of the conditions list of the Query Editor dialog.

9. Click Run.

4.6 Finding a clear code in a certain area and checking whether any calls to the cell are successfulAs an example, A subscribers cannot reach any B subscribers located in a certain cell. A subscribers get information that B subscribers are busy, but you know that the B sub-scribers have not been on the phone. To investigate these calls, find a clear code in a certain area and check whether any calls to the cell were successful.

Page 63: Pdn 0171584

DN0171584Issue 3-0

63

Traffic News Help Tips and Hints

Id:0900d805807e2171

To find a clear code in a certain area

1. Click Query → New Query....

Expected outcomeThe Query Editor dialog opens.

2. Specify the source databases for the query in the Select databases for the query pane.

Further informationIf you know the TNES and MSC which the area belongs to, you can select the Single button, and then the relevant database from the list. If you do not know the TNES and MSC which the area belongs to, select the All databases button.

3. To implement this step, choose one of the following alternatives:

a. If you want to use relative time for the query, select the time from the query start time list in the Set time limits for the query pane.

b. If you want to use absolute time for the query, select first Select absolute time from the query start time list of the Set time limits for the query pane. Set the time limits for the query by entering them into the query start time and Query end time boxes.

4. Select GSM_Call from the Select events pane.

5. Click Edit Set... in the Match all the conditions pane.

Expected outcomeThe Edit Condition Set dialog opens.

6. Select the "Dx Cause," and "B Answered Time" fields from the Available fields list and click Add.

Expected outcomeThe selected fields are moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

7. Add the following conditions for the fields by clicking the relevant box in the Condition column and entering the condition directly into the box:

• Dx Cause: 0x4, 0x5 (that is clear code values 4H "B busy or congestion received from outgoing circuit" and 5H "B subscriber busy")

• B Answered Time: null

Expected outcomeThe conditions are visible in the Selected fields list.

Page 64: Pdn 0171584

64 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Tips and Hints

8. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the conditions are visible in the Match all/any of the conditions list of the Query Editor dialog.

9. Click Run, and wait for the results.

10. Click Traffic News → Save Records in File...

Expected outcomeThe Save Records in File dialog opens.

11. In the Records to save pane, select for example All records.

12. In the Use fields from pane, select for example the Fields from field set button. Also select the field set from the list, and for example the Fields from Details View button.

13. In the File layout style pane, select for example the Fields as separate lines button.

14. To implement this step, choose one of the following alternatives:

a. In the File name pane, enter the path and the file name into the Save as box.

b. Click Browse..., navigate to the file where you want to save the records, and click Select.

15. Click Save.

16. Open the saved file and investigate fields "B Pcm", "B Tsl", and "B Cgr" to find out whether these calls were cleared in only certain CGRs or PCMs or TSLs

To check whether any calls to the cell were successful

1. Click Query → New Query....

Expected outcomeThe Query Editor dialog opens.

2. Specify the source databases for the query in the Select databases for the query pane.

Further informationIf you know the TNES and MSC which the area belongs to, you can select the Single button, and then the relevant database from the list. If you do not know the TNES and MSC which the area belongs to, select the All databases button.

3. To implement this step, choose one of the following alternatives:

a. If you want to use relative time for the query, select the time from the query start time list in the Set time limits for the query pane.

Page 65: Pdn 0171584

DN0171584Issue 3-0

65

Traffic News Help Tips and Hints

Id:0900d805807e2171

b. If you want to use absolute time for the query, select first Select absolute time from the query start time list of the Set time limits for the query pane. Set the time limits for the query by entering them into the query start time and Query end time boxes.

4. Select GSM_Call from the Select events pane.

5. Click Edit Set... in the Match all the conditions pane.

Expected outcomeThe Edit Condition Set dialog opens.

6. Select the "Dx Cause," and "B Cell" fields from the Available fields list and click Add.

Expected outcomeThe selected fields are moved to the Selected fields list.

Further informationYou can select several fields by pressing CTRL while selecting the fields. You can also search for a field in the list by clicking the Find... button, which opens the Find dialog.

In addition, you can organize the fields in the Selected fields list by selecting the field you want to move and clicking the arrow buttons on the right side of the list.

7. Add the following conditions for the fields by clicking the relevant box in the Condition column and entering the condition directly into the box:

• B Cell: the cell ID, for example 102 • Dx Cause: 0x0 (that is clear code value "Normal end of the call")

Expected outcomeThe conditions are visible in the Selected fields list.

8. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the conditions are visible in the Match all/any of the conditions list of the Query Editor dialog.

9. Click Run.

Finding out how many emergency calls there have been in the whole network in the last two hours

1. Click Query → New Query....

Expected outcomeThe Query Editor dialog opens.

2. Specify All databases as the source databases for the query in the Select data-bases for the query pane.

Page 66: Pdn 0171584

66 DN0171584Issue 3-0

Traffic News Help

Id:0900d805807e2171

Tips and Hints

3. Select Last 2 hours from the query start time list in the Set time limits for the query pane.

4. Select GSM_Call from the Select events pane.

5. Check the Count only button in the Query Definitions pane.

6. Click Edit Set... in the Match all the conditions pane.

Expected outcomeThe Edit Condition Set dialog opens.

7. Select the "Emergency Call" field from the Available fields list and click Add.

Expected outcomeThe selected field is moved to the Selected fields list.

8. Add the condition for the field by clicking the box in the Condition column and entering 1.

Expected outcomeThe condition is visible in the Selected fields list.

9. Click OK.

Expected outcomeThe Edit Condition Set dialog closes, and the conditions are visible in the Match all/any of the conditions list of the Query Editor dialog.

10. Click Run.