Accessing the Administration Web Service

The Administration Web Service is declared in admin.wsdl.

You can access the Administration Web Service at the following URL:
http://localhost:<port>/ws/admin/DataStore?wsdl
where the localhost and port are the host and port of the running Oracle Endeca Server, and DataStore is the name of the Endeca data store.
The namespace for the Administration Web Service is similar to the following example and reflects the version of the service:
http://www.endeca.com/MDEX/admin/1/0
This namespace is included in the WSDL document for the web service.

In this example, the string 1/0 indicates the version is 1.0, where 1 is the major version, and 0 is the minor version.

Note: The version in the service that you have installed may not match this example.

Changes to minor versions are backward-compatible. If any backward-compatible versions exist, additional namespaces are included in the WSDL, listing them. You can use any backward-compatible minor version that is listed. For example, if both 1.0 and 1.1 versions are listed in the WSDL, you can use either of them.

Changes to major versions are not backward-compatible, thus previous major versions are not listed in the WSDL namespaces.

Important: After you upgrade the Oracle Endeca Server, verify the versions of the web services you have been using against the installed versions, to avoid version mismatch. It is recommended to use the web service versions that match the ones installed with the Oracle Endeca Server.
In particular:
  • If the minor version of the web service on your client does not match the version installed with the Oracle Endeca Server, you can still use this version if it is listed in the WSDL namespaces, although it is recommended to upgrade.
  • If the major version of the web service on your client does not match the version of the web service installed with the Oracle Endeca Server, you must upgrade to the most recent major version of the web service (this may include upgrading client code to use client stubs generated from the most recent versions).

For more information on web service versions, see the Oracle Endeca Server Developer's Guide.