DeleteTopic Element

`DeleteTopic` Element
	Topic Map Transaction Schema

`DeleteTopic` Element

This action element specifies that a single topic should be deleted. The topic to be deleted may be identified either by its database object identifier or by a subject identifier assigned to the topic. The DeleteTopic element has the following structure:

<txn:DeleteTopic id="...">
  <tmd:topic oid="..." subjectIdentifier="..." subjectLocator="..." sourceLocator="..." version="...">
    ...
  </tmd:topic>
</txn:DeleteTopic>

txn:DeleteTopic

The wrapper element for the DeleteTopic action.

txn:DeleteTopic/@id

The identifier for this operation. This identifier is used to correlate any error messages to the operation that caused the error.

txn:DeleteTopic/tmd:topic

This REQUIRED element from the Topic Map Fragment XML Schema identifies the topic to be deleted. Only the oid and psi attributes of this element are processed - all other attributes and content are ignored.

txn:DeleteTopic/tmd:topic/@oid

OPTIONAL attribute. Identiifes the topic to be deleted by its database object identifier.

txn:DeleteTopic/tmd:topic/@subjectIdentifier

OPTIONAL attribute. Identifies the topic to be deleted by its subject identifier. This attribute will be used only if no value is provided for the oid attribute.

txn:DeleteTopic/tmd:topic/@subjectLocator

OPTIONAL attribute. Identifies the topic to be deleted by its subject locator. This attribute will be used only if no value is provided for the oid and subjectIdentifier attributes.

txn:DeleteTopic/tmd:topic/@sourceLocator

OPTIONAL attribute. Identifies the topic to be deleted by its source locator. This attribute will be used only if no value is provided for the oid subjectIdentifier, and subjectLocator attributes.

txn:DeleteTopic/tmd:topic/@version

This OPTIONAL attribute identifies the version of the topic to be deleted. The topic will only be deleted if its current version number matches the value of this attribute. If the topic's current version number does not match the value specified here, then an error will be returned.

If this attribute is ommitted, the topic will be deleted regardless of the current version number.

Note

Although the Topic Map Fragment XML Schema allows the oid, subjectIdentifier, subjectLocator and sourceLocator attributes to be ommitted, this action requires that at least one of these attributes has a value.


`UpdateTopic` Element		`CreateTopicProperty`