Preface

The Oracle Secure Enterprise Search Administration API Guide documents two interfaces to the Administration API: a command-line interface and a Web services interface. It also introduces the Web services Java client. The Administration API supports the same features as the Oracle SES Administration GUI, and some new features that are currently not supported by the GUI.

Audience

This document is intended for anyone using the Oracle SES Administration API:

• Administrators of Oracle Secure Enterprise Search may find a command-line interface to be easier for routine tasks than a graphical user interface. Administrators of large installations, who make the same changes across many instances of Oracle SES, will find the command-line interface to be particularly useful.

• Java developers can create custom administrative tools using the Web services Java client.

• Web services developers can create custom administrative tools using any technology that supports Simple Object Access Protocol (SOAP), such as Java and Microsoft ASP.NET.

• Web designers can create custom skins for the default search interface using any of these interfaces.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/us/corporate/accessibility/index.html.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http://www.oracle.com/accessibility/support.html if you are hearing impaired.

Related Documents

For more information about Oracle Secure Enterprise Search, refer to the following resources:

• Oracle Secure Enterprise Search Administrator's Guide

  Explains how to administer Oracle Secure Enterprise Search instances, including how to set up a variety of information sources, crawl and index those sources, and customize the search results.

• Oracle Secure Enterprise Search Release Notes

  Provides version information and identifies known issues.

• Oracle Secure Enterprise Search Installation Guides

  Discuss installation requirements and tips, and provides information on how to get started using Oracle Secure Enterprise Search.

• Oracle Secure Enterprise Search Java API Reference

  Describes the classes and methods in the Oracle SES Java APIs.

Up-to-date Release Notes are posted on Oracle Technology Network (OTN). You must register online before using OTN. Registration is free and can be done at this location:

http://www.oracle.com/technology

If you have a user name and password for OTN, then you can go directly to the documentation section of OTN at this location:

http://www.oracle.com/technology/documentation

Conventions

The following text conventions are used in this document:

Convention	Meaning
boldface	Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary.
italic	Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.
monospace	Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

This reference presents syntax in a simple variant of Backus-Naur Form (BNF) that includes the following symbols and conventions.

Symbol or Convention	Meaning
[ ]	Brackets enclose optional items.
{ }	Braces enclose a choice of items of which only one is required.
|	A vertical bar separates alternatives.
...	Ellipses indicate that the preceding syntactic element can be repeated.
/	A slash separates levels of a directory path. On Windows, use a backslash (\) in place of a slash (/).
delimiters	Delimiters other than brackets, braces, vertical bars, and ellipses must be entered as shown.
italics	Words appearing in italics are placeholders for which you must substitute a name or a value. Words that are not in italics are keywords and must be entered as shown.
ORACLE_BASE	ORACLE_BASE is the root of the directory structure, where Oracle SES software and its supporting infrastructure software are installed. This directory path typically is stored in an environment variable. On Linux and UNIX systems, you can reference the variable as $ORACLE_BASE. On Windows, the equivalent is %ORACLE_BASE%.
ORACLE_HOME	ORACLE_HOME is the ORACLE_BASE/seshome directory. This directory path typically is stored in an environment variable. On Linux and UNIX systems, you can reference the variable as $ORACLE_HOME. On Windows, the equivalent is %ORACLE_HOME%.