Abstract:
A method for debugging a process in a workflow engine, wherein the process includes a plurality of activity points, includes steps of: attaching to a running business process being controlled by the workflow engine; initiating a debugging session; receiving a set of breakpoints to be inserted into designated points in the process; stopping the running of the process at one or more of the breakpoints; and presenting a user with information relating to where the process has stopped and the status of the process flow.

Description:
CROSS-REFERENCE TO RELATED APPLICATIONS  
       [0001]     This application is a continuation of U.S. application Ser. No. 10/740,931, filed Aug. 11, 2005; said application incorporated by reference in its entirety as if fully set forth herein. 
     
    
     STATEMENT REGARDING FEDERALLY SPONSORED-RESEARCH OR DEVELOPMENT  
       [0002]     None.  
       INCORPORATION BY REFERENCE OF MATERIAL SUBMITTED ON A COMPACT DISC  
       [0003]     Not Applicable.  
       FIELD OF THE INVENTION  
       [0004]     The invention disclosed broadly relates to the field of information technologies and more particularly relates to the field of debugging workflow programs.  
       BACKGROUND OF THE INVENTION  
       [0005]     Workflow engines perform an automatic routing of documents to the users responsible for working on them. The documents may be physically moved over the network or maintained in a single database with the appropriate users given access to the data at the required times.  
         [0006]     A typical workflow engine has two components, design and runtime. The design component typically is a GUI (graphical user interface) tool. It allows user to define a business work flow process in a diagram using UI elements such as action nodes, decision nodes and sub-diagrams. The action node could define the execution logic, decision node can be used to implement routing decisions based on some criterial data and a sub-diagram to incorporate other business process modules.  
         [0007]     The runtime component of workflow engine is responsible for processing business data according to one or many workflow processes predefined by end user using above design components. When business data is processed, the runtime component needs to take the data through the flow path designed and defined in the business flow process. In order to do this, any workflow engine needs to track, monitor and/or persist the state change of the data. The definition of state change here is that, when data enters a new node, leaves the node and moves to next node, the state of data changes.  
         [0008]     A traditional way to debug a workflow process running in a workflow engine is to use an IDE (integrated development environment), such as MS Visual C++(for C++), Eclipse (for Java), etc. A user has to run the engine within an IDE in a special debugging mode. To debug, user needs to set one or many a breakpoints in the line of source code. When the running application reaches the breakpoint(s), it pauses for user instruction to continue.  
         [0009]     There are numerous drawbacks of this traditional debugging mechanism to debug a workflow. One drawback is that debugging is at the source code level, not at a business process level. A user has to debug a workflow process at source code level. A workflow process source code is typically mixed with the underlying workflow engine source code. While the user defines a workflow in a process designing tool, the user may only understand the GUI representation of the flow, but not the underlining source code. Debugging in source code is a big challenge to the user.  
         [0010]     Another drawback is that the production application is down while debugging. The runtime component, typically the workflow engine, needs to be started in a special debugging mode and this means the component will not be running in a production mode. This could mean loss of productivity.  
         [0011]     Yet another drawback is that an IDE tool is required to debug the process flow. Therefore, there is a need for a debugger that overcomes the aforesaid drawbacks.  
       SUMMARY OF THE INVENTION  
       [0012]     According to the invention we implement a mechanism in a workflow engine that allows an event to be debugged in the engine at a process level, while the engine is functioning normally. The workflow engine implements this functionality by exposing a set of debugging APIs. 
     
    
     BRIEF DESCRIPTION OF THE DRAWINGS  
       [0013]      FIG. 1  is a schematic block diagram of a modular application integration system according to one embodiment of the present invention.  
         [0014]     FIGS.  2 A-C show a activity diagram according to an embodiment of the invention.  
         [0015]      FIG. 3  is a high level block diagram showing communication between the collaboration debugger and the interchange server. 
     
    
     DETAILED DESCRIPTION  
       [0016]     Referring to  FIG. 1 , there is shown a block diagram of a hub and spoke application integration system  100  that includes an interchange server  120  having one or more adapters (also known as connectors)  130 , and one or more application collaboration modules  140 , and a collaboration debugger  160  according to an embodiment of the invention. Coupled to each connector  130  is an application  170 . A system such as the system  100  (without the debugger) is described in U.S. Pat. No. 6,223,585 the specification of which is hereby incorporated by reference.  
         [0017]     The Interchange server  120  is a distributed application server that includes a workflow engine function and that provides an object oriented run-time platform for all components. It also provides mechanisms to manage, configure and control components and provides all of the reliability, availability, and serviceability features (the RAS features) found in a typical server environment. An object component can reside in any interchange server within the same administrative domain. An administrative domain is a suite of interconnected connectors, application collaboration modules and interchange servers. Multiple cooperating interchange servers can run on different platforms. Platform in this case means any base software environment, including operating systems, databases (if necessary), and/or middleware.  
         [0018]     Connectors  130 - 132  enable applications to communicate with interchange server  120 . Connectors  130  handle all the details of interfacing with applications  170 - 172 , and provide an object oriented interface to represent the application in the interchange server&#39;s object and data model. Connectors  130  communicate with applications  170 - 172  and provide a schema for interacting with other applications in the interchange server&#39;s object-oriented model. Connectors can be thought of as having two ends. An “interchange-end” is an object-oriented proxy schema for the application&#39;s data and methods. An “application-end” is a driver for the application&#39;s APIs. In other words, the connector&#39;s interchange-end presents a “virtual” object interface to the interchange server for the data and methods (behavior) that reside in the application. To allow application collaboration modules to be re-used across connectors, the virtual object interface presented by the interchange-end of the connector is similar for connectors having the same application class but which are produced by different vendors. The application-end of a connector is concerned with transferring information from application to the virtual objects and with propagating changes (requests for change) made to the virtual objects back to application. The application-end of connector  130  also contains vendor specific logic required to manipulate the vendors APIs. Connectors are application and vendor-specific.  
         [0019]     Application collaboration modules  140 - 141  provide the specific integration business logic and process flows required to integrate two or more applications  170 - 172 . Application collaboration modules  140  contain the re-usable part of the integration business logic. An application collaboration module requires an interchange server  120  and an appropriate connector for each application  170 - 172  participating in a collaboration. Application collaboration modules  140 - 142  are specialized objects that coordinate communication and process flows between connector objects. Any application collaboration module executing in the interchange server  120  will see only the interchange-end of any connector. Application collaboration objects implement the business interactions in terms of message exchanges between the interchange server&#39;s services (which are objects), the participating application&#39;s connector objects and other application collaboration objects. A collaboration debugger  160  is coupled to the interchange server  120  for debugging the collaborations  140 - 142 .  
         [0020]     The collaboration in the interchange server  120  is a set of software modules that describe business processes (Collaboration Template) and can be run within the interchange server  120  (Collaboration Object). An interchange server user can create a new or modify an existing business process in the interchange server  120  and bind and run the business process to external system through the adapters  130 - 132 .  
         [0021]     To help a user debug the business process created in interchange server  120 , a collaboration debugger  160  is introduced. The collaboration debugger  160  allows a user to run the business process in debug mode. To debug the collaboration the user sets breakpoints in the business process. When the process of incoming events reaches a breakpoint, the debugger shows the user where the process stops, what is the status of the flow, and let user to choose how to continue the process.  
         [0022]     The workflow engine exposes the following set of APIs that a remote client can use to debug a process flow executing in the workflow engine.  
         [0023]     1) Debug session management APIs. End user can use them to start, stop a debug session, or to query whether a collaboration is in a debugging session.  
         [0024]     2) Breakpoint management APIs. A debugger can use these APIs to set or unset breakpoint(s). A break point can be added when an event changes state—from one process node to another node.  
         [0025]     3) Process management APIs. When an instance of a running business process is paused at a breakpoint, a debugger can use these APIs to resume the paused process and instruct it to how to proceed. For example, a debugger can instruct a paused process to step over the current node and pause at the next activity node.  
         [0026]     4) Variable inspection APIs. When an instance process pauses at a breakpoint, a debugger can use these APIs to get values of some of collaboration variables to display to customer.  
         [0027]     5) Callback APIs. This kind of API is the running workflow engine to notify a debugger what is happening for a debugged flow.  
         [0028]     The main objective of the Collaboration Debugger  160  is to help the user to debug the business process logic designed in interchange server collaboration. The user can use collaboration debugger  160  to attach to a running collaboration, set/unset breakpoints in a business process, send a triggering event to interchange server, and watch how the running collaboration processes the flow.  
         [0029]     When an instance of running collaboration processes a flow of activities, it will pause at the breakpoints set up by attached collaboration debugger. When this happens, the user can query the value of some variables of the instance of the running collaboration, and/or instruct the business process of how to proceed.  
         [0030]     An activity diagram in the interchange server  120  comprises one or more action nodes, a decision node, an iterator node, and a sub-diagram. An action node can be a manipulation of some Business Objects (BOs), or an interaction with external system through service call. A decision node is a node that a choice will be made based on some data criteria, or exception handling. A Sub-diagram is a node used to represent another activity diagram. An iterator node is a special sub-diagram that the business process will iterate underlying sub-diagram based on a user-designed setup.  
         [0031]     Referring to  FIGS. 2A and 2B , there is shown an activity diagram  200  of the collaboration logic according to an embodiment of the invention. The activity diagram&#39;s representation and execution are done through a two-part entity, which comprises a repository definition and a runtime object. The activity diagram  200  comprises a plurality of blocks (e.g., blocks  202  and  204 ) representing an activity in the business process of the collaboration. Decision diamond  206  represents a decision in the business flow, such as approval of a contract wherein the process diverges to different levels of management depending on the monetary amount of the contract. In the example shown, the process either ends or else it proceeds to a sub-diagram  208  representing an activity flow, the completion of which ends the process. The activity nodes  402  and  404  comprised by the sub-diagram  208  are shown in  FIG. 2B .  
         [0032]     According to an embodiment of the invention, the process represented by the activity diagram  200  is presented or displayed to the user by a graphical user interface (GUI). A collaboration template is the repository definition part. It contains all of the collaboration&#39;s execution logic, but is not executable. The port(s) the execution logic uses to communicate with outside world is (are) a virtual port(s), which is not attached to any physical adapters and therefore cannot be executed at runtime.  
         [0033]     To execute the business logic of a template, the user has to first create a collaboration object from the template, then configure the collaboration object by binding it to connectors or other collaboration objects. A configured collaboration object becomes a runnable object and can be executed to process triggering events based on the business logic.  
         [0034]     Although a business process is defined in a template, in order to debug it, a user has to create, configure and deploy a collaboration object.  
         [0035]     Communication Protocol.  
         [0036]     Referring now to  FIG. 3 , there is shown a simplified block diagram illustrating the communication between the interchange server  120  and the collaboration debugger  160 . In the preferred embodiment, the communication between these entities is accomplished through CORBA (common object request broker architecture) and over IIOP (internet inter-ORB protocol). The communication is two-way, as depicted in  FIG. 3 . The collaboration debugger  160  uses an IIOP call to control the collaboration  140  being debugged. The collaboration  140  uses an IIOP callback to notify the collaboration debugger  160  of the status of a flow—such as whether a breakpoint is reached, or which action node it is currently running.  
         [0037]     A Debugging Session.  
         [0038]     Before a user can start debugging a collaboration  140 , s/he needs to login to the server  120  on which the collaboration  140  is running. A debugging session is a period of time that a running collaboration is in a debugging mode. A debugging session will start after a running collaboration is attached by the collaboration debugger  160 . Only after a debugging session starts, the user can set breakpoint in the collaboration, and the collaboration flow can stop at the breakpoint. Referring again to  FIG. 2 , the user-set breakpoints are indicated by a star. A collaboration debugger can attach to multiple collaborations. However, no more than one debugger can attach to the same collaboration.  
         [0039]     A debugging session ends when the attached collaboration debugger detaches from it. When it ends, all the breakpoints set during the debugging session will be removed; if a flow stops in a breakpoint when the session ends, the flow will be resumed and continue toward to the end.  
         [0040]     A break point is a node in an activity diagram that when reached by a running business process, the process will pause if it is in a debugging mode. A collaboration debugger user can set any number of breakpoint in a business process, this is similar as a programmer can set multiple breakpoints in a program.  
         [0041]     When an instance of a business process pauses at a break point, the user can retrieve data from the process to inspect what is happening, and issue a command to instruct the flow how to proceed.  
         [0042]     What to Display at a Breakpoint.  
         [0043]     At any breakpoint, the user can inspect a triggering event or events and all global variables defined in the collaboration template of which the data type are either Business Object (BO) or Java primitive type. Other implementations of the invention could allow more variables to be displayed.  
         [0044]     The Step-Over, Step-Into, Step-Out, Run-to, and Continue Commands.  
         [0045]     The user can issue any of the following commands to a paused business process: step-over, step-into, step-out, run-to, and continue.  
         [0046]     The Step-Over Command.  
         [0047]     After the interchange server  120  receives a “step-over” command, it will resume the paused business process, continue to the next activity node and pause. In the example template of  FIG. 2A , a “step-over” from breakpoint  1  (activity node  202 ) will make the flow run and pause at activity node  204 . A “step over” from breakpoint  2  (beginning of a sub-diagram  206 ) will end with the end node (step over the sub-sub diagram  208 ).  
         [0048]     The Step-Into Command.  
         [0049]     “Step-into” only applies to a sub-diagram or iterator node. After the interchange server  120  receives a “step-into” command, it will resume the paused business process, continue to the first node (begin node) in the sub-diagram  208  (or iterator sub-diagram) and pause. In the example template, the “step-into” from breakpoint  2  (a sub-diagram node) will end with the begin node in the sub-diagram  208 .  
         [0050]     The Step-Out Command.  
         [0051]     The “Step out” command only applies to the nodes inside a sub-diagram or iterator sub-diagram. After the interchange server  120  receives a “step-out” command, it will resume the paused business process, continue to either when it finishes executing all the node within the current sub-diagram, or to the next breakpoint, whichever it reaches first, and pause. In the example template, the “step-out” from activity node  402  will end with pausing at end node (step-out the sub-sub diagram).  
         [0052]     The Run-to Command.  
         [0053]     The “run-to” command includes a parameter to indicate the activity node to which the process wants to run. After the interchange server  120  receives the “run-to” command, it resumes the paused process, and continues to either the “run-to” node or a breakpoint, whichever it reaches first, and pause.  
         [0054]     The Continue Command.  
         [0055]     After the interchange server  120  receives the “continue” command it resumes the business process, continues until it either reaches another breakpoint or the flow finishes, and then stops.  
         [0056]     More Detail on the Communication.  
         [0057]     One direction of communication is initiated from the debugger  160  to interchange server  120 . Before the collaboration debugger  160  can start debugging a running collaboration  120 , the debugger  160  needs to get an IDL (interface definition language) interface ICollaboration. Through this interface, the debugger  160  can issue various commands such as beginning/ending a debug session, setting/unsetting breakpoints, fetching variables, etc.  
         [0058]     The other direction of communication is initiated from interchange server  120  to the debugger  160 . While a running collaboration  140  is in a debugging mode, it needs to notify various status—such as where it is executing in the activity diagram, whether a breakpoint is reached, back to the collaboration debugger  160  attached to it. The callback interface that will be used is IRteDebuggerCallback.  
         [0059]     Before the collaboration debugger  160  attaches to a running collaboration  140 , the debugger  160  needs to create an instance of a implementation of IRteDebuggerCallbackPOA. When it attaches to the running collaboration, the debugger needs to pass the above implementation to the collaboration and from then on, the collaboration  120  can send notification information back to the debugger  160  through the IRteDebuggerCallbackPOA implementation.  
         [0060]     Collaboration Activity Diagram and Where to Stop the Process.  
         [0061]     As briefly discussed above, the collaboration in interchange server  120  is a software module that represents a business process. A business process can be depicted as an activity diagram in a UML (unified modeling language) module. A feature of interchange server  120  is performed at design time when a user compiles an activity diagram. The interchange server  120  transfers the diagram into a Java class and at runtime, the interchange server  120  executes the business process by executing an instance of the Java class to process a triggering event.  
         [0062]     In the example discussed herein (see  FIGS. 2A, 2B , and  2 C), each activity node is transferred to a Java “switch case” section. Before an instance of Java class executes each “switch case” section, it dequeues a continuation context. A continuation context has information of which activity node to execute.  
         [0063]     The server side support of the collaboration debugger  160  is at each_dequeueCC( )—the point when the engine fetches the continuation context and decides what to do next for a particular event, it will check if the current collaboration manager is in debugging mode. If it is, check if the current step is a breakpoint. If it is, notify the Collaboration Debugger client and wait for further instructions.  
         [0064]     IDL Changes  
         [0065]     The communication between the collaboration debugger  160  and interchange server  120  are two-way. There is one IDL interface to define all APIs for each way. These two IDL interfaces are the ICollaboration and the IDeuggerCallback.  
         [0066]     The ICollaboration is an IDL interface to define all collaboration related APIs such as start/stop/pause a collaboration, get collaboration name, etc. It also defines all debugging-related APIs that initiate from the collaboration debugger  160  (client) to a running collaboration  120  (server). The debugging-related APIs in ICollaboration has four kinds of APIs: Debug session management APIs; Breakpoint management APIs; Breakpoint management APIs; and Process management APIs.  
         [0067]     Debug session management APIs. The Collaboration Debugger can use them to start, stop a debug session, or to query whether a collaboration is in a debugging session.  
         [0068]     Breakpoint management APIs. A debugger can use these APIs to set or unset breakpoint(s).  
         [0069]     Process management APIs. When an instance of business process of a running collaboration pauses at a breakpoint, a debugger can use these APIs to resume the paused process and instruct it to how to proceed. For example, a debugger can instruct a paused process to step-over the current node and pause at the next activity node.  
         [0070]     Variable inspection APIs. When an instance process pauses at a breakpoint, a debugger can use these APIs to get values of some of collaboration variables to display to customer.  
         [0071]     The IDebuggerCallback IDL interface defines debugging APIs that are used by running collaboration to notify an attached debugger for various status, such as a breakpoint and/or an activity node is reached, an unhandled exception is happening, or the being debugged business process has finished.  
         [0072]     Sequence Diagram  
         [0073]     In the sequence diagram set forth in  FIG. 2 , there is shown how a collaboration debugger  160  interacts with an interchange server&#39;s  120  collaboration manager, and how the collaboration manager interacts with the running instance of collaboration object and one or more incoming events. Because the relationship of collaboration manager and collaboration object is one-to-one in an interchange server, we can think at runtime, of a collaboration manager as a collaboration object.  
         [0074]     From the sequence diagram  200 , a debugging session starts when the collaboration debugger  160  attaches to a collaboration manager. At that moment, the collaboration manager will be in a special mode called the debugging mode.  
         [0075]     After the collaboration debugger  160  attaches to a collaboration manager, it can set and/or unset various breakpoints in the business process contained in the collaboration.  
         [0076]     When a new triggering event arrives, the new event will be put into the collaboration manager&#39;s queue. The manager will grab a running instance of collaboration object to process the event.  
         [0077]     When the running collaboration object executes each of the steps in the defined business process, it will check through its manager to determine whether it is in a debugging session and, if it is, whether a breakpoint is reached. If a breakpoint is reached, it will notify the debugger  160  and wait for instructions what to do next.  
         [0078]     After the debugger  160  receives a notification that a breakpoint is reached, it could fetch variables from running collaboration to view the process status; it could instruct the running collaboration to continue to either to the next breakpoint (go), or to execute just one more step (step-over).  
         [0079]     The user can stop a debugging session by detaching the debugger  160  from the attached running collaboration  140 . Upon detaching, the attached collaboration manager should cleanup all the breakpoints and resume any paused running instance.  
         [0080]     Two IDL structures are introduced to represent breakpoint, and variable information. They are: 
    1 struct IBreakPoint {string scenario; //the scenario name of a collaboration that breakpoint is set long graphicId; //the unique node id of a node in a collaboration diagram}; struct IVariable {string name; //variable name string type; //variable data type. Such as int, string, BusObj string subType; //variable subtype. For example, a BusObj&#39;s subtype maybe Employee};    
 
         [0082]     ICollaboration: this IDL interface defines all APIs initiated from Collaboration Debugger (client) to running collaboration (server).  
         [0083]     Debug Session Management APIs:  
         [0084]     1. void IdebugAttach (in string clientCallbackId, in IDebuggerCallback cb)  
         [0085]     Description: to start a debugging session, a Collaboration Debugger needs to attach to a running collaboration through this IDL call.  
         [0086]     Parameters: clientCallbackId, a unique id to identify the Collaboration Debugger to be attached to the running collaboration.  
         [0087]     Cb: a client (collaboration debugger) side implementation of IRteDebuggerCallback to handle server notification of various status change.  
         [0088]     Return value: none.  
         [0089]     Exception: ICxServerError.  
         [0090]     2. void IdebugDetach( )  
         [0091]     Description: By calling IdebugDetach( ), the attached Collaboration Debugger ends a running collaboration&#39;s debugging session. Upon ending a debugging session, the running collaboration will remove all the debugging settings, such as breakpoint, and resume any business processes that have paused at breakpoints.  
         [0092]     Parameters: none  
         [0093]     Return value: none.  
         [0094]     Exception: none.  
         [0095]     3. boolean IdebugIsAttached( )  
         [0096]     Description: to check if a running collaboration has a Collaboration Debugger attached to it. If it is, the running collaboration is in debugging mode and no more other Collaboration Debugger can attach to it.  
         [0097]     Parameters: none.  
         [0098]     Return value: boolean, true if the running collaboration is already in a debugging mode, false otherwise.  
         [0099]     Exception: none.  
         [0100]     Breakpoint Management APIs:  
         [0101]     1. boolean IdebugSetBreakpoint(in IBreakPoint aBreakPoint);  
         [0102]     Description: set a breakpoint in an activity diagram of a collaboration.  
         [0103]     Parameters: aBrealPoint an IDL breakpoint struct that has the scenario name and unique node id to uniquely represent a node in a collaboration diagram that a breakpoint will be set  
         [0104]     Return value: boolean, true if setting successes, false otherwise.  
         [0105]     Exception: none.  
         [0106]     2. boolean IdebugClearBreakpoint(in IBreakPoint aBreakPoint);  
         [0107]     Description: to unset a breakpoint in an activity diagram of a collaboration.  
         [0108]     Parameters: aBrealPoint an IDL breakpoint struct that represent a breakpoint set in a collaboration diagram.  
         [0109]     Return value: boolean, true if unsetting successes, false otherwise  
         [0110]     Exception: none.  
         [0111]     3. boolean IdebugSetBreakpoints(in Ibreakpoint[ ] breakpoints);  
         [0112]     Description: set an array of breakpoints in an activity diagram of a collaboration.  
         [0113]     Parameters: breakPoints an array of breakpoints to be set  
         [0114]     Return value: boolean, true if setting successes, false otherwise.  
         [0115]     Exception: none.  
         [0116]     4. boolean IdebugClearBreakpoints (in IbreakPoint[ ] breakpoints);  
         [0117]     Description: to clear an array of breakpoints in an activity diagram of a collaboration.  
         [0118]     Parameters: breakpoints, an array of breakpoints to be cleared  
         [0119]     Return value: boolean, true if clearing successes, false otherwise.  
         [0120]     Exception: none.  
         [0121]     5. *boolean IdebugClearAllBreakpoints( ):  
         [0122]     Description: to clear all the breakpoints set for a running collaboration debugging session  
         [0123]     Parameters: none.  
         [0124]     Return value: boolean, true if unsetting successes, false otherwise. If false, client is responsible to check remaining breakpoints and process accordingly.  
         [0125]     Exception: none.  
         [0126]     6. IBreakPointEnumeration IdebugGetAllBreakpoints( );  
         [0127]     Description: to get all the breakpoints set for a running collaboration&#39;s debugging session  
         [0128]     Parameters: none.  
         [0129]     Return value: IBreakPointEnumeration, an enumeration of all the breakpoints set for a collaboration&#39;s debugging session.  
         [0130]     Exception: none.  
         [0131]     Process Control:  
         [0132]     1. void IdebugGo(in string stopPointHandle)  
         [0133]     raises (ICxServerError);  
         [0134]     Description: when an instance of process pauses at a breakpoint, the attached debugger can use this API to resume the instance to continue till it reaches either another breakpoint or the end of the business flow.  
         [0135]     Parameters: stopPointHandler, an identifier of which business process instance pauses in server at a breakpoint  
         [0136]     Return value: void  
         [0137]     Exception: IcxServerError if server can not execute this command.  
         [0138]     2. void IdebugStepOver(in string stopPointHandle)  
         [0139]     raises (ICxServerError);  
         [0140]     Description: when an instance of process pauses at a breakpoint, the attached debugger can use this API to resume the instance to continue one step over the current activity node. The process will pause at the next activity node in the current activity diagram.  
         [0141]     Parameters: stopPointHandler, an identifier of which business process instance pauses in server at a breakpoint  
         [0142]     Return value: none.  
         [0143]     Exception: IcxServerError if server can not execute this command.  
         [0144]     3. void IdebugStepInto(in string stopPointHandle)  
         [0145]     raises (ICxServerError);  
         [0146]     Description: when an instance of process pauses at a sub-diagram (or iterator) node, the attached debugger can use this API to resume the instance to continue one step into the sub-diagram (or iterator sub-diagram). The process will pause at the beginning node in the sub-diagram.  
         [0147]     Parameters: stopPointHandler, an identifier of which business process instance pauses in server at a breakpoint  
         [0148]     Return value: none.  
         [0149]     Exception: IcxServerError if server can not execute this command.  
         [0150]     4. void IdebugStepOut(in string stopPointHandle)  
         [0151]     raises (ICxServerError);  
         [0152]     Description: when an instance of process pauses at a breakpoint within a sub-diagram (or iterator sub-diagram), the attached debugger can use this API to resume the instance to continue executing all the activity nodes within this sub-diagram, or to the first breakpoint it reaches within the sub-diagram; the process will pause and wait for further instruction from the debugger.  
         [0153]     Parameters: stopPointHandler, an identifier of which business process instance pauses in server at a breakpoint  
         [0154]     Return value: none.  
         [0155]     Exception: IcxServerError if server can not execute this command.  
         [0156]     5. void IdebugRunTo(in string stopPointHandle, in IBreakPoint aBreakPoint)  
         [0157]     raises (ICxServerError);  
         [0158]     Description: when an instance of process pauses at a breakpoint, the attached debugger can use this API to resume the instance to continue to run, until it reaches either an activity node specified in this API, or a breakpoint, whichever it reaches first.  
         [0159]     Parameters: stopPointHandler, an identifier of a business process instance that is pausing at a breakpoint  
         [0160]     aBreakPoint, a activity node info. (represented as a breakpoint) that the being resumed business process expected to run to. Upon reaching this node, the process will pause as it reaches a breakpoint.  
         [0161]     Return value: none.  
         [0162]     Exception: IcxServerError if server can not execute this command.  
         [0163]     Variable Inspection  
         [0164]     1. Ivariable[ ] IdebugGetAllVariables(in string stopPointHandle);  
         [0165]     Description: an attached collaboration debugger can use this API to get all the names of variables defined in a running collaboration that can be viewed.  
         [0166]     Parameters: stopPointHandle, an identifier of a business process instance that is pausing at a breakpoint.  
         [0167]     Return value: an array that holds all the visible variables from a debugging session.  
         [0168]     Exception: none.  
         [0169]     2. wstring IdebugGetVariable(in string stopPointHandle, in string varName) raises (ICxServerError);  
         [0170]     Description: to get the current value of a particular variable in a running collaboration instance.  
         [0171]     Parameters: stopPointHandle, an identifier of a business process instance that is pausing at a breakpoint.  
         [0172]     VarName, the name of a variable to be displayed at a collaboration debugger.  
         [0173]     Return value: wstring, a string value of the variable. If the variable is a business object, the value is serialized string value. If it is a primitive type, the value is in string format.  
         [0174]     Exception: none.  
         [0175]     IDebuggerCallback (APIs Used by a Running Collaboration to Notify Attached Debugger Numerous Status Change)  
         [0176]     1. void IexceptionEvent(in string stopPointHandle,  
         [0177]     in string clientCallbackId,  
         [0178]     in string rteObjTempName,  
         [0179]     in string rteObjName,  
         [0180]     in string rteObjInstanceId,  
         [0181]     in string rteMethodName,  
         [0182]     in string diagramPath,  
         [0183]     in long stepGraphicId,  
         [0184]     in string encodedFormat,  
         [0185]     in wstring errorText);  
         [0186]     Description: to notify the debugger that there is an unhandled exception occurs in a business process. Please refer to “collaboration developer guide” for the concept of handled exception.  
         [0187]     Parameters: clientCallbackId, an identifier of a collaboration debugger  
         [0188]     rteObjTempName, the collaboration object&#39;s template name  
         [0189]     rteObjName, the collaboration object name  
         [0190]     rteObjInstanceId, an instance id of the running collaboration object (business process)  
         [0191]     rteMethodName, the scenario name  
         [0192]     diagramPath, the diagram path of the end node  
         [0193]     stepGraphicId: the id of the end node  
         [0194]     encodedFormat: the character encoding format  
         [0195]     errorText: the error message  
         [0196]     Return value: none.  
         [0197]     Exception: none.  
         [0198]     2. void IprintToConsole(in string serverName, in string encodedFormat, in string text);  
         [0199]     Description: to check if a running collaboration has a Collaboration Debugger attached to it. If it is, the running collaboration is in debugging mode and no more other Collaboration Debugger can attach to it.  
         [0200]     Parameters: none.  
         [0201]     Return value: boolean, true if the running collaboration is already in a debugging mode, false otherwise.  
         [0202]     Exception: none.  
         [0203]     3. void IbreakpointEvent(in string stopPointHandle,  
         [0204]     in string clientCallbackId,  
         [0205]     in string rteObjTempName,  
         [0206]     in string rteObjName,  
         [0207]     in string rteObjInstanceId,  
         [0208]     in string rteMethodName,  
         [0209]     in string diagramPath,  
         [0210]     in long stepGraphicId);  
         [0211]     Description: to notify the attached debugger that the instance of running business process has reached a breakpoint.  
         [0212]     Parameters: stopPointHandle, an identifier of a business process instance that is paused at a breakpoint.  
         [0213]     clientCallbackId, an identifier of a collaboration debugger  
         [0214]     rteObjTempName, the collaboration object&#39;s template name  
         [0215]     rteObjName, the collaboration object name  
         [0216]     rteObjInstanceId, an instance id of the running collaboration object (business process)  
         [0217]     rteMethodName, the scenario name  
         [0218]     diagramPath, the diagram path of the breakpoint node  
         [0219]     stepGraphicId: the id of the node where a breakpoint is reached  
         [0220]     Return value: void  
         [0221]     Exception: none.  
         [0222]     4. void IexecutingNode(in string stopPointHandle,  
         [0223]     in string clientCallbackId,  
         [0224]     in string rteObjTempName,  
         [0225]     in string rteObjName,  
         [0226]     in string rteObjInstanceId,  
         [0227]     in string rteMethodName,  
         [0228]     in string diagramPath,  
         [0229]     in long stepGraphicId);  
         [0230]     Description: to notify the attached debugger of which activity node the instance of running business process has reached a breakpoint.  
         [0231]     Parameters: stopPointHandle, an identifier of a business process instance that is paused at a breakpoint.  
         [0232]     clientCallbackId, an identifier of a collaboration debugger  
         [0233]     rteObjTempName, the collaboration object&#39;s template name  
         [0234]     rteObjName, the collaboration object name  
         [0235]     rteObjInstanceId, an instance id of the running collaboration object (business process)  
         [0236]     rteMethodName, the scenario name  
         [0237]     diagramPath, the diagram path of the executing node  
         [0238]     stepGraphicId: the id of the executing node  
         [0239]     Return value: void  
         [0240]     Exception: none.  
         [0241]     5. void IendOfFlowEvent(in string stopPointHandle,  
         [0242]     in string clientCallbackId,  
         [0243]     in string rteObjTempName,  
         [0244]     in string rteObjName,  
         [0245]     in string rteObjInstanceId,  
         [0246]     in string rteMethodName,  
         [0247]     in string diagramPath,  
         [0248]     in long stepGraphicId);  
         [0249]     Description: to notify the attached debugger that a flow event is reaching its end node.  
         [0250]     Parameters: stopPointHandle, an identifier of a business process instance that is paused at a breakpoint.  
         [0251]     clientCallbackId, an identifier of a collaboration debugger  
         [0252]     rteObjTempName, the collaboration object&#39;s template name  
         [0253]     rteObjName, the collaboration object name  
         [0254]     rteObjInstanceId, an instance id of the running collaboration object (business process)  
         [0255]     rteMethodName, the scenario name  
         [0256]     diagramPath, the diagram path of the end node  
         [0257]     stepGraphicId: the id of the end node  
         [0258]     Return value: void  
         [0259]     Exception: none.  
         [0260]     6. void InewEvent(in string stopPointHandle,  
         [0261]     in wstring busobj);  
         [0262]     Description: to notify the attached debugger that a new event will start in a debugging session  
         [0263]     Parameters: stopPointHandle, an identifier of a business process instance busobj, a serialized string value of triggering bus obj  
         [0264]     Return value: void  
         [0265]     Exception: none.  
         [0266]     Therefore, while there has been described what is presently considered to be the preferred embodiment, it will understood by those skilled in the art that other modifications can be made within the spirit of the invention.