Siebel Business Process Framework: Task UI Guide > Testing and Troubleshooting a Task UI > Process of Testing a Task UI >

Process of Using the Task Debugger

This task is a step in Process of Testing a Task UI.

To use the task debugger, perform the following tasks:

1. Making the Debug Mode Available
2. Running the Task Debugger

The Task Debugger is a tool you can run to test a task UI. When you use the Task Debugger, you use the Debug Mode in the Siebel client, performing the same work that the end user is expected to perform. The debugger allows you to read a watch window that displays values of various properties that are involved with the task while progressing through the task.

Making the Debug Mode Available

This task is a step in Process of Using the Task Debugger.

To use the task debugger, you can step through the task UI in debug mode. Debug Mode is a restricted menu item. To run the task debugger from the application client, you must make the Debug Mode menu item available. The EnableRestrictedMenu parameter controls the display of the Debug Mode menu item. If EnableRestrictedMenu is set to TRUE, then the Debug Mode item is visible on the Tools application level menu for the Siebel client. If EnableRestrictedMenu is set to FALSE, then the Debug Mode menu item is not visible.

The procedure you perform depends on the type of web client you are using.

To make the debug mode available when using the Mobile Web Client

1. Open the configuration file (.cfg) for the application in a text editor.

   For example, uagent.cfg in D:\Siebel\81\21031\MWC\BIN\ENU.

2. In the [InfraUIFramework] section of the configuration file, set the EnableRestrictedMenu parameter to TRUE.

   For example:

   [InfraUIFramework]

   EnableRestrictedMenu = TRUE

   If EnableRestrictedMenu is not in the InfraUIFramework section, then add it.

3. Save your changes, then close the file.

NOTE:  If the EnableRestrictedMenu parameter is set to something other than True or False, or if it is not defined under [InfraUIFramework], then the Debug Mode menu item is not visible unless you possess access to the Admin-Restricted Menu Items view.

To make the debug mode available when using the Web Client

1. In the Siebel client, navigate to the Administration-Server Configuration screen, then the Servers view.
2. In the Siebel Servers list, choose the Siebel Server of interest.
3. Click the Components view tab.
4. In the Components list, query the Component field for the appropriate application object manager.

   For example, Call Center Object Manager (ENU).

5. Choose the Parameters view tab that appears below the Components list.
6. In the Component Parameters list, query the Parameter field for EnableRestrictedMenu.
7. Set the value to True.

   To disable debug mode, set the value to False.

Running the Task Debugger

This task is a step in Process of Using the Task Debugger.

You can toggle Debug Mode on or off before, during, or after execution of the task by choosing the Tools menu, then the Debug Mode menu item from the application level menu in the Siebel client.

To run the task debugger

1. Log in to the Siebel client.
2. From the application level menu, choose the Tools menu, then the Debug Mode menu item.
3. Click the Open Task Pane icon to open the task pane.

   The Open Task Pane icon is in the same row of icons as the Site Map icon.

4. From the task pane, drill down on the task UI to be debugged.

   The task UI is launched, and the start step in the task is executed.

   The Task Properties watch window is displayed for the chosen task UI, displaying the properties for the step that was most recently executed, which in this case is the start step. Under the name of the task being debugged there is a line titled Last Action, which indicates the last navigation action that was performed. For example, Next.

   You can switch on the debugger watch window within a task instance.

5. Click Continue in the watch window.

   The next step in the task UI is executed. If the next step is a task view step, then a task view is displayed.

6. Click one of the playbar buttons in the task view in order to continue to execute and debug the task UI.
7. Repeat Step 5 and Step 6 to proceed through the debugging of the task UI.

   Debugging terminates when the end step is reached.

8. (Optional) To terminate a debugging session during execution of the task UI, you can click Stop in the watch window, or click Cancel in a task view.