Fiorano's unique Event Process orchestration model enables the debugging of live Event Processes in real time. The debugging model gives a view of the current state of executing service instances within Event Processes and also provides a mechanism to setup event interceptors to capture, view, modify and discard messages flowing between service instances on the same or different machines across the network.
Adding Breakpoint
A breakpoint can be added from context menu present on the route or from the Fiorano Debugger view.
In the sections below, Simple Chat event process available in the Samples Event Process Repository is used for the illustration.
Context Menu option
Right-click the route on which breakpoint has to be added and select the Add Breakpoint option.
Figure 1: Adding breakpoint from context menu
When the breakpoint is added, the route color is changed to Red.
Figure 2: Colour of the route changing to red after setting the breakpoint
Debugger View
To add a breakpoint to a route, perform the following steps:
- Go to Fiorano Debugger pane (Window > Show View > Other) and click the Add BreakPoint button as shown in the figure below.
Figure 3: Adding break point from debugger view
- Select the route on which the breakpoint has to be added and click OK to add the breakpoint.
Figure 4: Select route to add breakpoint
When a breakpoint is added on a route, at runtime, the messages passing through the route are intercepted by the breakpoint. The intercepted messages can be viewed, edited or forwarded to the next service instance.
Message body, message properties and the application context can be viewed in the debugger view. When an intercepted message is selected, the properties are shown in the Properties view. The Application context is shown in the Application Context tab.
Managing Breakpoint
Viewing Messages
All the messages sent to a route after running the event process having breakpoint set on it are visible in the breakpoint view when clicked on that particular route. When the messages are intercepted on the route, the route blinks, and the message count gets appended to the route name.
Figure 5: Message at breakpoint in Fiorano Debugger
Editing Messages
To edit a message at debug time, edit the text within the Message tag in the Text tab section (third section in Figure 5); the message gets saved.
Figure 6: Edit message in Fiorano debugger
Inserting Messages
New messages can be inserted into breakpoint at debug time without the message being sent by the source component. To insert messages into breakpoint, perform the following steps:
- Click the Create button in the Messages pane.
Figure 7: Create message in Fiorano debugger
Choose the type of message to be created (either XML or Text message) and click OK.
Figure 8: select type of new message
Releasing Messages
The messages present on a breakpoint can be released anytime so that they reach their destination. To release messages from the breakpoint, perform the following:
- Select the message to be released and click the Send button. The message will be sent to the next service instance in the event process.
Figure 9: Send message in Fiorano debugger
- All messages on Breakpoint can be released at a time by clicking on the Send All button.
Figure 10: Send all messages in Fiorano debugger
All the messages can also be sent at a time from route context menu by right-clicking on the route and by selecting the Send All option.
Discard Messages
To discard the messages from the breakpoint, perform the following:
- Select the message to be discarded and click the Discard button. The discarded message will be removed from Breakpoint.
Figure 11: Discard message in Fiorano debugger
- All messages on Breakpoint can be discarded all at a time by clicking on the Discard All button.
Figure 12: Discard All messages in Fiorano debugger
All the messages can also be discarded at a time from the route context menu by right-clicking on the route and by selecting the Discard All option.
Adding Properties and Attachments
To add a particular property in the message using a breakpoint, click the Add button on the right side of the Properties tab in the Fiorano Debugger, and fill values in the Name and Value properties respectively. To remove a particular property, select the particular property to be removed from the list of properties under the Properties tab, and click the Remove button.
Figure 13: Add/Remove Properties button in the Propertiess tab under Fiorano Debugger
To add an attachment in the message using a breakpoint, click the Add button on the right side of the Attachments tab in the Fiorano Debugger, and select the respective attachment. To remove a particular attachment, select the particular file that has been added under the Attachments tab, and click the Remove button.
Figure 14: Add/Remove/Save Attachments button in the Attachments tab under Fiorano Debugger
Removing Breakpoint
To remove the breakpoint set on a route, select the route on which the breakpoint has to be removed and click the Remove Breakpoint button; the breakpoint will be removed on that route.
Figure 15: Remove Breakpoint in Fiorano debugger
Breakpoints on all the routes can be removed by clicking on the Remove All Breakpoints button.
Figure 16: Remove All BreakPoints in Fiorano debugger
All messages can be sent/discarded at a time from the route context menu also by right-clicking on the route and by selecting the Send All / Discard All option. Also, to remove a breakpoint, select Remove Breakpoint option in the context menu.
Figure 17: Options to Remove BreakPoint and send/discard all messages using Context Menu