CloudStreams 10.5 | webMethods CloudStreams | Administering webMethods CloudStreams | Virtual Services | Creating a New Virtual Service (SOAP) | The Out Sequence Step (SOAP) | The Invoke IS Service Step (Outbound, SOAP)
 
The Invoke IS Service Step (Outbound, SOAP)
This optional step invokes a user-defined Integration Server flow service. You can invoke an IS service in the service's Out Sequence step to pre-process the response message from the native service before it is returned to the consuming application. For more information about IS services, see The Invoke IS Service Step (Inbound, SOAP).
*To add the Invoke IS Service step (outbound, SOAP)
1. Open Software AG Designer and display the CloudStreams Development perspective by clicking Window > Open Perspective > Other > CloudStreams Development.
2. In the CloudStreams Governance view, expand your CloudStreams Governance project and double-click the virtual service name.
3. Right-click Out Sequence and click Invoke IS Service.
The Invoke IS Service step is added to the Out Sequence step.
4. Click Invoke IS Service and complete the fields in the General page in the Properties view as follows.
Option
Description
Name
You can optionally change the step name to any other name. There are no naming restrictions.
Type
(Read-only field.) Invoke IS Service.
Service
The IS service to pre-process the response message from the native service before it is returned to the consuming application.
5. When you define the IS service, the Pipeline In section of the flow should have the following input variables:
*proxy.name: This is the name of the virtual service.
*SOAPEnvelope: This is of the Java type org.apache.axiom.soap.SOAPEnvelope.
*MessageContext: CloudStreams will automatically place a MessageContext variable into the pipeline before executing the IS service call. MessageContext is of the Java type org.apache.axis2.context.MessageContext.
Integration Server users can use the Axis2 MessageContext object to manipulate the incoming SOAP request. The Integration Server provides built-in services (the pub.soap.* services) to work with the MessageContext object to get/set/modify the SOAP body, header, properties, etc. Integration Server users should use these services to extract the information they need from the MessageContext to build the necessary business logic. Users do not need to understand Axis2 or Axiom (the xml object model based on StAX) to work with the SOAP request, because if they are familiar with the Integration Server pub.soap.* services, they can accomplish most of the tasks. For more information about these related Integration Server services, see the webMethods Integration Server Built-In Services Reference.
6. To create an additional Invoke IS Service step, right-click In Sequence and click IS Service again.
7. To delete an Invoke IS Service step, right-click Invoke IS Service and click Delete.