Ebase Xi
Integration Server
Integration Server Architecture
Publishing an Integration Service
Getting Started with Integration Server
Error Handling and SOAP Faults
See also: Integration Services, Server Administration Application - Web Services, Publishing REST Web Services
Ebase Xi Integration Server is a module that provides the ability to
publish an Integration Service as a SOAP
Web Service. This allows remote Web Service client applications to execute an
Integration Service via a web service call. The Integration Service provides
the ability to receive data, process an Integration Service and return a
response using SOAP messaging. Both SOAP 1.1 and SOAP 1.2 are supported.
Each Integration Service is published as a Web Service which provides a URL for remote client applications and
also publishes the WSDL for the service.
From a designer’s perspective, an Integration Service is very similar to
a standard Ebase Xi form except that it contains no pages. An Integration
Service supports one main event - an Integration
Event - that is processed immediately when the Service is invoked. An On Error Event can also be configured to
execute when an error occurs. An Integration Service has no user and runs in
the background.
The Integration Server only supports request/response SOAP messaging.
The style of the Web Service definition is document literal.
The Ebase Xi Integration Server operates as a servlet that accepts SOAP
requests via HTTP. The SOAP Body populates the Integration Service fields and
processes the integration event associated with the requested Web Service operation. After the integration event has executed, a
response SOAP message is returned to the calling client based on the response
configured for the operation. Fields, tables and resources can be added to an
Integration Service in the same way as with a form.
Each Integration Service
can be created to publish one or more operations.
An Integration Service is published automatically and no specific action is needed. If required, each published Web Service can be disabled or enabled using the Server Administration Application.
This section gives a brief outline of the steps to create an Ebase
Integration Service. It is recommended to start the process from the
Integration Service and create the Integration Resource from the service as
described here, although this is not essential. (It is also possible to create
an integration resource independently and then import the fields and tables
into an integration service).
SOAP faults are generated automatically by the system when
an Integration Service fails. Either a SOAP 1.1 or SOAP 1.2 fault is generated,
depending on the protocol used by the client.
See Integration Server Error Handling for
additional information regarding Integration Server error handling.