CreateTopicProperty

This action adds names, occurrences and identifiers to a topic already in the database (or a topic created in a preceding action in the same request). The element has the following structure:

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

The wrapper element for this action.

txn:CreateTopicProperty/@id

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

txn:CreateTopicProperty/tmd:topic

REQUIRED. Identifies the topic to be updated and contains the names, occurrences and identifiers to be added to the topic.

txn:CreateTopicProperty/tmd:topic/@oid

Identifies the topic to be updated by either its database object identifier (if the topic already exists in the database), or by the object identifier assigned to the topic when it was created in a preceding action. A string which can be parsed as a valid database object identifier (an integer) will be treated as such.

txn:CreateTopicProperty/tmd:topic/@subjectIdentifier

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

txn:CreateTopicProperty/tmd:topic/@subjectLocator

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

txn:CreateTopicProperty/tmd:topic/@sourceLocator

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

txn:CreateTopicProperty/tmd:topic/@version

This OPTIONAL attribute identifies the version of the topic to be updated. The topic will only be updated 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 update will be applied to the latest version of the topic.

Note

This method will fail if the topic to be updated cannot be found.

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.