About the Conversation Web Service

The Conversation Web Service provides the primary means of querying data in the Oracle Endeca Server. This web service interface can be used by any front-end application powered by the Oracle Endeca Server. The interface is used by Studio to send queries (such as navigation or search queries) to the Oracle Endeca Server. You can also use it on its own.

Overview

The service is a WS-I compliant SOAP/HTTP Web service that also supports the wrapped-document/literal pattern of binding.

The Conversation Web Service is declared in conversation.wsdl. The service uses several library helper modules.

To view the WSDL document for the Conversation Web Service, issue the following command:
http://localhost:<port>/ws/conversation/DataStore?wsdl
where the host and port represent the Oracle Endeca Server, and the DataStore is the name of the data store created on the server.
The service's version is listed in one of its namespaces included in the WSDL, as shown in the following example (the version in this example may not match the version of the service you have installed):
xmlns:cs_v1_0="http://www.endeca.com/MDEX/conversation/1/0"
In this example, 1 is the major version; 0 is the minor version. If more than one minor version is supported, it is listed in its own namespace in the WSDL.
The service supports fundamental Oracle Endeca Server behavior, such as:
  • Guided navigation
  • Record and value searches
  • Communication between the front-end application client and the Oracle Endeca Server
  • A range of summarizations

For reference information on the Conversation Web Service operations and for schema elements, see the Oracle Endeca Server API Reference.