Manually Creating Resources to Work with SOAP Services
This section explains how you can manually create and configure project resources to work with SOAP services.
The section Creating Resources Using the WSDL Import Utility explains how to use the WSDL import feature to create the resources.
- Procedure
-
Configure the HTTP Channel and SOAP Destination
Configure an HTTP channel, an HTTP connection resource for the channel. Connection configuration is the same for SOAP and HTTP channels, except for the serializer. For SOAP destinations, use the following serializer:
com.tibco.cep.driver.http.serializer.SOAPMessageSerializer
After you complete Add a SOAPEvent (and Other Ontology as Needed), set that
SOAPEvent
as the default event for the destination. -
Add a SOAPEvent (and Other Ontology as Needed)
Configure the SOAPEvents that will receive the SOAP requests and send out SOAP responses. Also configure any other ontology as needed. SOAPEvent is an event type provided with TIBCO BusinessEvents. However it is created in a two-step manner:
- Add a simple event in the usual way.
- In the Inherits From field, select SOAPEvent.
- Set the default destination to the destination you created in
Configure the HTTP Channel and SOAP Destination.
The payload of a SOAPEvent is automatically configured with the structure of a SOAP message. It has Header and Body elements, and within the Body element, a Fault element. You can further configure the Header and Body elements using the payload editor.
-
Configure Rules and Rule Functions using SOAP Functions
In general the procedure of serving requests and sending requests to other servers is the same for SOAP services as for other HTTP interactions. One rule function is used as the event preprocessor.
In addition, you must configure rules and rule functions to access information from the SOAP messages in the inbound events, and to populate outbound events with SOAP message details. Set two SOAPevents you configured in Add a SOAPEvent (and Other Ontology as Needed) as input and return arguments of the preprocessor. See Parsing and Building SOAP Messages for details.
- Configure an Event Preprocessor
Open the project CDD for editing, and configure an event preprocessor for the destination you configured in Configure the HTTP Channel and SOAP Destination. Use the rule function you configured in Configure Rules and Rule Functions using SOAP Functions.