Siebel Business Process Framework: Workflow Guide > Testing a Workflow Process > Process of Testing a Workflow Process >

Preparing and Using the Process Simulator


This task is a step in Process of Testing a Workflow Process.

Preparing the Process Simulator

In this task you prepare the process simulator for use, which includes exposing the Simulate Toolbar, and preparing debug settings.

Table 54 describes debug run-time information you must configure.

Table 54. Description of Fields Used With the Siebel Tools Debugger

Field

Value

Executable

$SiebelClient\BIN\siebel.exe

Make sure you enter the full path for the siebel.exe executable file.

CFG file

$SiebelClient\BIN\ENU\uagent.cfg

Make sure you enter the full path for the uagent.cfg configuration file.

Browser

$\Program Files\Internet Explorer\iexplore.exe

Working directory

$SiebelClient\BIN

Arguments

/h

User name

$username

Password

$password

Data source

$datasource

To prepare debug settings for the Siebel client

  1. In Siebel Tools, from the application-level menu, choose View > Toolbars > Simulate.

    This exposes the Simulate toolbar.

  2. From the application-level menu, choose View > Options, then click the Debug tab.
  3. Define the fields in the Debug tab according to the guidelines listed in Table 54, where $ represents settings specific to your setup.
  4. Click OK.

Next, you use the process simulator.

Using the Process Simulator

In this task, you invoke then run the Process Simulator on a workflow process.

For more information, see Considerations for Using the Process Simulator. For examples that use the simulator, see Using the Process Simulator and the Watch Window to Test the Workflow, and Testing the Workflow Process.

Before you run the Process Simulator or deploy your workflow process, you should Validate the workflow. For more information, see About the Validate Tool.

CAUTION:  When testing a workflow process using the Process Simulator, it is important to note that the workflow runs just as if it were called in a production environment. For instance, if the process includes a Siebel operation such as update or add, records in the database are modified when you run the Process Simulator.

To use the Process Simulator

  1. Close all Siebel client sessions.

    To avoid encountering a multiple client session error, you must close all client sessions prior to launching the Process Simulator. You cannot start the Process Simulator if a Siebel client session is running.

  2. Confirm there are no Siebel client icons in the Task Bar.
  3. In the OBLE, locate then right-click the Workflow Process object definition you need to simulate.

    As an alternative, you can launch the simulator from within the Process Designer. To do so, launch the Process Designer for the workflow you need to simulate, right-click anywhere in the Process Designer background, then choose Simulate.

  4. Choose Simulate Workflow Process.

    The Process Simulator opens. A read-only version of the workflow process diagram displays where the canvas appeared previously. The canvas is replaced with a pale yellow background, the start step is highlighted to mark the simulation's starting point, and the Start Simulation button on the Simulate toolbar becomes active.

  5. In the Simulate toolbar, click the Start Simulation button to begin the simulation.
  6. The Simulation In Progress dialog box appears momentarily.
  7. Observe the Siebel client launch, then wait for control to return to Tools.

    A new instance of the Siebel client launches, displaying the Administration-Business Process Process Simulator screen. For more information, see Siebel Client Usage With the Process Simulator.

  8. In the Simulate toolbar, click the Simulate Next button to execute the highlighted step.
  9. Continue clicking the Simulate Next button until the last step has executed.

    As you step through the workflow process, examine results of each step in the Watch window until the workflow process finishes. For more information, see About the Process Simulator Watch Window.

  10. If the workflow process does not execute as expected, take corrective action, then restart the simulation at Step 5.

    For more information, see Troubleshooting Workflow Process Simulation.

  11. (Optional). Examine test results in the Siebel client.

    If your workflow process manipulates record data, you might be able to examine test results in the Siebel client. To view an example that manipulates record data through the process simulator, see Testing the Workflow Process.

  12. Close the Simulator window.

After the last step has executed the simulation automatically ends. You can also use the Stop Simulation button to halt the simulation before the last step executes.

Siebel Business Process Framework: Workflow Guide Copyright © 2008, Oracle. All rights reserved.