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 same or different machines across the network.

Icon

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

Adding Breakpoint

A breakpoint can be added from the context menu present on the route or from the Fiorano Debugger view.

In the sections below, the 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 the context menu

When the breakpoint is added, the route color changes to Red.


Figure 2: Color of the route changing to red after setting the breakpoint

Debugger View

To add a breakpoint to a route, perform the steps below:

  1. Go to the 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 the debugger view
     
  2. Select the route on which the breakpoint is to be added and click OK to add the breakpoint.


    Figure 4: Select route to add the 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, its properties are shown in the Properties view. The Application context is shown in the Application Context tab.

Managing Breakpoint

Viewing Messages

After running the event process, all the messages sent to a route with a breakpoint set on it are visible in the breakpoint view upon clicking the route. When 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 the 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).


Figure 6: Edit message in the Fiorano debugger

Inserting Messages

New messages can be inserted into the breakpoint at debug time without the message being sent by the source component. To insert messages into breakpoint, perform the steps below:

  1. Click the Create button in the Messages pane.


    Figure 7: Create message in the 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 sample XML data which can be edited in the Text section.



    Figure 8: select the Message Type

    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 dialog box gets displayed indicating the absence of schemas 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 steps below:

  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 the Fiorano debugger
     
  2. All messages on Breakpoint can be released once by clicking the Send All button.

    Icon

    Alternatively, all messages can be sent together from the route context menu by right-clicking on the route and selecting the Send All option.



    Figure 10: Send all messages in Fiorano debugger

Discard Messages

To discard messages from the breakpoint, perform the steps below:

  • Select the message to be discarded and click the Discard button. The discarded message will be removed from Breakpoint.


    Figure 11: Discard message in the Fiorano debugger
     
  • All messages on Breakpoint can be discarded once by clicking on the Discard All button.

    Icon

    Alternatively, all messages can be discarded once from the route context menu by right-clicking on the route and by selecting the Discard All option



    Figure 12: Discard All messages in Fiorano debugger

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 text boxes. 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 in the 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 attachment to be added. To remove a particular attachment, select the file to be removed from the Attachments tab, and click the Remove  button.

Icon

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


Figure 14: Add/Remove/Save Attachments button in the Attachments tab in the Fiorano Debugger

Removing Breakpoint

To remove the breakpoint set on a route, select the route on which the breakpoint is to be removed and click the Remove Breakpoint button; the breakpoint will be removed on that route.


Figure 15: Remove Breakpoint in the Fiorano debugger

Icon

When removing a breakpoint, an input dialog box is displayed with the option to send/discard the messages.

Breakpoints on all the routes can be removed by clicking on the Remove All Breakpoints button.


Figure 16: Remove All BreakPoints in the Fiorano debugger

All messages can be sent/discarded once from the route context menu by right-clicking on the route and selecting the Send AllDiscard All option. To remove a breakpoint, select the 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