5.1.3 Overview of debugging
Debugging is the process of using the Debug view and the service template debugging view to check the operation of a service template you have built, and identify issues in its flow or plug-ins. When you debug a service template, JP1/AO creates a debug service and debug task. The debug process involves executing this debug task.
If the debug process reveals an issue, the user stops debugging and edits the affected service template or plug-in.
Objective
Perform a debug operation to make sure the flow and plug-ins of a service template are working as intended. For example, you can confirm that property mapping is set correctly and that the conditions for executing subsequent steps branch the flow in the intended way. In the Debug view and the service template debugging view, you can:
-
Execute debug tasks while checking the flow transitions at all hierarchical levels (including hierarchy flows and repeated flows) and the results of plug-in processing.
-
Execute debug tasks while making sure that property values are assigned correctly by the property mapping configured for the service template.
-
If you detect an issue with a plug-in, you can assign an arbitrary property value or return value to the plug-in and execute it again. This allows you to see the effect a given property value or return value has on the plug-in processing and flow transitions.
Number of executions
You can debug a service template any number of times. If the debug process reveals an issue with the service template, the user can repeat the series of operations from amending the development service template or development plug-in to building and debugging until all issues are resolved.
Debug services
A debug service is a service generated and executed when debugging a service template. One debug service is generated per service template. When you debug a service template that has already been through a debug process, JP1/AO deletes the existing debug service and creates a new one.
Note that debug services appear in the Service Name column in the Debug-Tasks view, but do not appear in the Services window.
Debug tasks
A debug task is a task generated for a debug service when debugging a service template. When you debug a service template that has already been through a debug process, JP1/AO deletes the existing debug task and creates a new one.
Debug tasks appear in the service template debugging view and Debug-Tasks view. Only users assigned the Admin or Develop role can view and work with debug tasks.
Note that debug tasks do not appear in the task summary.
Related topics