Share via


External Contacts Container

This container has a container ID value of 100. The default access control list contains a single entry for federated users. Non-private category instances published to this container are visible to all the users of a federated network by default.

The following category instances are published to this container.

Category Instances Published by Microsoft Lync Server 2010

Category Name

Instance ID

Description

contactCard

0

Contains the local user’s identity consisting of the display name and e-mail address as provisioned from the Active Directory. The following is an example of this category instance.

<contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard">
  <identity>
    <name>
      <displayName>John Barr</displayName>
    </name>
    <email>john.barr@exchange.contoso.com</email>
  </identity>
</contactCard>

legacyInterop

1

Contains the availability number of the local user’s current state[@type='aggregateState'] making the local user’s presence status available to the container members using legacy clients. The following is an example of this category instance.

<legacyInterop availability="3500" xmlns="https://schemas.microsoft.com/2006/09/sip/categories" />

Category Instances Published by Aggregation Script

Category Name

Instance ID

Description

state[@type='aggregateState']

1

Contains only the local user’s current availability number. The following is an example of this category instance

<state xsi:type="aggregateState" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
       xmlns="https://schemas.microsoft.com/2006/09/sip/state">
  <availability>3500</availability>
</state>

services

0

Contains the endpoint-independent presence capabilities of the local user. This is shown in the following example.

<services xmlns="https://schemas.microsoft.com/2006/09/sip/service">
  <service uri="sip:kdeding@microsoft.com">
    <capabilities>
      <text render="true" capture="true" deviceAvailability="3500" />
      <gifInk render="true" capture="false" deviceAvailability="3500" />
      <isfInk render="true" capture="false" deviceAvailability="3500" />
      <applicationSharing render="true" capture="true" deviceAvailability="3500" />
      <voice render="true" capture="true" deviceAvailability="3500" />
      <video render="true" capture="true" deviceAvailability="3500" />
      <contentWhiteboard render="true" capture="true" deviceAvailability="3500" />
      <contentPoll render="true" capture="true" deviceAvailability="3500" />
      <contentPowerPoint render="true" capture="true" deviceAvailability="3500" />
      <contentNativeFile render="true" capture="true" deviceAvailability="3500" />
    </capabilities>
  </service>
</services>

Category Instances Published by Lync 2010

Category Name

Instance ID

Description

contactCard

1

Contains an empty value of this category instance as shown in the following example

<contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard">
</contactCard>

This category instance is meant to contain the local user’s contact information as constructed from the user-configurable options, such as the local user’s home phone number. This effectively blocks members of this container from accessing such information.

contactCard

3

Contains the local user’s company description and job title, which are obtained from the underlying Lync Server 2010 Address Book Server. The is shown in the following example.

<contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <company>Contoso</company>
  <title>Senior Employee</title>
</contactCard>

contactCard

4

Contains the server-provisioned voice mail URL of the local user when the user has unified communications (UC) enabled. This is shown in the following example.

<contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard" isUCEnabled="true">
  <url type="voicemail">sip:johnd@contos.com;opaque=app:voicemail;local-resource-path=voicememo</url>
</contactCard>

contactCard

6

Contains the local user’s job title and display photo. This causes the local user’s photo displayed to members of this container. This is shown in the following example.

<contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard">
  <title>SENIOR EMPLOYEE</title>
  <delimiter xmlns:auto-ns1="https://schemas.microsoft.com/2006/09/sip/contactcard" 
             xmlns="https://schemas.microsoft.com/2006/09/sip/commontypes">
  </delimiter>
  <delimiter xmlns:auto-ns1="https://schemas.microsoft.com/2006/09/sip/contactcard" 
             xmlns="https://schemas.microsoft.com/2006/09/sip/commontypes">
  </delimiter>
  <displayADPhoto>true</displayADPhoto>
  <photo type="enterprise" updated="2010-05-24T21:08:59Z">
    <uri></uri>
    <hash>10b394d3bdc9b3f999e44efb5c269dda</hash>
  </photo>
</contactCard>

calendarData

0

Contains an empty value. This effectively blocks the external contacts from accessing the local user’s working-hours information obtained from the user’s Exchange account.

calendarData

A hash dependent on the local user’s email address

Contains an empty value for the freeBusy information, as shown in the following example.

<calendarData xmlns="https://schemas.microsoft.com/2006/09/sip/calendarData">
</calendarData>

This effectively blocks the container members from accessing the local user’s free-busy information.

dndState

0

Contains an empty value when the local user is not in the Do not disturb availability mode and contains an availability number of 9500 when the user is in the Do not disturb mode. This is shown in the following example.

<state xmlns="https://schemas.microsoft.com/2006/09/sip/state"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:type="userState" manual="true" />

note

0

Contains a personal note set by the local user. This is shown in the following example.

<note xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
      xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
      xmlns="https://schemas.microsoft.com/2006/09/sip/note">
  <body type="personal" uri="">A message for public</body>
</note>

note

A hash dependent of the local user’s email address

Published during an OOF period, this instance contains an out-of-facility (OOF) note with an empty value as shown in the following example.

<note xmlns="https://schemas.microsoft.com/2006/09/sip/note"></note>

This effectively prevents the external contacts from viewing the OOF message.

routing

One or more routing category instances containing the user-configurable routing rules to handle incoming calls from a member of this container. The following is an example of such an instance.

<routing xmlns="https://schemas.microsoft.com/02/2006/sip/routing" 
         name="rtcdefault" version="2" minSupportedClientVersion="4.0.0.0">
  <preamble>
    <flags name="clientflags" value="simultaneous_ring"></flags>
    <wait name="total" seconds="20"></wait>
    <list name="forwardto"></list>
    <wait name="user" seconds="0"></wait>
    <wait name="team1" seconds="0"></wait>
    <wait name="team2" seconds="0"></wait>
    <list name="simultaneous_ring">
      <target uri="sip:+12065551111@contoso.com;user=phone"></target>
    </list>
  </preamble>
</routing>