NetworkedPlanet | TMCore Web Services Guide |
The TopicMapTransaction
element is the root
element for a transaction document. Each transaction consists of an
ordered list of actions. Actions and transactions
are executed in the order that they are specified in the XML document,
but the results of these actions are not committed to the database
until all actions are successfully completed. If one action within a
TopicMapTransaction element is not processed successfully, all
modifications to the topic map made by preceding actions are revoked
and the processing will stop and an error returned in the results
document.
The TopicMapTransaction
element has the
following syntax:
<txn:TopicMapTransaction> <txn:CreateTopic ... > ... </txn:CreateTopic> <txn:UpdateTopic ... > ... </txn:UpdateTopic> <txn:DeleteTopic ... > ... </txn:DeleteTopic> <txn:CreateTopicProperty ... > ... </txn:CreateTopicProperty> <txn:DeleteTopicProperty ... > ... </txn:DeleteTopicProperty> <txn:CreateAssociation ... > ... </txn:CreateAssociation> <txn:DeleteAssociation ... > .... </txn:DeleteAssociation> <txn:TopicMapTransaction ... > ... </txn:TopicMapTransaction> </txn:transaction>
This element describes a single transaction. The elements
shown as children of this element may occur any number of times
and in any order. Nested transactions are supported and are
represented using nested
txn:TopicMapTransaction
elements.
The other child elements allowed inside the
txn:TopicMapTransaction
element are described
below.