Share via


containers Event

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.

Returns a list of containers, with a full list of the membership for each container. The individual containers in this element are the method by which a Communicator Web Access Server provides complete information about the presence access levels for a user's contacts.

Syntax

<containers eid="1344">
   <container id="100">
      <member type="uri" value="sip:bob@contoso.com" />
   </container>
</containers>

The following sections describe attributes, parent elements, and child elements.

Attributes

Attribute

Data Type

Description

eid

integer

Event Id. This is an integer value assigned by the Communicator Web Access Server.

Element Information

Parent Element

Element

Description

cwaEvents

Holds the responses from the asynchronous data channel with which a Unified Communications AJAX API Client polls the server for updates that have taken place.

Child Element

Element

Occurrence

Description

container

1 or more

The container that belongs to the user.

Remarks

After a session is initiated, the server generates and returns an instance of this event containing all the containers and their memberships. Subsequently, an instance of this event can contain a single container, with its full memberships, when there is a membership change in that container.

A container is created by the server whenever a request (such as publishing a category or adding a member) assumes the existence of a container and the container does not already exist. Thus, a client can expect to receive this event when a container is created or changed. There is no separate event for container being added or deleted.

Examples

The logged-on user in this example has blocked no users (id="32000"), has no personal contacts (id="400 "), no team contacts (id="300 "), has chosen to put all of their fellow employees in the company container (id="200 "), and has moved Sally G. into the container reserved for federated enterprises (id="100"). Any individual or group that has not been assigned one of the above containers is placed by default into the public container (id="100 ").

<containers eid="3">
   <container id="32000" version="0" />
   <container id="400" version="0" />
   <container id="300" version="0" />
   <container id="200" version="1">
      <member type="sameEnterprise" />
   </container>
   <container id="100" version="2">
      <member type="uri" value="sip:sallyg@contoso.com" />
      <member type="federated" />
   </container><container id="3" version="0" />
   <container id="2" version="0" />
   <container id="1" version="2" />
   <container id="0" version="0">
      <member type="everyone" />
   </container>
</containers>

See Also

Concepts

updateContainer Element in Unified Communications AJAX SDK

initiateSession Element