Integration Server Error Handling

Documentation home

 

Ebase Integration Server handles faults in two ways when processing Integration Services:

 

−         SOAP Fault

−         On Error Event

SOAP Fault

 

A SOAP Fault is generated when there is an error processing the Integration Service. The SOAP Fault is a standard SOAP 1.1 SOAP Fault as described in the W3C SOAP Specification. The format of the soap fault is as follows:

 

 

The SOAP Fault contains the elements:

 

−         faultcode – This value will always be soap:Server

−         faultstring – Description of the error causing the error.

 

A SOAP Fault will be returned to the client if:

 

  1. No On Error event is configured on the Integration Service and there is an error during processing
  2. An error occurs processing the Integration Service and again processing the On Error event.
  3. The Web Service is invalid or disabled

On Error Event

 

An on error event executes Ebase scripts when an error occur processing an Integration Service. One or more scripts can be configured to run if an error occurs. This acts as a failover to recover an Integration Service or set response fields when an error occurs.

 

An on error event can be created by selecting File -> New -> Integration -> Integration Script from the file menu. See Working with Integration Scripts for more details.

 

One or more Ebase scripts can be added to an on error event. On error events can be added to the Integration Service through the Integration Service Properties dialog and selecting the Events tab.

 

 

 

If no on error event is configured then a standard SOAP Fault will be returned to the user when an error occurs processing the Integration Service.

 

If an on error event is specified it receives control of processing. The on error event is useful for system recovery to carry out a recovery process within the integration service or could be used to set a value in the response document to say that an error occurred instead of using the standard SOAP Fault as described above.

 

 

An on error event script may be written as:

 

rollback; //rolls back the current transaction and start a new one

set RESPONSE_STATUS = ‘Update of customer ‘ + CUSTOMER_ID + ‘ Unsuccessful’;

set RESPONSE_CODE = ‘101’; //unsuccessful update