2.2.4.3 t:ContactItemType Complex Type

The ContactItemType complex type represents a server contact (2) item. It is also used by the ResolveNames method ([MS-OXWSRSLNM] section 3.1.4.1), returning directory and store contacts (2) matching a search string. This type extends the ItemType complex type, as specified in [MS-OXWSCORE] section 2.2.4.24. This type is used by the CreateItem operation, as specified in section 3.1.4.6, and the UpdateItem operation, as specified in section 3.1.4.3.

 <xs:complexType name="ContactItemType">
   <xs:complexContent>
     <xs:extension
       base="t:ItemType"
     >
       <xs:sequence>
         <xs:element name="FileAs"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="FileAsMapping"
           type="t:FileAsMappingType" 
           minOccurs="0"
          />
         <xs:element name="DisplayName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="GivenName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Initials"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="MiddleName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Nickname"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="CompleteName"
           type="t:CompleteNameType"
           minOccurs="0"
          />
         <xs:element name="CompanyName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="EmailAddresses"
           type="t:EmailAddressDictionaryType"
           minOccurs="0"
          />
         <xs:element name="PhysicalAddresses"
           type="t:PhysicalAddressDictionaryType"
           minOccurs="0"
          />
         <xs:element name="PhoneNumbers"
           type="t:PhoneNumberDictionaryType"
           minOccurs="0"
          />
         <xs:element name="AssistantName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Birthday"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="BirthdayLocal"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="BusinessHomePage"
           type="xs:anyURI"
           minOccurs="0"
          />
         <xs:element name="Children"
           type="t:ArrayOfStringsType"
           minOccurs="0"
          />
         <xs:element name="Companies"
           type="t:ArrayOfStringsType"
           minOccurs="0"
          />
         <xs:element name="ContactSource"
           type="t:ContactSourceType"
           minOccurs="0"
          />
         <xs:element name="Department"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Generation"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="ImAddresses"
           type="t:ImAddressDictionaryType"
           minOccurs="0"
          />
         <xs:element name="JobTitle"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Manager"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Mileage"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="OfficeLocation"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="PostalAddressIndex"
           type="t:PhysicalAddressIndexType"
           minOccurs="0"
          />
         <xs:element name="Profession"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="SpouseName"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="Surname"
           type="xs:string"
           minOccurs="0"
          />
         <xs:element name="WeddingAnniversary"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="WeddingAnniversaryLocal"
           type="xs:dateTime"
           minOccurs="0"
          />
         <xs:element name="HasPicture"
           type="xs:boolean" 
           minOccurs="0"
          />
         <xs:element name="PhoneticFullName" 
           type="xs:string"
           minOccurs="0" 
         />
         <xs:element name="PhoneticFirstName" 
           type="xs:string" 
           minOccurs="0" 
         />
         <xs:element name="PhoneticLastName" 
           type="xs:string" 
           minOccurs="0" 
         />
         <xs:element name="Alias" 
           type="xs:string" 
           minOccurs="0" 
         />
         <xs:element name="Notes" 
           type="xs:string" 
           minOccurs="0" 
         />
         <xs:element name="Photo" 
           type="xs:base64Binary" 
           minOccurs="0" 
        />
        <xs:element name="UserSMIMECertificate" 
          type="t:ArrayOfBinaryType" 
          minOccurs="0" 
        />
        <xs:element name="MSExchangeCertificate" 
          type="t:ArrayOfBinaryType" 
          minOccurs="0" 
        />
        <xs:element name="DirectoryId" 
          type="xs:string" 
          minOccurs="0" 
        />
        <xs:element name="ManagerMailbox"
          type="t:SingleRecipientType"
          minOccurs="0"
        />
        <xs:element name="DirectReports"
          type="t:ArrayOfRecipientsType"
          minOccurs="0"
        />
        <xs:element name="AccountName" 
          type="xs:string"
          minOccurs="0"
        />
        <xs:element name="IsAutoUpdateDisabled" 
          type="xs:boolean"
          minOccurs="0"
        />
        <xs:element name="IsMessengerEnabled" 
          type="xs:boolean" 
          minOccurs="0"
        />
        <xs:element name="Comment" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="ContactShortId" 
          type="xs:int" 
          minOccurs="0"
        />
        <xs:element name="ContactType" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="Gender" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="IsHidden" 
          type="xs:boolean" 
          minOccurs="0"
        />
        <xs:element name="ObjectId" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="PassportId" 
          type="xs:long" 
          minOccurs="0"
        /> 
        <xs:element name="IsPrivate" 
          type="xs:boolean" 
          minOccurs="0"
        />
        <xs:element name="SourceId" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="TrustLevel" 
          type="xs:int" 
          minOccurs="0"
        />
        <xs:element name="CreatedBy" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="Urls" 
          type="t:ContactUrlDictionaryType" 
          minOccurs="0"
         />
         <xs:element name="AbchEmailAddresses"
           type="t:AbchEmailAddressDictionaryType"
           minOccurs="0"
         />
        <xs:element name="Cid" 
          type="xs:long" 
          minOccurs="0"
        />
        <xs:element name="SkypeAuthCertificate" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="SkypeContext" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="SkypeId" 
          type="xs:string" 
          minOccurs="0"
        />
        <xs:element name="SkypeRelationship" 
          type="xs:string" 
          minOccurs="0"
        />
         <xs:element name="YomiNickname" 
           type="xs:string" 
           minOccurs="0"
         />
         <xs:element name="XboxLiveTag" 
           type="xs:string"
           minOccurs="0"
         />
         <xs:element name="InviteFree" 
           type="xs:boolean" 
           minOccurs="0"
         />
         <xs:element name="HidePresenceAndProfile" 
           type="xs:boolean"
           minOccurs="0"
         />
         <xs:element name="IsPendingOutbound" 
           type="xs:boolean"
           minOccurs="0"
         />
         <xs:element name="SupportGroupFeeds" 
           type="xs:boolean" 
           minOccurs="0"
         />
         <xs:element name="UserTileHash"
           type="xs:string" 
           minOccurs="0"
         />
         <xs:element name="UnifiedInbox" 
           type="xs:boolean" 
           minOccurs="0"
         />
         <xs:element name="Mris"
           type="t:ArrayOfStringsType" 
           minOccurs="0"
         />
         <xs:element name="Wlid" 
           type="xs:string" 
           minOccurs="0"
         />
         <xs:element name="AbchContactId" 
           type="t:GuidType" 
           minOccurs="0"
         />
         <xs:element name="NotInBirthdayCalendar"
            type="xs:boolean"
            minOccurs="0"
         />
         <xs:element name="ShellContactType" 
            type="xs:string" 
            minOccurs="0"
         />
         <xs:element name ="ImMri"
            type="xs:int"
            minOccurs="0"
         />
         <xs:element name="PresenceTrustLevel"
            type="xs:string"
            minOccurs="0"
         />
         <xs:element name="OtherMri"
            type="xs:string"
            minOccurs="0"
         />
         <xs:element name="ProfileLastChanged"
            type="xs:string"
            minOccurs="0"
         />
         <xs:element name="MobileImEnabled"  
            type="xs:boolean"
            minOccurs="0"
         /> 
         <xs:element name="DisplayNamePrefix"  
            type="xs:string"
            minOccurs="0"
         /> 
         <xs:element name="YomiGivenName"  
            type="xs:string"
            minOccurs="0"
         />
         <xs:element name="YomiSurname"  
            type="xs:string"
            minOccurs="0"
         /> 
         <xs:element name="PersonalNotes"  
            type="xs:string"
            minOccurs="0"
         />
         <xs:element name="PersonId"
           type="t:ItemIdType" 
           minOccurs="0"
         />  
       </xs:sequence>
     </xs:entension>
   </xs:complexContent>
 </xs:complexType>

Child Elements<5>

Element name

Type

Description

FileAs

xs:string [XMLSCHEMA2]

Represents how a contact (2) is filed in the Contacts folder.

FileAsMapping

t:FileAsMappingType (section 3.1.4.1.2.4)

Defines how to construct what is displayed for a contact (2).

DisplayName

xs:string

Contains the display name of a contact (2).

GivenName

xs:string

Contains the given name for a contact (2).

Initials

xs:string

Contains the initials for a contact (2).

MiddleName

xs:string

Represents the middle name of a contact (2).

Nickname

xs:string

Represents the nickname of a contact (2).

CompleteName

t:CompleteNameType (section 3.1.4.1.1.5)

Represents the complete name of a contact (2). This property is read-only for client.

CompanyName

xs:string

Contains the company name that is associated with a contact (2).

EmailAddresses

t:EmailAddressDictionaryType (section 3.1.4.1.1.11)

Contains email addresses that are associated with a contact (2).

PhysicalAddresses

t:PhysicalAddressDictionaryType (section 3.1.4.1.1.17)

Represents a collection of physical addresses that are associated with a contact (2).

PhoneNumbers

t:PhoneNumberDictionaryType (section 3.1.4.1.1.15)

Represents a collection of telephone numbers for a contact (2).

AssistantName

xs:string

Contains the name of the assistant for the contact (2).

Birthday

xs:dateTime [XMLSCHEMA2]

Represents the birthday of the contact (2).

BirthdayLocal

xs:dateTime

Represents the birthday of the contact (2) in the client's local time zone.<6>

BusinessHomePage

xs:anyURI [XMLSCHEMA2]

Contains the business home page Uniform Resource Identifier (URI) of a contact (2).

Children

t:ArrayOfStringsType ([MS-OXWSCDATA] section 2.2.4.13)

Contains the names of children for the contact (2).

Companies

t:ArrayOfStringsType

Contains the names of companies that are associated with a contact (2).

ContactSource

t:ContactSourceType (section 2.2.5.1)

Describes whether the contact (2) is located in the server message store or the directory service.

Department

xs:string

Contains the work department for the contact (2).

Generation

xs:string

Contains a generational abbreviation that follows the full name of a contact (2).

ImAddresses

t:ImAddressDictionaryType (section 3.1.4.1.1.13)

Contains instant messaging addresses for a contact (2).

JobTitle

xs:string

Contains the job title of a contact (2).

Manager

xs:string

Represents the manager of a contact (2).

Mileage

xs:string

Represents the mileage for a contact (2).

OfficeLocation

xs:string

Represents the office location of a contact (2).

PostalAddressIndex

t:PhysicalAddressIndexType (section 3.1.4.1.2.7)

Represents the index of one of the physical addresses, which is a contact's (2) mailing address.

Profession

xs:string

Represents the profession of a contact (2).

SpouseName

xs:string

Represents the name of the spouse/partner of a contact (2).

Surname

xs:string

Contains the surname of a contact (2).

WeddingAnniversary

xs:dateTime

Contains the wedding anniversary date of a contact (2).

WeddingAnniversaryLocal

xs:dateTime

Contains the wedding anniversary date of a contact (2) in the client's local time zone.<7>

HasPicture

xs:boolean [XMLSCHEMA2]

Represents that the contact (2) has a picture. This element is read-only for the client.<8>

PhoneticFullName

xs:string

Contains the full name of a contact (2), including the first and last name, spelled phonetically.

PhoneticFirstName

xs:string

Contains the first name of a contact (2), spelled phonetically.

PhoneticLastName

xs:string

Contains the last name of a contact (2), spelled phonetically.

Alias

xs:string

Contains the email alias of a contact.

Notes

xs:string

Contains supplementary contact (2) information.

Photo

xs:base64Binary [XMLSCHEMA2]

Contains a value that encodes the photo of a contact (2).

UserSMIMECertificate

t:ArrayOfBinaryType (section 2.2.4.2)

Contains a value that encodes a contacts (2) S/MIME certificate.

MSExchangeCertificate

t:ArrayOfBinaryType

Contains a value that encodes the server certificate of a contact (2).

DirectoryId

xs:string

Contains the directory identifier of a contact (2).

ManagerMailbox

t:SingleRecipientType ([MS-OXWSCDATA] section 2.2.4.69)

Contains SMTP information that identifies the mailbox of a contact's (2) manager.

DirectReports

t:ArrayOfRecipientsType ([MS-OXWSCDATA] section 2.2.4.11)

Contains SMTP information that identifies the mailboxes of a contact's (2) direct reports.

AccountName

xs:string

The account name. <9>

IsAutoUpdateDisabled

xs:boolean

Specifies whether auto-update is disabled for this contact.<10>

IsMessengerEnabled

xs:boolean

For internal use only.

Comment

xs:string

A comment.<11>

ContactShortId

xs:int

For internal use only.<12>

ContactType

xs:string

The type of the contact.<13>

Gender

xs:string

The gender of the contact.<14>

IsHidden

xs:boolean

For internal use only.<15>

ObjectId

xs:string

The handle of the contact.<16>

PassportId

xs:long

For internal use only.<17>

IsPrivate

xs:boolean

For internal use only.<18>

SourceId

xs:string

Specifies the source of the contact.<19>

TrustLevel

xs:int

For internal use only.<20>

CreatedBy

xs:string

For internal use only.<21>

Urls

t:ContactUrlDictionaryType (section 3.1.4.1.1.9)

Specifies the websites for the contact.<22>

AbchEmailAddresses

t:AbchEmailAddressDictionaryType (section 3.1.4.1.1.2)

Represents an email address entry. This element is not present in server response.

Cid

xs:long

Specifies a unique handle to identify a user.<23>

SkypeAuthCertificate

xs:string

Specifies a token to connect to Skype.<24>

SkypeContext

xs:string

For internal use only.<25>

SkypeId

xs:string

The account name on Skype.<26>

SkypeRelationship

xs:string

For internal use only.<27>

YomiNickname

xs:string

Pronunciation guide for nickname field.<28>

XboxLiveTag

xs:string

Not used.<29>

InviteFree

xs:boolean

For internal use only.<30>

HidePresenceAndProfile

xs:boolean

For internal use only.<31>

IsPendingOutbound

xs:boolean

For internal use only.<32>

SupportGroupFeeds

xs:boolean

Not used.<33>

UserTileHash

xs:string

Not used.<34>

UnifiedInbox

xs:boolean

For internal use only.<35>

Mris

t:ArrayOfStringsType

For internal use only.<36>

Wlid

xs:string

For internal use only.<37>

AbchContactId

t:GuidType

For internal use only.<38>

NotInBirthdayCalendar

xs:boolean

Not used.<39>

DisplayNamePrefix

xs:string

Specifies the prefix for the display name.<40>

YomiGivenName

xs:string

Contains the name used in Japan for the searchable or phonetic spelling of a Japanese given name.<41>

YomiSurname

xs:string

Contains the name used in Japan for the searchable or phonetic spelling of a Japanese surname.<42>

PersonalNotes

xs:string

Specifies the user notes.<43>

PersonId

t:ItemIdType ([MS-OXWSCORE] section 2.2.4.25)

Specifies the ID of the person.<44>