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:

  1. Configure general settings for the Process. The Configuration tab displays.

  2. Click the Test Run/Scenarios tab to view scenarios for this process.

  3. Click Test Run tab to view tests configured for this process.

  4. Click the +Test button. The Run Test window displays.

  5. From the Starting Point setting, select the Process model object from where to start the test.

  6. Optionally, select Manual Resume Point to stop automated testing at the selected step continue the test manually.

  7. 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.

  8. Optionally, select a Scenario. See details on how to configure a Scenario.

  9. Optionally from the Additional Data setting, add a JSON structure for the test. See details on how to provide additional data.

  10. Select Bypass Scripts tasks and Data Connectors to skip running running any script tasks or data connectors in the process.

  11. Click Run to start the test. The test will run as configured and display relevant information in the run test summary.

  12. 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.

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

The following highlights represent event states during the simulation:

  • Green-colored highlight: 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. 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.

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:

  1. Mouse-hover over the Task with the yellow highlight.

  2. Click on the hyperlink of the sequentially numbered test. The Task opens.

  3. Click the Cancel button in the Cancel Test section of the Task summary.

  4. Click Confirm.

Track Tests for a Process

Follow these steps to track tests for a Process:

  1. Configure general settings for the Process. The Configuration tab displays.

  2. Click the Test Run/Scenarios tab, and then select the Test Run tab.

  3. Click a test row. The Process test displays similarly when you are running a Request.

  4. From the Form tab, complete Task Forms similarly to when running a Task.

  5. From the Data tab, edit task data similarly to when running a Task.

  6. From the Overview tab, track your test in a process map similar to when running a Request.

  7. From the Emails tab, check email data during the test.

  8. 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:

  1. Configure general settings for the Process. The Configuration tab displays.

  2. Click the Test Run/Scenarios tab, and then select the Test Run tab.

  3. Enter in the Search setting the text to filter tests.

As you enter text into the Search setting, tests display that match your entered text.

If there are no search results, the following message displays: No Results.

Last updated

© Copyright 2000-2024 ProcessMaker Inc. All rights reserved.