Create Server Exception

Follow the below steps to create a new server exception:

1. From the explorer menu, right-click Server Exceptions and select Add.
2. In the properties panel, configure the properties as required and then click save.

Property	Description	Comments
Name*	Provide the name of an exception.	Name must start with a character followed by alphanumeric or ''. No spaces are allowed. Except underscore (), no other special characters are allowed. Name cannot start with a number.
Code*	Status code.	-
Message Template*	Message that corresponds to the exception.	-
Description	Summary of the Exception	-
Is Active	Specify whether the exception is active for accessing. Either Yes or No.	By default, it is set to Yes.

Note: An asterisk (*) denotes that the property is mandatory for creating a server exception.

The "Server Exception added successfully" message displays upon successful creation. Handler folder is created by default within the exception.

Add Exception Handlers

An Exception Handler is a mechanism that allows workflows and server flows to gracefully handle errors that occur during execution. Instead of allowing failures to disrupt the flow, exception handlers capture, process, and respond to errors, ensuring system stability and reliability.

Purpose of Exception Handlers

• Enable Custom Error Handling – Allows defining actions for different error scenarios.
• Enhance User Experience – Provides meaningful error messages instead of system error messages.

Users can add the exception handlers to an exception as applicable. To add, follow the below steps:

1. Right-click Handlers and select Add.
2. In the properties panel, configure the below properties as required and the click Save.

Property	Description	Comments
Name*	Provide the name of the exception.	Name must start with a character followed by alphanumeric or ''. No spaces are allowed. Except underscore (), no other special characters are allowed. Name cannot start with a number.
Description	Provide the summary.	-
Is Active	Specify whether the handler is active for accessing or not. Either Yes or No.	By default, it is set to Yes.

Note: An asterisk (*) denotes that the property is mandatory for adding a handler.

The "Handler added successfully" message displays upon successful creation.

3. The handler designer canvas shows the Start and Stop constructs by default. From the ribbon, add the required constructs and configure them as required inside the flow to create an exception handler.
4. Click save to save a handler.

The "Handler updated successfully" message displays upon successful update.

Structure of a Handler

The created handler contains the following:

• Input Params to add input parameters for the flow
• Output Param
• Variables

Add Input Parameters, Output Parameter and Variables

Users can add the parameters and variables to a handler as applicable. To add, follow the below steps:

1. Right-click the Input Params (or) Output Param (or) Variables and select Add. A pop-up window displays.
2. Configure the below properties as required and the click Save.

Property	Description	Comments
Parameter Name*	Provide the name of a parameter.	Name must start with a character followed by alphanumeric or ''. No spaces are allowed. Except underscore (), no other special characters are allowed. Name cannot start with a number.
Is Array	Specify whether the parameter is an array or not.	By default, it is set to No.
Data Type*	Select the data type of the parameter from the drop-down.	-

Note: An asterisk (*) denotes that the property is mandatory for creating a parameter or variable.

The success message displays upon successfully adding a parameter or variable.

Constructs

The following are the constructs available in an exception handler:

If	Assignment	Foreach	Continue
While	Return	Switch	Call REST API
Run Query	Query Output Mapping	Begin Transaction	Complete Transaction
Raise Event	C# Snippet	Log	Call Workflow
Get Workflow Status	Terminate Workflow	Create Anonymous Object	Json Parse
Json Search	Call Dynamic API	Call Serverflow	Create Object Instance
Throw Exception	Get Workflow Result	Call Aggregate functions