addGroup Element
This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.
Creates a contact group. The user creates the name attribute value and the id value is generated by the Communicator Web Access server and returned asynchronously in the event response.
Syntax
<addGroup rid="string value"/>
Attributes
Attribute |
Data Type |
Description |
---|---|---|
rid |
string |
Request Id. This is a string value assigned by the Unified Communications client. This is a required attribute. |
Element Information
Parent Element
Element |
Description |
---|---|
Contains one or more methods that a Unified Communications AJAX API Client sends to a Communicator Web Access server. |
Child Elements
Element |
Occurrences |
Description |
---|---|---|
1 |
A user-defined aggregator of user contacts. |
Remarks
This request method allows the Unified Communications AJAX API Client application to add a contact group. This group is persisted with the Communicator Web Access Server so that the next time the client logs on to Unified Communications or Office Communicator, the added group are displayed for the user. Group names must be unique.
Note
Adding multiple group elements to the addGroup request results in a synchronous requestAccepted response as the XML request is technically well-formed. Because the Communicator Web Access server is not enforcing adherence to an XML schema in this release, the additional group elements do not cause the request to be rejected. Only the first group element is processed. The rest are ignored. To add multiple groups, multiple addGroup requests must be made.
Examples
<addGroup rid="100">
<group name="family" >
</addGroup>