3.2.4.2.4 Contact-Specific Schema

The contact schema implements the contact item abstract data model (section 3.2.1.2). All contact properties can be empty or missing unless this section states otherwise.<28> The following table identifies

some fields by a group of attributes that appear in GetListResponse.GetListResult.List.Fields.Field (see [MS-LISTSWS] and section 3.2.4.2).

Field.Name

Field.ID

Field.Type (interpret as)

Account

None defined.

None defined (Text)

Anniversary<29>

{9D76802C-13C4-484a-9872-D7F9641C4672}

DateTime

AssistantNumber

{F55DE332-074E-4e71-A71A-B90ABFAD51AE}

Text

AssistantsName

{2AEA194D-E399-4f05-95AF-94F87B1F2687}

Text

AttachProps

None defined.

None defined (AttachProps)

BCPicture

None defined.

None defined (base64Binary)

BillingInformation

{4F03F66B-FB1E-4ed2-AB8E-F6ED3FE14844}

Text

Birthday

{C4C7D925-BC1B-4f37-826D-AC49B4FB1BC1}

DateTime

BizCard

None defined.

None defined (hexBinary)

Business2Number

{6547D03A-76D3-4d74-9D34-F51B837C0879}

Text

CallbackNumber

{344E9657-B17F-4344-A834-FF7C056BCC5E}

Text

CarNumber

{92A011A9-FD1B-42e0-B6FA-AFCFEE1928FA}

Text

CellPhone

{2a464df1-44c1-4851-949d-fcd270f0ccf2}

Text

Certificate

None defined.

None defined (base64Binary)

CertificateStr

None defined.

None defined (Text)

CertificatesX509

None defined.

None defined (base64Binary)

ChildrensNames

{6440B402-8EC5-4d7a-83F4-AFCCB556B5CC}

Text

Comments

{9da97a8a-1da5-4a77-98d3-4bc10456e700}

Note

Company

{038d1503-4629-40f6-adaf-b47d1ab2d4fe}

Text

CompanyNumber

{27CB1283-BDA2-4ae8-BCFF-71725B674DBB}

Text

CompanyPhonetic

{034aae88-6e9a-4e41-bc8a-09b6c15fcdf4}

Text

ComputerNetworkName

{86A78395-C8AD-429e-ABFF-BE09417B523E}

Text

ConfDefServerIndex

None defined.

None defined (Text)

ConfServerNames

None defined.

None defined (Text)

ContactLinkName

None defined.

None defined (Text)

CustomerID

{81368791-7CBC-4230-981A-A7669ADE9801}

Text

Description

None defined.

None defined (Text)

Editor

{d31655d1-1d5b-4511-95a1-7a09e9b75bf2}

User

Email

{fce16b4c-fe53-4793-aaab-b4892e736d15}

Text

Email2

{E232D6C8-9F49-4be2-BB28-B90570BCF167}

Text

Email3

{8BD27DBD-29A0-4ccd-BCB4-03FE70C538B1}

Text

EmailDisplayAs1

None defined.

None defined (Text)

EmailDisplayAs2

None defined.

None defined (Text)

EmailDisplayAs3

None defined.

None defined (Text)

Fax1

None defined.

None defined (Text)

Fax2

None defined.

None defined (Text)

Fax3

None defined.

None defined (Text)

FaxDisplayAs1

None defined.

None defined (Text)

FaxDisplayAs2

None defined.

None defined (Text)

FaxDisplayAs3

None defined.

None defined (Text)

FileAs

None defined.

None defined (Text)

FirstName

{4a722dd4-d406-4356-93f9-2550b8f50dd0}

Text

FirstNamePhonetic

{ea8f7ca9-2a0e-4a89-b8bf-c51a6af62c73}

Text

FreeBusyURL

None defined.

None defined (Text)

FTPSite

{D733736E-4204-4812-9565-191567B27E33}

URL

FullName

{475c2610-c157-4b91-9e2d-6855031b3538}

Text

Gender

{23550288-91B5-4e7f-81F9-1A92661C4838}

Choice or Integer (Gender)<30>

GovernmentIDNumber

{DA31D3C9-F9DA-4c35-88D4-60AAFA4C3F19}

Text

Hobbies

{203FA378-6EB8-4ed9-A4F9-221A4C1FBF46}

Text

Home2Number

{8C5A385D-2FFF-42da-A4C5-F6A904F2E491}

Text

HomeAddress

{8C66E340-0985-4d68-AF03-3050ECE4862B}

Text

HomeAddressCity<31>

{5AEABC56-57C6-4861-BC12-BD72C30FC6BD}

Text

HomeAddressCountry<32>

{897ECFD7-4293-4782-B463-BD68440A5FED}

Text

HomeAddressPostalCode<33>

{C0E4B4C6-6245-4846-8561-B8C6C01FEFC1}

Text

HomeAddressStateOrProvince<34>

{F5B36006-69B0-418c-BD4A-F25CA7E096BB}

Text

HomeFaxNumber

{C189A857-E6B0-488f-83A0-F4EE0A3AD01E}

Text

HomeFreeForm

None defined

None defined (Text)

HomePhone

{2ab923eb-9880-4b47-9965-ebf93ae15487}

Text

HomePObox

None defined.

None defined (Text)

IMAddress

{4CBD96F7-09C6-4b5e-AD42-1CBE123DE63A}

Text

Initials

{7A282F86-69D9-40ff-AE1C-C746CF21256B}

Text

ISDNNumber

{A579062A-6C1D-4ad3-9D5E-035F9F2C1882}

Text

JobTitle

{c4e0f350-52cc-4ede-904c-dd71a3d11f7d}

Text

Language

{D81529E8-384C-4ca6-9C43-C86A256E6A44}

Choice

LastNamePhonetic

{fdc8216d-dabf-441d-8ac0-f6c626fbdc24}

Text

Location

{288F5F32-8462-4175-8F09-DD7BA29359A9}

Text

ManagersName

{BA934502-D68D-4960-A54B-51E15FEF5FD3}

Text

MiddleName

{418C8D29-6F2E-44c3-8955-2CD7EC3E2151}

Text

Mileage

{3126C2F1-063E-4892-828F-0696EC6E105F}

Text

NameTitle

None defined.

None defined (Text)

Nickname

{6B0A2CD7-A7F9-41ca-B932-F3BEBB603793}

Text

Office<35>

{26169AB2-4BD2-4870-B077-10F49C8A5822}

Text

ol_Department

{C814B2CF-84C6-4f56-B4A4-C766938A97C5}

Text

OrganizationalIDNumber

{0850AE15-19DD-431f-9C2F-3AFF3AE292CE}

Text

OtherAddressCity

{90FA9A8E-AAC0-4828-9CB4-78F98416AFFA}

Text

OtherAddressCountry

{3C0E9E00-8FCC-479f-9D8D-3447CDA34C5B}

Text.

OtherAddressPostalCode

{0557C3F8-60C4-4dfb-B5BA-BF3C4E4386B1}

Text

OtherAddressPObox

None defined.

None defined (Text)

OtherAddressStateOrProvince

{F45883BC-8733-4b77-AB5D-43613986AA12}

Text

OtherAddressStreet

{DFF5DFC2-E2B7-4a19-BDE7-76DABC90A3D2}

Text

OtherFaxNumber

{AAD15EB6-D7FD-47b8-ABD4-ADC0FE33A6BA}

Text

OtherFreeForm

None defined.

None defined (Text)

OtherNumber

{96E02495-F428-48bc-9F13-06D98BA58C34}

Text

PagerNumber

{F79BF074-DAF7-4c06-A314-15B287FDF4C9}

Text

PersonalWebsite

{5AA071D9-3254-40fb-82DF-5CEDEFF0C41E}

URL

Photo

{1020C8A0-837A-4f1b-BAA1-E35AFF6DA169}

URL

PrimaryNumber

{D69BCC0E-57C3-4f3b-BBC5-B090EDF21F0F}

Text

PostAddrID

None defined.

None defined (Text)

Profession

{F0753A13-44B1-4269-82AF-5C34C57B0C67}

Text

RadioNumber

{D1AEDE4F-1352-48d9-81E2-B10097C359C1}

Text

ReferredBy

{9B4CC5A9-1119-43e4-B2A8-412C4031F92B}

Text

SpouseName

{F590B1DE-8E28-4c17-91BC-BF4096024B7E}

Text

Suffix

{D886EBA3-D018-4103-A322-D5780127EF8A}

Text

TelexNumber

{E7BE7F3C-C436-481d-8865-669E5146F53C}

Text

Title

{fa564e0f-0c70-4ab9-b863-0177e6ddd247}

Text

TTYTDDNumber

{F54697F1-0357-4c5a-A711-0CB654BC73E4}

Text

UserField1

{566656F5-17B3-4291-98A5-5074AADF77B3}

Text

UserField2

{182D1B9E-1718-4e11-B279-38F7ED0A20D6}

Text

UserField3

{A03EB53E-F123-4af9-9355-F92BD75C00B3}

Text

UserField4

{ADEFA4CA-14C3-4694-B531-F51B706EFE9D}

Text

WebPage

{a71affd2-dcc7-4529-81bc-2fe593154a5f}

URL

WorkAddress

{fc2e188e-ba91-48c9-9dd3-16431afddd50}

Note

WorkCity

{6ca7bd7f-b490-402e-af1b-2813cf087b1e}

Text

WorkCountry

{3f3a5c85-9d5a-4663-b925-8b68a678ea3a}

Text

WorkFax

{9d1cacc8-f452-4bc1-a751-050595ad96e1}

Text

WorkFreeForm

None defined.

None defined (Text)

WorkPhone

{fd630629-c165-4513-b43c-fdb16b86a14d}

Text

WorkPObox

None defined.

None defined (Text)

WorkState

{ceac61d3-dda9-468b-b276-f4a6bb93f14f}

Text

WorkZip

{9a631556-3dac-49db-8d2f-fb033b0fdc24}

Text

Account: Any kind of text string that is about an account.

Anniversary: The date of the contact's wedding or anniversary.

AssistantNumber: Assistant’s phone number.

AssistantsName: Assistant’s name.

AttachProps: Information about an attachment that is specified as the AttachProps (section 2.2.4.1) complex type.

BCPicture: This helps a protocol client to display information about a contact. See PidLidBusinessCardCardPicture in [MS-OXOCNTC], section 2.2.1.7.2. Clients can pass this through as text instead of processing it.

BillingInformation: A string in any kind of format that describes billing information.

Birthday: Date of birth.

BizCard: This helps a protocol client to display information about a contact. See PidLidBusinessCardDisplayDefinition in [MS-OXOCNTC], section 2.2.1.7.1. Clients can pass this through as text instead of processing it.

Business2Number: Second work phone number.

CallbackNumber: Phone number used to return calls.

CarNumber: Car phone number.

CellPhone: Cellular phone number.

Certificate: This helps a protocol client to send secure e-mail. See PidTagUserX509Certificate in [MS-OXOCNTC], section 2.2.1.10.23. Clients can pass this through as text instead of processing it.

CertificateStr: The name of, or a string describing, the contents of either Certificate or CertificatesX509.

CertificatesX509: This helps a protocol client to send secure e-mail. See PidTagUserX509Certificate in [MS-OXOCNTC] section 2.2.1.10.23. Clients can pass this through as text instead of processing it.

ChildrensNames: A delimited string containing the contact's children's names.

Comments: Any text the user wants to enter about the item.

Company: Company or business name.

CompanyNumber: Company or business phone number.

CompanyPhonetic: Yomigana for the company name.

ComputerNetworkName: Computer network name.

ConfDefServerIndex: The index of the default protocol server to use from the list contained in the ConfServerNames property. The first entry is index 0. -1 or an item without this property indicates no default protocol server has been set.

ConfServerNames: Delimited string of server names. These server names are usually for servers that handle meetings between groups of people over a network.

ContactLinkName: Delimited string of names of contacts that are relevant to this contact.

CustomerID: Any string that identifies the contact as a customer.

Editor: The last person to change this item.

Email: Primary e-mail address.

Email2: Second e-mail address.

Email3: Third e-mail address.

EmailDisplayAs1: The string that the user interface SHOULD display instead of the e-mail address in the Email field when users send mail to this contact.

EmailDisplayAs2: The string that the user interface SHOULD display instead of the e-mail address in the Email2 field when users send mail to this contact.

EmailDisplayAs3: The string that the user interface SHOULD display instead of the e-mail address in the Email3 field when users send mail to this contact.

Fax1: Primary fax number.

Fax2: Second fax number.

Fax3: Third fax number.

FaxDisplayAs1: The string that the user interface SHOULD display instead of the fax number in the Fax1 field when a user sends a fax to this contact.

FaxDisplayAs2: The string that the user interface SHOULD display instead of the fax number in the Fax2 field when a user sends a fax to this contact.

FaxDisplayAs3: The string that the user interface SHOULD display instead of the fax number in the Fax3 field when a user sends a fax to this contact.

FileAs: The string that the user interface SHOULD display as the name of this contact.

FirstName: The first name of the contact.

FirstNamePhonetic: Yomigana for the first name.

FreeBusyURL: A URL to a location where clients can retrieve information about when the contact is busy. See PidLidFreeBusyLocation in [MS-OXOCNTC], section 2.2.1.10.10.

FTPSite: A URL to a File Transfer Protocol (FTP) site.

FullName: The full name of the contact.

Gender: The contact's gender. If this field is an integer type, clients SHOULD interpret it as a Gender. If this field is a Choice type, the MAPPINGS element SHOULD be present<36> and clients MUST use the MAPPINGS element to convert to and from the Gender type. See [MS-LISTSWS] on fields that are of the Choice type. Each MAPPING element within the MAPPINGS element holds a number and a string.

 <s:element name="CHOICES">
    <s:sequence>
       <s:element name="CHOICE" type="string" minOccurs="0" maxOccurs="unbounded" />
    </s:sequence>
 </s:element>

CHOICES: Defines a list of valid values for the field that contains the CHOICE element.

CHOICES.CHOICE: A valid string for this property.

 <s:element name="MAPPINGS">
    <s:sequence>
       <s:element name="MAPPING" type="string" minOccurs="0" maxOccurs="unbounded">
          <s:complexType>
             <s:simpleContent>
                <s:extension base="string">
                   <s:attribute name="Value" type="integer" use="required" />
                </s:extension>
             </s:simpleContent>
          </s:complexType>
       </s:element>
    </s:sequence>
 </s:element>

MAPPINGS.MAPPING and MAPPINGS.Value: If a string in a CHOICE element exactly matches a string in a MAPPING element, the MAPPING.Value attribute associated with it can be used to represent the string. This allows protocol clients to go between protocol servers running different languages and have the protocol servers tell protocol clients how to translate.

The following is an example of a field definition for the Gender field:

 <Field ID="{a8eb573e-9e11-481a-a8c9-1104a54b2fbd}" Type="Choice" Name="Gender">
    <CHOICES>
       <CHOICE>Unknown</CHOICE>
       <CHOICE>Female</CHOICE>
       <CHOICE>Male</CHOICE>
    </CHOICES>
    <MAPPINGS>
       <MAPPING Value="0">Unknown</MAPPING>
       <MAPPING Value="1">Female</MAPPING>
       <MAPPING Value="2">Male</MAPPING>
    </MAPPINGS>
    <Default>Unknown</Default>
 </Field>

In this example, the integer 2 is equivalent to the text string "Male". Protocol clients can store the Gender as a string, but SHOULD store it as an integer if the string matches a MAPPING value.

GovernmentIDNumber: Any string that describes the contact's identification number with the government.

Hobbies: A string describing the contact's hobbies.

Home2Number: Second home phone number.

HomeAddress: Home address.

HomeAddressCity: Home city name.

HomeAddressCountry: Home country or region name.

HomeAddressPostalCode: Post office box number in the home address.

HomeAddressStateOrProvince: The name of the state in the home address.

HomeFaxNumber: Home fax number.

HomeFreeForm: Any string that describes the contact's home address.

HomePhone: Home phone number.

HomeZip: The zip code or postal code in the home address.

IMAddress: Instant messaging address or name.

Initials: The initials of the contact's name.

ISDNNumber: A phone number used for Internet services.

JobTitle: The contact's job title.

Language: Any text that describes the contact's language.

LastNamePhonetic: Yomigana for the last name.

Location: Any string describing a location.

ManagersName: The name of the contact's manager.

MiddleName: The contact's middle name.

Mileage: Any user-entered text representing some mileage information associated with the contact for purposes of reimbursement.

NameTitle: A title associated with a name. This title comes before the name. Examples include "Mr.", "Mrs.", "Captain", "President", and so on. Use Suffix for titles that come after names.

Nickname: The contact's nickname.

OfficeLocation: Any string describing the location of the contact's office.

ol_Department: Any string describing the contact's work or business department.

OrganizationalIDNumber: Any string describing the contact's organizational identifier number.

OtherAddressCity: A city name for the contact's general purpose address.

OtherAddressCountry: A country or region name for the contact's general purpose address.

OtherAddressPostalCode: A postal code for the contact's general purpose address.

OtherAddressPObox: A post office box number for the contact's general purpose address.

OtherAddressStateOrProvince: A state or province name for the contact's general purpose address.

OtherAddressStreet: A street name for the contact's general purpose address.

OtherFaxNumber: General purpose fax number.

OtherFreeForm: Any text that describes the contact's general purpose address.

OtherNumber: Any phone number associated with the contact.

PagerNumber: A pager number.

PersonalWebsite: The contact's personal Web site.

Photo: A URL to the contact's picture. Pictures SHOULD be stored as some kind of image file. There is no guarantee that this URL points to safe data. The value of Photo SHOULD be a URL to one of the item's attachments, but can be any URL. Protocol clients can use Photo to find the contact's picture, but AttachProps SHOULD be used instead.

PrimaryNumber: The contact's primary phone number.

PostAddrID: Any string describing a postal address identifier.

Profession: Any string describing a profession.

RadioNumber: A phone number for a radio phone.

ReferredBy: Any string describing who or what referred this contact.

SpouseName: The name of the contact's spouse or domestic partner.

Suffix: A suffix or any other text. Some examples include "Jr.", "Sr.", "III", as in "Guy Example Jr."

TelexNumber: The phone number of a telex printer.

Title: Any string describing the contact's title.

TTYTDDNumber: The phone number of a telephone device for the deaf (TDD).

UserField1: This can be used for any text data about the contact.

UserField2: This can be used for any text data about the contact.

UserField3: This can be used for any text data about the contact.

UserField4: This can be used for any text data about the contact.

WebPage: A URL to a Web page for the contact.

WorkAddress: The street address where the contact works.

WorkCity: The name of the city where the contact works.

WorkCountry: The name of the country or region where the contact works.

WorkFax: The fax number at the contact's workplace.

WorkFreeForm: Any string describing the location of the contact's workplace.

WorkPhone: The phone number of the contact's work phone.

WorkPObox: The post office box number in the contact's work address.

WorkState: The name of the state where the contact works.

WorkZip: The zip code or postal code of the contact's workplace.