IBM BPM, V8.0.1, All platforms > Migrating and upgrading your IBM BPM environment > Migrating from other products > Migrating from WebSphere Studio Application Developer Integration Edition > Additional migration information > Create SCA exports to access the migrated service
Migrating the IBM Web Service binding (SOAP/JMS)
The IBM Web Service binding (SOAP/JMS) for a BPEL process or other service type can be migrated to the recommended SCA construct.
In WebSphere Studio Application Developer Integration Edition, this binding type gave clients the ability to communicate with a BPEL process or other service type by invoking an IBM Web Service, where the communication protocol was JMS and the message adhered to the SOAP encoding rules.
The following example shows the conventions used when generating an IBM Web Service (SOAP/JMS) for a 5.1 BPEL service. The JNDI name of the generated IBM Web Service was a combination of the BPEL's name, target namespace, and valid-from timestamp, as well as the name of the interface (WSDL port type that the deployment code was generated for).
For example, these attributes can be found by examining the BPEL process' properties in the BPEL editor on the Description and Server content tabs:
The generated namespace for this example is then com/example/www/process87787141/MyService20030101T020304_ProcessPortTypePT.
Generated namespace Process name MyService Target namespace http://www.example.com/process87787141/ Valid From Jan 01 2003 02:03:04 Interface ProcessPortType In WebSphere Studio Application Developer Integration Edition, when the IBM web service binding (SOAP/JMS) was selected as the deployment type for a BPEL process or other service type, the following options were given:
- For Document Style, the default was DOCUMENT / other option: RPC
- For Document Use, the default was LITERAL / other option: ENCODED
- For JNDI Provider URL, it was either Server supplied or Custom (an address must be entered, the default is iiop://localhost:2809)
- For Destination Style, the default was queue / other option was topic
- For JNDI Connection Factory, the default was jms/qcf (this is the JNDI name of the queue connection factory for the generated MDB queue)
- For JNDI Destination Queue, the default was jms/queue (this is the JNDI name of the generated MDB queue)
- For MDB Listener Port, the default was < Service Project Name>MdbListenerPort
A WSDL file specifying the IBM Web Service SOAP/JMS binding and service is created in the generated EJB project, but not in the service project itself. This means that you must manually locate that file and copy it to your business integration module project if it is important that the IBM web service client code must not change. By default, this WSDL file was created in the EJB project at ejbModule/META-INF/wsdl/< business process name>_ < business process interface port type name>_JMS.wsdl
The WSDL PortType and Messages of the business process interface are actually copied to this WSDL file as well, rather than referencing the existing WSDL PortType and Messages defined in the service project.
If it is important that the IBM web service client code remain unchanged after migration, the information in this file will be needed for the manual migration steps below.
There are two options for migrating the WebSphere Studio Application Developer Integration Edition SOAP/JMS process binding. You can migrate the client to the SCA programming model or leave it as a web services client:
After the manual migration steps have been completed, the client must be migrated to the new programming model as well. See the appropriate topic for the following client types:
Further information for migrating clients Client type For further information see IBM Web service client "Migrating the IBM Web service (SOAP/JMS) client"
- Migration option 1 for the IBM Web Service binding (SOAP/JMS)
The first migration option for the WebSphere Studio Application Developer Integration Edition SOAP/JMS binding is to make the service accessible to a web services client.- Migration option 2 for the IBM Web Service binding (SOAP/JMS)
The second migration option for the WebSphere Studio Application Developer Integration Edition SOAP/JMS process binding is to make business processes accessible to a non-SCA entity (for example, JSP or a Java client).