Exception handler scripts are basically Java code, that is invoked if an exception or error occurred during the execution of a process flow. There are three types of Exception handler scripts:

• Service exception
• Process Flow exception
• Invalid data exception

These scripts can be created at the global level (for all the activities in the process flow) or at the activity level (for a specific activity). If an exception or error occurred during the execution of a process flow, the activity level exception handler script is invoked first. If an activity level exception handler script is not created for that activity, then only global level exception handler script is invoked.

These exception handlers scripts are invoked at different stages of the process flow that are defined below.

You can create the exception handler script either using the Script or Custom APIs. If you are creating the exception handler using a script then you need to define the Java code. If you are creating the exception handler using custom APIs then first you need to create a class with method(s) and put them in the .../<AdeptiaInstallFolder>/ServerKernel/customClasses/<ClassPackage> folder where <ClassPackage> is the package where you have defined the Java class. For example, if you have defined the Java class in the org.custom package then first create the org/custom folder in the .../<AdeptiaInstallFolder>/ServerKernel/customClasses folder and put the class in the custom folder. Ensure that:

• • The class must implement PluginExecutor interface.

    Code Block
    public class <class_name> implements PluginExecutor

    
    

  • The method should accept only one parameter and that must have an object of ExecutionEvent.

    Code Block
    public boolean <method_name>(ExecutionEvent event) throws Exception

    
    

  • The method must be public.

Anchor
Creating Global Exception Handler Creating Global Exception Handler

Creating Global Exception Handler Script

Follow the steps to create a global exception handler script:

1. In Web Process Designer, click View Process Flow Properties icon and select EXCEPTION SCRIPTS tab.
   
    
   
   

2. Select the required exception handler option, for example, Service.

3. Select the interpreter type.

    

   Interpreter Type	Description
   Script	In this option, you need to define the Java code for the execution of the process flow. Using this option will decrease the execution performance of the process flow.
   Custom API	It is recommended to use this option. Using this option will increase the execution performance of the process flow. In this option, you need to select the class and its method for the execution of the process flow. The process flow will be executed on the basis of the code implemented in the selected method.

   
   

4. Click Done.

Anchor
Creating Activity Exception Handler Creating Activity Exception Handler

Creating Activity Exception Handler Script

Follow the steps to create an Activity Exception Handler Script:

1. In Graph Canvas area, select the activity and click Options from Context pad.

2. Select Service Exception option form the list to open Service Exception Script window.
   
   
   
   

3. On the Service Exception Script window, select the interpreter type.
   
   

   Interpreter Type	Description
   Script	In this option, you need to define the Java code for the execution of the process flow. Using this option will decrease the execution performance of the process flow.
   Custom API	It is recommended to use this option. Using this option will increase the execution performance of the process flow. In this option, you need to select the class and its method for the execution of the process flow. The process flow will be executed on the basis of the code implemented in the selected method.

   
   

   Info
   You can use <CTRL>+<Space Bar> to view pre-defined template of Java Code that can be used while creating Java Condition. You can select any of them and edit it according to your requirement.

   
   

4. Click Done.

Anchor
Handling Invalid Data Exception Handling Invalid Data Exception

Handling Invalid Data Exception 

Invalid data exception handler script is invoked when an error related to the processing of data occurs, for example, incorrect record format. Connect displays the exception handler on the Option menu of context pad at the activity level.

1. Select Invalid Data Exception option form the list to open Invalid Data Exception Script window.

2. On the Invalid Data Exception Script window, select the interpreter type.

   Interpreter Type	Description
   Script	In this option, you need to define the Java code for the execution of the process flow. Using this option will decrease the execution performance of the process flow.
   Custom API	It is recommended to use this option. Using this option will increase the execution performance of the process flow. In this option, you need to select the class and its method for the execution of the process flow. The process flow will be executed on the basis of the code implemented in the selected method.

   
   

3. Click Done.