About composite operations and transactions
Certain Administrate operations can be composite operations. That is, a single request can perform multiple administrative tasks, such as CreateGroup, DeleteUser, and CreateRole. In general, the operations you can group into a single message are those that create, update, or delete an item in an Encyclopedia volume.
A transaction is a composite operation identified in the Transaction element of the schema. If a failure occurs anywhere in the transaction sequence, all operations in the transaction fail.
The following example shows a composite request to add a user, Kevin Neery, to three groups. The groups are identified by their iHub-generated ID numbers in the IdList element.
<SOAP-ENV:Body>
<Administrate>
<AdminOperation>
<UpdateGroup>
<UpdateGroupOperationGroup>
<UpdateGroupOperation>
<AssignedToUsersByName>
<String>Kevin Neery</String>
</AssignedToUsersByName>
</UpdateGroupOperation>
</UpdateGroupOperationGroup>
<IdList>
<String>1024</String>
<String>3772</String>
<String>3781</String>
</IdList>
</UpdateGroup>
</AdminOperation>
</Administrate>
</SOAP-ENV:Body>