What is an Integration Resource?

An Integration Resource is an extension to an XML Resource. See working with XML Resources for more information.

An Integration Resource works in the reverse way to the XML Resource. The Integration Server accepts incoming requests and acts as a Server, whereas the XML Resource acts as a client. The Integration Server request document is the incoming message invoked by an external client and the Integration Server response document is the outgoing message sent back to the external client.

An Integration Resource must have at least one Integration Adapter to qualify as an Integration Resource. An Integration resource also supports other XML adapters (See Integration Adapters section). An Integration Resource configures the Web Service operations published from an Integration Service. An Integration Resource can configure multiple operations (Integration Adapters). Each Operation evaluates to one web service operation. Ebase recommends creating one Integration Resource per operation.

An Integration Resource requires the following components:

− Request Document

− Response Document

− At least one Integration Adapter (this represents a web service operation)

− A Schema representing the Request and Response documents

− A Fault Document (This only supports SOAP 1.1 SOAP Fault)

− An Operation Name (name used to identify operation name for the adapter), this name cannot be empty as it is used as an identifier for the web service operation

If an Integration Resource does not contain an Integration Adapter and is added to an Integration Service Business View, it will not publish the web service.

Creating an Integration Resource

An Integration Resource can be added from the Ebase Designer menu by selecting File -> New -> Integration -> Integration Resource. Integration Resources appear in the Designer tree under Integration -> Integration Resources.

An Integration Resource looks the same as any other XML Resource and allows the user to configure the following:

− Schemas: Schemas are associated to the Documents used within the resource

− Documents: Documents are associated with the Adapter Documents

− Adapters: The default adapter is the Integration Adapter. Other adapters are supported, see Adapters.

− Namespaces: The namespaces associated to the Schema/Documents

− Fields and Table source fields: The source fields used for mapping data into and out of a Integration Resource.

Mappings between Integration Service and Resource

It is not necessary to call the Integration Resource from an Integration Script. The mapped service fields will automatically be updated when an incoming web service operation is invoked. When the Integration Script has finished processing, the response fields will automatically be updated depending on the operation invoked.

Tables backed by the Integration Service must be invoked in the same way as any other Ebase Resource. Use ‘fetchtable’ and ‘updatetable’ to fetch and update table data.

To read MY_REQUEST_TABLE from the Integration Adapter request document:

fetchtable MY_REQUEST_TABLE

To update MY_RESPONSE_TABLE to the Integration Adapter response document:

updatetable MY_RESPONSE_TABLE

Supported Adapters

Integration Adapter

The default Adapter for the Integration Resource is an Integration Adapter. The main panel for the Integration Adapter allows you to configure:

− Operation Name: The operation name used to publish in the Web Service.

− Request Document: The incoming request document from the calling client.

− Response Document: The response document returned back to the client.

− Fault Document: The fault document when an error occurs processing the Integration Service. This should be set to SOAP 1.1 standard SOAPFault. This can be imported through the schemas by right-clicking the schema node and clicking ‘Add built-in schema’. Select the soap11 schema.

Each Integration Adapter represents one Web Service Operation that is published within the WSDL when a Web Service is created for associating Integration Service.

Other Supported Schemas

Integration Resource also supports the following XML adapters, see working with XML Resource for more details:

− File Adapter

− XSL Adapter

− Copy Adapter

− Log Adapter

− Validate Adapter