Web Services Server Connector

The Web Services Server Connector is available in Enterprise Edition and as an add-on for Professional Edition. Contact your Boomi Sales Rep for more information.

Note: Before working with the Web Services Server connector, you should be familiar with general Process Development.

The Web Services Server Connector is a Listen-only connector that accepts HTTP and SOAP requests real-time and initiates Boomi Processes. When a Process containing this connector is deployed to an Atom, the Atom's internal web server will listen for Documents based on configurations made in the Web Services Server Operation.

Review the Web Service Publishing section as it describes the different options and use case scenarios that apply when using this connector.

Operations can be configured to simply accept requests that are processed as standard Documents. Also, the use of the Return Documents shape, as a Process path endpoint, enables synchronous responses to be returned to the external calling / client application. To the extent possible, the technical details of this connector, such as SOAP headers, error handling, HTTPS authentication, XML syntax, etc., are all abstracted from the user to make implementation quick and easy. The XML Profile houses all raw data elements and stands as the main document type for the start and end of a web service process.

In order to build send requests to other web services or applications, you must use one of the following Client connectors:

Connector Configuration

Building a connector to listen for client applications requires the configuration of two unique pieces:

Listen Connection
Web Services Server Operation

The listen connection is managed at the atom-level; therefore, it is not configurable within an individual Process. You can review configuration requirements for the Atom's Shared Web Server here.

This connector design allows for shared re-usability across atoms and the ability to launch unique operations / URLs for different process actions. When a web service is published for request handling, you can develop a Process to interact with virtually any system using other connectors in our library.

You cannot test a Process in Test Mode when developing a Process with the Web Services Server connector. You must deploy a process to an Atom to launch the web service.

Process Options

Allow Simultaneous Process Executions -- This Process option is respected for real-time Processes using the Web Services Server connector. If a Process is deployed with Allow Simultaneous Process Executions turned off, the client will receive an HTTP 500 error when attempting to invoke the Process while it is currently running.

Supported Versions

Generally, web services that you publish can accept:

SOAP document-literal
Arbitrary XML definitions
Other structured formats such as flat file / csv

The accepted structure is dependent upon the input/output types defined in the Web Service Object Configuration section.

Additional Resources
WS-I Basic Profile 1.1 Specification
W3Schools Web Services Tutorial
Apache Axis
.Net