IBM BPM, V8.0.1, All platforms > Migrating and upgrading your IBM BPM environment > Migrating from other products > Migrating from WebSphere InterChange Server or WebSphere Business Integration Server Express

Support for WebSphere Business Integration data handlers

The data handler support API enables certain data handler methods to be invoked from the AccessEJB, a IBM BPM SCA Java™ component, or IBM BPM bindings.

IBM BPM provides a data handler support Application Programming Interface (API) that enables select WebSphere Business Integration data handler methods to be invoked from the AccessEJB, a IBM BPM SCA Java component, or IBM BPM bindings. Access EJB has been replicated as an EJB that allows JService calls to route the input business object to the appropriate migrated module. The BPEL file in the migrated module will be invoked instead of the original WebSphere InterChange Server or WebSphere Business Integration Server Express target collaboration.

IBM BPM bindings invoke data bindings to perform data transformation.IBM BPM provides several built-in data bindings as well as the capability to provide user-defined data bindings. You can implement a user-defined, or custom data binding to invoke a WebSphere Business Integration data handler.

By providing a custom data binding implementation, it is possible to use WebSphere Business Integration data handlers via the data handler support API. The data handler support API provides wrapper methods around existing WebSphere Business Integration data handler interface methods which perform the conversion between WebSphere Business Integration business objects and SDOs.


Data handler support API

By providing a custom data binding implementation, it is possible to use WebSphere Business Integration data handlers via the data handler support API. This API defines a set of public methods which can be invoked from a custom data binding or a Java component. It provides a way to invoke a text-based WebSphere Business Integration data handler from a process server binding. The following are the API methods:

getSDOFromString(String inputString, String sdoName, String metaObjectName, String mimeType) (Returns dataObject)

getStringFromSDO(DataObject sdo, String metaObjectName, String mimeType) (Returns String)

You can access these methods with the Java class com.ibm.wbi.datahandler.JavaConnectorUtilDH. This is the class that IBM recommends that you use from a data binding or a Java component.

If you have existing code you can use the AppSide_Connector.JavaConnectorUtil class.


Usage

The methods defined in the data handler support API can be invoked from either an IBM BPM binding or a Java component. However, because data is typically transformed in the binding in anIBM BPM environment, IBM strongly recommends that the methods of the data handler support API be invoked from a custom data binding rather than a Java component.


Limitations

The data handler support API has the following limitations:

: Migrating from WebSphere InterChange Server or WebSphere Business Integration Server Express


Related reference:

Supported WebSphere InterChange Server or WebSphere Business Integration Server Express APIs


Related information:

IBM WebSphere Business Integration Adapters/IBM WebSphere InterChange Server Data Handler Guide