NetworkedPlanet | TMCore Web Services Guide |
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>
The wrapper element for the CreateTopic action.
The identifier for this operation. This identifier is used to correlate any error messages to the operation that caused the error.
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).
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.