Contents

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.

Icon

A breakpoint can be added in Online Event Process Development perspective only.

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:

  1. 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
     
  2. 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:

  1. Click the Create button in the Messages pane.


    Figure 7: Create message in Fiorano debugger
     
  2. Choose the type of message to be created (either XML or Text message) and click OK.

    Icon

    For a Text type, a default message is inserted, which can be edited in the Text section. For XML type, the XML schema of the message is shown; click the Generate Sample button to generate a sample XML data and can edit the data in the Text section.



    Figure 8: select type of new message

    Icon

    If the Set Application Context option is enabled, the Application Context gets generated here if it is set for the event process; if an Application Context is not set, a pop-up appears saying that there is no schema associated with the port.

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:

  1. 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
     
  2. 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.

Icon

Click the Save button after adding the attachment to save the changes.


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

Icon

When removing a breakpoint an input dialog box comes up asking whether to send the messages or discard the messages. The user can choose the appropriate option.

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 AllDiscard 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

 

Adaptavist ThemeBuilder EngineAtlassian Confluence