contactCard

Article
01/20/2015

Contains the contact information stored the underlying Active Directory.

<contactCard 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/contactcard"
    updated="xs:dateTime"
    [anyAttr]="any "
    isUCEnabled="boolean"
    majorVersion="xs:unsignedInt"
    minorVersion="xs:unsignedInt">
    <identity updated="xs:dateTime" [anyAttr]="any">......</identity>
    <address type="addressTypeEnumEx" [anyAttr]="any"> ...... </address>
    <company updated="xs:dateTime" [anyAttr]="any" LCID="xs:unsignedInt">string</company>
    <department updated="DateTime" [anyAttr]="any" LCID="xs:unsignedInt">string</department>
    <title updated="xs:dateTime" [anyAttr]="any" LCID="xs:unsignedInt">string</title>
    <office updated="xs:dateTime" [anyAttr]="any" LCID="xs:unsignedInt">string</office>
    <url updated="xs:dateTime" [anyAttr]="any" type="urlTypeTokenEx">string</url>
    <phone updated="xs:dateTime" [anyAttr]="any" type="phoneTypeEnumEx">......</pone>
    <automaton>boolean</automaton>
    <type>presnetityTypeEnumEx</type>
    <description>xs:string of at most 1020 characters long</description>
    <displayADPhoto>boolean</displayADPhoto>
    <photo updated="xs:dateTime" [anyAttr]="any" type="photoTypeEnumEx">......</photo>
    <ct:delimiter xmlns:ct="https://schemas.microsoft.com/2006/09/sip/commontypes" />
    <[any]>any element in the contactCard namespace</[any]>
    <ct:end xmlns:ct="https://schemas.microsoft.com/2006/09/sip/commontypes" />
    <ct:extension xmlns:ct="https://schemas.microsoft.com/2006/09/sip/commontypes">
        <[any] xmlns="any namespace">custom element</[any]>
    </ct:extension>
</contactCard>

contactCardType

Attributes and Elements

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

Attributes

Attribute	Description
updated	Optional attribute to indicate the date and time, of the 0001-01-01T00:00:00 format, when this contactCard instance was last updated.
isUcEnabled	Optional attribute containing a Boolean flag to indicate if the Exchange Unified Messaging is enabled for this contact (true) or not (false).
majorVersion	Optional attribute to specify schema-dependent major version information of this contactCard element
minorVersion	Optional attribute to specify schema-dependent minor version information of this contactCard element
[anyAttr]	Optional custom attribute of any name in any namespace

Child Elements

Element	Occurrence	Description
identity	0 or more	The identity of the contact, including the display name and email address.
address	0 or more	The address of the contact.
company	0 or more	The company name of the contact.
department	0 or more	The department name of the contact.
title	0 or more	The professional title of the contact.
office	0 or more	The office location of the contact.
url	0 or more	The URL of the source where the encapsulated contact information is obtained.
phone	0 or more	Information about the contact’s phone.
automaton	0 or 1	A Boolean flag indicating if the contact is a not person (true) or a person (false).
type	0 or 1	Introduced in the Office Communications Server 2007 release, this element specifies the type of the contact.
description	0 or 1	The description about the contact. This is a schema extension introduced in the Office Communications Server 2007 R2 Release.
displayADPhoto	0 or 1	A Boolean flag indicating if the contact’s photo stored in Active Directory is to displayed (true) or not (false). This element is a schema extension introduced in the Microsoft Lync Server 2010 release.
photo	0 or more	A schema extension introduced in the Lync Server 2010 release to specify the location of user-specified photo of the contact.
[any]	0 or more	Custom element in the same target namespace describing a schema extension.
delimiter	0 or more	A demarcation to separate version-dependent extensions.
end	0 or 1	The demarcation of the end of all the schema versions
extension	0 or 1	A version-dependent schema extension

Parent Elements

Element	Description
None	This is a top-level element as an enhanced presence category instance

Text Value

This element does have any text value.

Remarks

Multiple instances of contactCard can be used to publish different pieces of the contact information.

Example

The following XML code snippet shows a contactCard category instance containing only the identity of the contact.

        <contactCard xmlns="https://schemas.microsoft.com/2006/09/sip/contactcard">
          <identity>
            <name>
              <displayName>bob</displayName>
            </name>
            <email>bob@contoso.com</email>
          </identity>
        </contactCard>

Element Information

Namespace	https://schemas.microsoft.com/2006/09/sip/contactcard
Schema Name	contactCard
Validation File	contactCard.xsd, contactCardTypes.xsd
Can be Empty	True