CreateTopic Element

The CreateTopic element specifies that a new topic should be created in the topic map. The CreateTopic element has the following structure:

<txn:CreateTopic id="...">
  <tmd:topic oid="..."> 
  ... 
  </tmd:topic>
</txn:CreateTopic>
      
txn:CreateTopic

The wrapper element for the CreateTopic action.

txn:CreateTopic/@id

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

txn:CreateTopic/tmd:topic

This REQUIRED element from the Topic Map Fragment XML Schema provides the details of the topic to be created. If the oid attribute is provided, it may be used to reference the newly created topic in later operations (for example to create associations to the new topic, or to create further topics that are typed by the new topic).

Note

This operation can only be used to create a topic, its names and occurrences. The optional tmd:associations element allowed inside the tmd:topic element will be ignored. To create associations that involve the new topic, it is necessary to use a separate txn:CreateAssociation action. txn:CreateAssociation actions may be included in the same transaction as the one that creates the topic(s) to participate in the association.