Oracle® Secure Enterprise Search Administration API Guide 11g Release 2 (11.2.1) Part Number E17595-04 |
|
|
View PDF |
Updates all objects of a given type that are described in the XML.
See Also
SOAP Message
<updateAll xmlns="http://search.oracle.com/Admin"> <creatableType> <objectXML xmlns=""> <decryptionKey xmlns=""> <credentials xmlns=""> <password> <userName> <controls xmlns=""> <controlName> <controlValue> <locale xmlns="">
Element Descriptions
Describes creation of an administrative object. It contains these elements:
<creatableType> <objectKey> <objectXML> <decryptionKey> <credentials> <attachments> <controls> <locale>
Contains one of these types:
altWord docServiceInstance docServicePipeline facetTree proxyLogin schedule searchAttr source sourceGroup suggLink
Contains an XML document that describes the object. See Chapter 2, "Administration Object Types."
Use escape codes for these symbols in the embedded XML:
Symbol | Escape Code |
---|---|
< |
< |
> |
> |
" |
" |
Contains a decryption key for proxyLogin
and source
objects.
Provides the credentials for the Oracle SES administrator. Credentials are required only when the session is stateless. See "Providing Credentials".
This element contains these child elements:
<password> <userName>
Contains the password for <userName>
.
Contains the user name of the Oracle SES administrator.
Specifies an operation control. It contains these elements:
<controlName> <controlValue>
UPDATE_METHOD
: Controls the method used to update the properties of an object.
NOT_FOUND_METHOD
: Controls the action to take when an object does not exist.
IGNORE_INVALID_STATE
: Controls whether processing continues when an object cannot be overwritten because it is in an invalid state. For clusterTree
, schedule
, and storageArea
objects. This option is used only when UPDATE_METHOD
is OVERWRITE
.
For UPDATE_METHOD
:
overwrite
: Replaces the existing property values with the new values.
add
: Adds new properties and overwrites existing properties, but does not delete existing properties that are omitted from the XML document. For clusterTree
, schedule
, searchAttr
, source
, sourceGroup
, sourceType
, and storageArea
.
remove
: Removes existing properties. For clusterTree
, resultList
, schedule
, searchAttr
, source
, sourceGroup
, sourceType
, and storageArea
.
For NOT_FOUND_METHOD
:
create
: Creates a new object from the XML description and continue processing.
error
: Processing stops with an error. (Default)
ignore
: Ignore the new description and continue processing.
For IGNORE_INVALID_STATE
:
true
: Continue processing with the next object.
false
: Stop processing with an error and roll back all changes. (Default)
Sets the language for error messages. See Table 2-2, "Product Languages" for a list of valid codes.
If you omit this element or enter an invalid code, then Oracle SES uses the default locale of the system where it is running.
SOAP Faults
AdminAPIRuntimeFault CreatableAdminObjectFault DependentObjectFault InvalidInputFault InvalidStateFault
Notes
After updating a skin bundle, restart the middle tier.
Example
This example updates all of the altWord
objects described in the <objectXML>
element. The content of this element is not shown.
<updateAll xmlns="http://search.oracle.com/Admin"> <creatableType xmlns="">altWord</creatableType> <objectXML xmlns=""> <!-- XML object descriptions appear here--> </objectXML> <controls xmlns=""> <controlName>UPDATE_METHOD</controlName> <controlValue>OVERWRITE</controlValue> </controls> <controls xmlns=""> <controlName>NOT_FOUND_METHOD</controlName> <controlValue>CREATE</controlValue> </controls> </updateAll>
The service response shows that two alternate keywords were updated and one was created.
<ns2:updateAllResponse xmlns:ns2="http://search.oracle.com/Admin"> <statusList> <objectKey> <adminKeyPairs> <keyName>keyword</keyName> <keyValue>oses</keyValue> </adminKeyPairs> <adminKeyPairs> <keyName>altKeyword</keyName> <keyValue>Oracle Secure Enterprise Search</keyValue> </adminKeyPairs> </objectKey> <objectType>altWord</objectType> <statusCode>UPDATE_SUCCEEDED</statusCode> </statusList> <statusList> <objectKey> <adminKeyPairs> <keyName>keyword</keyName> <keyValue>rac</keyValue> </adminKeyPairs> <adminKeyPairs> <keyName>altKeyword</keyName> <keyValue>Real Application Clusters</keyValue> </adminKeyPairs> </objectKey> <objectType>altWord</objectType> <statusCode>NOT_FOUND_CREATED</statusCode> </statusList> <statusList> <objectKey> <adminKeyPairs> <keyName>keyword</keyName> <keyValue>text</keyValue> </adminKeyPairs> <adminKeyPairs> <keyName>altKeyword</keyName> <keyValue>Oracle Text</keyValue> </adminKeyPairs> </objectKey> <objectType>altWord</objectType> <statusCode>UPDATE_SUCCEEDED</statusCode> </statusList> </ns2:updateAllResponse>