updateContainer Element in Unified Communications AJAX SDK

Article
05/23/2014

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.

Adds members to or removes members from a container.

Syntax

<updateContainer 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
cwaRequests	Contains one or more methods that a Unified Communications AJAX API Client sends to a Communicator Web Access server.

Child Elements

Element	Occurrences	Description
container	1	This multi-use element can be used to request the addition or removal of contacts from a given presence-level access container.

Remarks

This request method updates the category data in the container specified by the id attribute in the container element. The event response to this request includes the complete contents of the container after the request is completed.

Examples

The logged-on user wants to restrict the access of jessicaa@contoso.com to his presence information. To do this, the user removes jessicaa@contoso.com from his containerid 400 - the Personal container. By default, sip:jessicaa@contoso.com is added to container 100 - the public container.

<cwaRequests xmlns="http://schemas.microsoft.com/2006/09/rtc/cwa" sid="141">
   <updateContainer rid="2">
      <container id="400">
        <deleteMember type="uri" value="sip:jessicaa@contoso.com"/>
      </container>
   </updateContainer>
</cwaRequests>

Communicator Web Access server sends an event response that indicates that the request succeeded. In this case, the logged-on user no longer has any subscribing users in this container.

<cwaEvents pollWaitTime="3000" ackId="15" sid="141">
   <requestSucceeded eid="14" rid="2"/>
   <containers eid="15">
      <container id="400" version="2"/>
   </containers>
</cwaEvents>