About the Conversation Web Service

The Conversation Web Service provides the primary means of querying data in the Oracle Endeca Server.

Overview

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. It is a WS-I compliant SOAP/HTTP Web service that also supports the wrapped-document/literal pattern of binding.

The service supports fundamental Oracle Endeca Server behavior, such as:
  • Guided navigation
  • Record search
  • Value search
  • Communication between the front-end application client and the Oracle Endeca Server
  • A range of summarizations

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

To view the WSDL document for the Conversation Web Service, issue the following command: 
http://host:<port>/endeca-server/ws/conversation/dataDomain?wsdl
where host and port represent the machine on which an instance of the Oracle Endeca Server is running, and dataDomain is the name of the Endeca data domain.
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_v3_0="http://www.endeca.com/MDEX/conversation/3/0"
In this example, 3 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.

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