Web Services (SOAP) Input and Output Adapter

The Web Services (SOAP) Input and Output adapters are SOAP Web services clients which connect to a Web service to obtain data to feed into Event Stream Processor and deliver output from Event Stream Processor to a Web service.

Both adapters include an adapter configuration file and a mapping file. Use the adapter configuration file to set up the SOAP Input and Output Transporter modules, the ESP Publisher and Subscriber modules, as well as establish a connection to Event Stream Processor. Use the mapping file to map Web service WSDL to ESP columns.

You can either manually create a mapping file or use the schema discovery functionality in ESP Studio to automatically create one. See Discovering Schema and Creating a Mapping File for the Web Services (SOAP) Adapter in the Studio Users Guide for detailed instructions on creating a mapping file in SAP Sybase Event Stream Processor Studio.

Commands specified in the cnxml file for this adapter cannot contain the following strings: "mv", "rm", or "del".

These adapters can run in managed or unmanaged mode.

The Web Services (SOAP) Input and Output adapters report custom statistics. Enable the time-granularity option in the project configuration (ccr) file to get these statistics reported by the _ESP_Adapter_Statistics metadata stream.

• Control Flow
  The Web Services (SOAP) adapter loads its configuration from a file (for example, adapter_config) and validates it against the adapter schema (framework.xsd).
• Message Flow
  When the Web Services (SOAP) adapter is started, it establishes a connection with a Web service.
• Mapping a Web Service Response to an ESP Column
  Create a mapping file to map Web service WSDL to ESP columns.
• Managed Mode Configuration
  To start and stop the adapter with an ESP project, attach it to a project using the ATTACH ADAPTER statement and configure its properties using the ESP Studio.
• Unmanaged Mode Configuration
  To start and stop the adapter independently of an ESP project, do not reference it in an ATTACH ADAPTER statement, and configure it independently outside of the ESP Studio.
• Stopping the Web Services (SOAP) Adapter
  To stop the Web Services (SOAP) adapter from the command line, execute the stop command.
• Logging
  The Web Services (SOAP) Input and Output adapter uses the Apache log4j API to log errors, warnings, and information and debugging messages. A sample log4j.properties file containing the logging configuration is part of the Web Services (SOAP) Input and Output adapter distribution.
• Adapter Controller Parameters
  The Adapter Control port listens for commands. The controller.xml file is located in %ESP_HOME%/adapters/framework/config directory. This file is shared among all the adapters within the %ESP_HOME%/adapters/framework/instances directory.
• Web Services (SOAP) Adapter Directory
  The adapter directory contains all files, such as configuration files, templates, examples relating to the adapter.
• Examples
  Use the working examples provided with the adapter to learn how to subscribe and publish data to streams in Event Stream Processor.
• Datatype Mapping for the Web Services (SOAP) Input Adapter
  SOAP datatypes map to Event Stream Processor datatypes.
• Datatype Mapping for the Web Services (SOAP) Output Adapter
  Event Stream Processor datatypes map to SOAP datatypes.