addMember 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.
Adds a set of users to a predefined access control container.
Syntax
<addMember type="string value" value="SIP Uri formatted string value"/>
Attributes
Attribute |
Data Type |
Description |
|---|---|---|
type |
String |
The type of URI. This can be one of uri | domain | sameEnterprise | federated | publicCloud | everyone. This is a required attribute. |
value |
xs:anyUri |
The URI indicated the Access Control Entry (ACE). The value attribute is optional but is logically required for the types: uri and domain. |
Enumerations of type attribute
Possible Value |
Description |
|---|---|
uri |
A single user. |
everyone |
The most general category. This assigns all user contacts to the container. |
domain |
All users from this domain are assigned as members of the parent container element. The value for domain can be any Fully Qualified Domain Name (FQDN). Office Communicator Server matches this to the SIP URI of the individual that wants to view the users presence. For information about the Rich Presence Model, see Publishing and Subscribing To Presence. |
sameEnterprise |
All users in the same enterprise (company) are assigned to the parent container element. |
publicCloud |
Users of other IM systems complying to the industry standard which allows other IM systems to interoperate with Unified Communications. |
federated |
Users from federated companies. |
Element Information
Parent Element
Element |
Description |
|---|---|
This multi-use element can be used to request the addition or removal of contacts from a given presence-level access container. |
Remarks
The addMember element specifies the user or group of users to be added to the parent container. The type attribute determines the scope of the user group to be added. Membership scope is composed of the following access levels:
User: Comprised of the single user identified by SIP:Uri.
Domain: Comprises users whose Uri is in the same domain. The domain portion of a SIP Uri follows the "@" symbol. For example, Jay Adams belongs to the contoso.com domain if his SIP Uri is "jaya@contoso.com".
Company: Comprises users in the same organization behind a common firewall.
Federated Enterprise: Comprises users across domains but in the same federation and enterprise.
Federated Public: Comprises users across domains but in the same federation regardless of enterprise membership.
Everyone: Comprises all users in all domains.
For more information, see Publish And Subscribing To Presence.
Examples
This example shows a user named Joe A. from the contoso.com domain being added to the logged-on users private container. This added member has the highest level of access to the user presence information of the logged-on user.
<container id="400" version="1">
<addMember type="uri" value="sip:joea@contoso.com" />
</container>