Testing and debugging workflows

Testing is a powerful and essential component of any project.

Let us look at an example. We want to implement a workflow that calculates the cost of a newly created lead. The cost of the lead is sent as an email to the administrator.

To test the workflow, click on the play icon in the top right corner of the trigger. Only saved and valid workflows can be run.

A popup asking for the initial scope appears. The initial scope is data passed to the workflow to perform some operation.

Insert the required parameters and click on the Load and Configure button to set the initial scope. Any missing parameters are automatically added as the empty value of that type.

The last step allows you to change the variables of the initial scope before test running the workflow. Click on the Run Workflow to run the workflow, or on the btb:[Back] button to return to the previous screen.

When you manually run the workflow, you see a green outline that indicates the execution path based on the provided input. If any of the steps fail to execute successfully, they will be marked with a red outline. If there is no error handling, the manual execution will also terminate.

In some cases, your workflows may implement steps that should only run in production, such as client charging, mass email notifications, and similar. We can mock this path of execution by defining a testing flag at the beginning. Before you reach the "in production only" steps, you should use an exclusive gateway to do some special handling, such as logging a message or using a debug step .

When you run the workflow after that step, you should see something like the below example:

Knowing how to debug a specific tool or software can save you a lot of time if you encounter an issue.