--- title: "Create and Run a Test for a Process" slug: "create-and-run-a-test-for-a-process" updated: 2025-08-19T13:29:54Z published: 2025-08-19T13:29:54Z canonical: "docs.processmaker.com/create-and-run-a-test-for-a-process" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # Create and Run a Test 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](/v1/docs/permission-descriptions-for-users-and-groups#processes) permissions or ask your Administrator for assistance. Follow these steps to test a Process: 1. [Open a process for editing in the Modeler.](/v1/docs/view-edit-and-search-for-processes) 2. Click the ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/777948db-4c4e-487a-9a2d-ad527b2cb621.png)menu, and then select the **Run Test** option. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/4eaf6f85-c825-4abb-ba65-391c9afa4384.png) 3. From the **Starting Point** setting, select the modeling object from where to start the test.![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/e8390b3a-2785-40f6-a4f8-f527fb8044e8.png) 4. Optionally, select **Manual** **Resume** **Point** to stop automated testing at the selected step and continue the test manually. > [!NOTE] > - If a **Manual Resume Point** is selected, all steps from that point onward must be completed manually. > - Users must manually fill in all screens. Data types of controls and screen validations will be checked. 5. If a **Manual** **Resume** **Point** is not selected, the process will automatically flow and submit all tasks. > [!NOTE] > - If a **Manual Resume Point** is not selected, data from the selected scenario or **Additional** **Data** setting will be used to auto-fill input fields in screens or request variables. > - The same data will also be utilized to evaluate gateway conditions and route the workflow accordingly. > - If no scenario is selected or the Additional Data setting is empty, all tasks will be automatically submitted without any data or conditions. In this case, screen validation rules will not be checked. 6. From the **Scenario** setting, optionally select a scenario. [See details on how to configure a Scenario](/v1/docs/designer-modeller-create-a-scenario-for-a-process). 7. Optionally in the **Additional Data** setting, add JSON data for the test. You can enter JSON data manually or obtain it from the [**Data** tab of a completed request of a process](/v1/docs/json-data-visualization). 8. Select **Bypass Scripts tasks and Data Connectors** to skip running any script tasks or data connectors in the process. 9. Click **Run** to start the test. The test will run as configured and [display results in the Modeler](/v1/docs/create-and-run-a-test-for-a-process#review-the-test-run). 10. A complete summary of all test runs can also be viewed in the [Test Runs List](/v1/docs/create-and-run-a-test-for-a-process#track-all-tests-for-a-process). --- ## Review a Test Run After [creating and running a Process Test](/v1/docs/create-and-run-a-test-for-a-process#create-a-test-run-for-a-process), Process Modeler simulates workflow routing based on the provided Scenario and/or JSON data. > Use the controls at the bottom of the Modeler to **Run**, **Rerun**, or **Stop** a test. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/f091b7cc-ec70-480f-b387-3ba4084efc50.png) As the test runs, each modeling object is highlighted in a color to indicate its status. - **Green:** This indicates that the task has been completed. Hover over the task to view its details. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5012c53c-1016-46f6-94d5-6bd42c41d920.png) - **Blue:** This indicates that the task is currently active. If the **Manual Resume** option was selected, click the task to open the form and submit it. Otherwise, wait for the task to be completed automatically. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/ec93d4c9-5a2e-4b14-9166-bc2c164901a9.png) - **Gray:** This indicates that the task is pending or was not executed. - **Red:** This indicates an error. Hover over the step to review the error. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/efa6e52c-c4c6-434b-a0aa-8af8fa4e249d.png) --- ### Cancel a Test Run Follow these steps to cancel a Test run: 1. Hover over a task in an in-progress test. 2. From the task details, click the test number. For example, `test #160` to view the currently active task. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/58c7e050-38b4-4256-9190-6dc41d9150f9.png) 3. Click the **Cancel** button in Task summary pane on the right. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/c590f8fd-af90-428a-b020-b313aba9bbf8.png) 4. A **Caution** screen displays to confirm the cancellation of the test run. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/2f7d0df4-0e0a-4954-b17c-bc8971c879aa.png) 5. Click **Confirm** to cancel the test. --- ## Track all Tests for a Process Follow these steps to track tests for a Process: 1. [Configure general settings for the Process](/v1/docs/configure-general-process-settings). The **Configuration** tab displays. 2. Click the **Test Run/Scenarios** tab, and then select the **Test** **Run** tab. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/5a235c4c-0655-47a5-b230-66027e3fe967.png) 3. Click on a test to view its details. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/113a0194-bec4-42d4-8f6e-283fc16381a1.png) 4. From the **Form** tab, view or complete [Task Forms](/v1/docs/open-a-task#task-form). 5. From the **Data** tab, [edit task data](/v1/docs/open-a-task#editable-task-data). 6. From the **Overview** tab, view an in-flight process map. 7. From the **Emails** tab, check email data during the test. 8. The summary panel on right displays details of the test request and provides an option to cancel the test.