Create and Run a Test for a Process

Test a process before publishing it.

Create a Test Run for a Process

Permissions

Your user account or group membership must have the following permissions to create Test Runs for a Process unless your user account has the Make this user a Super Admin setting selected:

Processes: Edit Processes
Processes: View Processes

See the Processes permissions or ask your Administrator for assistance.

Follow these steps to create a Test Run for a Process:

View your Processes.
Configure general settings for the Process. The Configuration tab displays.
Click the Test Run/Scenarios tab to view scenarios for this process.
Click Test Run tab to view tests configured for this process.
Click the +Test button. The Run Test window displays.
From the Starting Point setting, select the Process model object from where to start the test.
Optionally, select Manual Resume Point to stop automated testing at the selected step continue the test manually.
If a Manual Resume Point is not selected, the process will automatically flow and submit all tasks as follows:
- Data from the Scenario setting (if selected) will be used to auto-fill every input field or variable.
- Expressions and validations also rely on the Scenario setting, which has the prefilled data model to drive evaluations.
Optionally, select a Scenario. See details on how to configure a Scenario.
Optionally from the Additional Data setting, add a JSON structure for the test. See details on how to provide additional data.
Select Bypass Scripts tasks and Data Connectors to skip running running any script tasks or data connectors in the process.
Click Run to start the test. The test will run as configured and display relevant information in the run test summary.
Click Run. The test displays in the Test Runs tab.

Review the Test Run

After running a Process Test, Process Modeler simulates workflow routing based on the provided Scenario and/or JSON data. A colored highlight appears on each Process model object triggered during the simulated workflow.

Results from a Test run

Mouse-hover over the Task with the yellow highlight. The following information displays regarding the status of that Task:

Node number in the Process model
Status of the Process model
Hyperlink to the sequentially numbered test

Test result information from a Process model object

The following highlights represent event states during the simulation:

Green-colored highlight: The Process model object completed.
Green-colored highlight denotes that the Process model object completed
Yellow-colored highlight: This is the breakpoint in the automated simulation from which manual testing begins.
Follow these steps to proceed with manual testing:
1. Mouse-hover over the Task with the yellow highlight.
2. Click on the hyperlink of the sequentially numbered test. The Task opens. Manually submit the Task.
Red-colored highlight: An error occurred on the Process model object, and simulation has stopped.
Consider the following when troubleshooting why the error occurred:
- Script Task or Data Connector connector error:
  1. Cancel this test run.
  2. Run the test again. When setting up the test, select the Check to bypass Script tasks and Data Connectors option.
- Exclusive Gateway element error:
  1. Evaluate if the Scenario and/or the provided JSON data contains mock Request data from which to evaluate conditions.
  2. Review the conditions configured for the outgoing Sequence Flow element(s) from the Exclusive Gateway element, and then review the mock Request data.
Red-colored highlight denotes that the Process model object stopped the test at that point

Review a Test Run Again

Click the Play button (left) at the bottom of Process Modeler to replay the current Process Test.

Click the Reset button (center) to reset the test and remove the highlights that represent event states.

Click the Stop button (right) to stop Process Testing and return to editing the Process model.

Cancel a Test Run

Follow these steps to cancel a Test run:

Mouse-hover over the Task with the yellow highlight.
Click on the hyperlink of the sequentially numbered test. The Task opens.
Click the Cancel button in the Cancel Test section of the Task summary.
The Caution screen displays to confirm the cancellation of the test run.
Click Confirm.

Track Tests for a Process

Follow these steps to track tests for a Process:

Configure general settings for the Process. The Configuration tab displays.
Click the Test Run/Scenarios tab, and then select the Test Run tab.
Click a test row. The Process test displays similarly when you are running a Request.
From the Form tab, complete Task Forms similarly to when running a Task.
From the Data tab, edit task data similarly to when running a Task.
From the Overview tab, track your test in a process map similar to when running a Request.
From the Emails tab, check email data during the test.
From the Summary section, check the summary test. There is just an option to cancel the test similar to when running a Request.

Search for a Test in a Process

Permissions

Your user account or group membership must have the following permissions to search for Tests for a Process unless your user account has the Make this user a Super Admin setting selected:

Processes: Edit Processes
Processes: View Processes

See the Processes permissions or ask your Administrator for assistance.

Follow these steps to search Tests created for a Process: