With effect from Version 14.2 of Questetra BPM Suite, it is possible to run debug processes on individual Auto-Processing Tasks in the middle of a Workflow App. This enables App developers to test the functionality of a single Step in a Process without having to go through the entire process

Debug Only This Node

Similar to the method of debugging described in this page, you must open the Settings window for the Step you wish to debug in the App Modeler. Below the [Note] section is a button labelled [Debug only this node] with a bug icon.

Clicking the [Debug only this node] button will open the Debug Process Execution window, from which the debug process can be initiated by clicking the [Start Process] button.

Unlike starting a debug process from a Start Event, in which the debug Task will flow through the entire Process, when it is started from an Auto-Processing Step a dummy workflow App is created, consisting of a Start Event, a Human Task (which the user will operate from the [My Tasks] list), the Auto-Processing Step which is the target of the debug process, and an End Event.

Workflow Diagram when debugging a single node

The [Debug only this node] option is available for all Auto-Processing Tasks, including all grey Tasks listed on R2010: List of Modeling Elements, Tasks listed in Add-on Auto-Steps which can be added to the workflow platform manually, your self-made Add-ons, [Throwing Message Intermediate Event (email)], and [Throwing Message Intermediate Event (HTTP)].

In The Task Lists

Debug processes can be easily identified on lists such as [My Tasks] or [Operated Tasks], etc. by looking for the bug icon prefix in the title column.

Debug Tasks in the My Tasks list

It is also possible to filter debug processes by clicking on the filter list icon filter_list, then click the Add Condition button and select [bug_report Debug Process] from the menu. The list of filter conditions will then show radio buttons allowing you to select whether to display only debug processes, or to exclude debug processes from the list of Tasks.

Filter whether to view or exclude debug processes

Debug Processes are excluded from aggregation in the [Heatmap], [Dashboard], [Your performance], and [Organizational performance]; and when creating a new chart in the [Chart] menu, the filter condition [except debug processes] is now specified by default.

Debug Results

The Auto-steps that can be debugged using this method have a great variety of functions, so please be aware that the results of debugging will vary depending on the function of the Step. In many cases the results will not necessarily be visible in Questetra, but may take effect in an external cloud service.

For example, when debugging the item [Google Drive: Upload File], it will be necessary to check your Google Drive account to confirm that the debug process has been successful, as this is where the effects of the Auto-step are visible.

To view the effects of debugging in Questetra you can view the [Operation History] in the [Process Details] Screen, and with [Administrator Mode] you can view the Process Log. Alternatively, many Auto-processing Steps have the option to store logs in a Data Item, so by selecting an appropriate Data Item in the log field within the settings window of the Step you can retain details about the Step’s operation during debugging.

%d bloggers like this: