Skip to content

ContactList#

Defaults#

Commented File-structure#

contactList.xml
<!-- List of local contacts
      type: list -->
<contactList version="1.34.0">
  <!-- a contact list entry -->
  <contact>
    <!-- The display name for the contact.
          type: string -->
    <displayName></displayName>
    <!-- The given name for the contact.
          type: string -->
    <givenName></givenName>
    <!-- The middle name for the contact.
          type: string -->
    <middleName></middleName>
    <!-- The family name for the contact.
          type: string -->
    <familyName></familyName>
    <!-- The nick name for the contact.
          type: string -->
    <nickName></nickName>
    <!-- The contact's honorific prefix, e.g. "Sir"
          type: string -->
    <namePrefix></namePrefix>
    <!-- The contact's honorific suffix, e.g. "Jr"
          type: string -->
    <nameSuffix></nameSuffix>
    <!-- The phonetic version of the given name for the contact.
          type: string -->
    <phoneticGivenName></phoneticGivenName>
    <!-- The phonetic version of the middle name for the contact.
          type: string -->
    <phoneticMiddleName></phoneticMiddleName>
    <!-- The phonetic version of the family name for the contact.
          type: string -->
    <phoneticFamilyName></phoneticFamilyName>
    <!-- The contact ist starred, if it is a favorite contact (values 0 or 1)
          type: string -->
    <starred></starred>
    <!-- The custome ringtone of the contact
          type: string -->
    <ringtone></ringtone>
    <!-- contact photo as base64 string
          type: string -->
    <photo></photo>
    <!-- List of phone numbers.
          type: list -->
    <phoneNumberList>
      <!-- a phone number entry -->
      <phoneNumber>
        <!-- The number is the primary number (values 0 or 1)
              type: string -->
        <isPrimary></isPrimary>
        <!-- Type of Number (like home, work, mobile, fax, etc)
              type: string -->
        <detailType></detailType>
        <!-- The phone number as the user entered it.
              type: string -->
        <number></number>
      </phoneNumber>
    </phoneNumberList>
    <!-- List of e-mail addresses.
          type: list -->
    <emailAddressList>
      <!-- an e-mail address entry -->
      <emailAddress>
        <!-- Type of e-mail address (like home, work, other, mobile, etc)
              type: string -->
        <detailType></detailType>
        <!-- The e-mail address as the user entered it.
              type: string -->
        <address></address>
      </emailAddress>
    </emailAddressList>
    <!-- List of postal addresses.
          type: list -->
    <postalAddressList>
      <!-- a postal address entry -->
      <postalAddress>
        <!-- Type of postal address (like home, work, other, etc)
              type: string -->
        <detailType></detailType>
        <!-- Can be street, avenue, road, etc. This element also includes
              the house number and room/apartment/flat/floor number.
              type: string -->
        <street></street>
        <!-- Postal code. Usually country-wide, but sometimes specific to
              the city (e.g. "2" in "Dublin 2, Ireland" addresses).
              type: string -->
        <postcode></postcode>
        <!-- A state, province, county (in Ireland), Bundesland (in
              Germany), departement (in France), etc.
              type: string -->
        <region></region>
        <!-- Can be city, village, town, borough, etc. This is the postal
              town and not necessarily the place of residence or place of
              business.
              type: string -->
        <city></city>
        <!-- The name or code of the country.
              type: string -->
        <country></country>
        <!-- This is used to disambiguate a street address when a city
              contains more than one street with the same name, or to
              specify a small place whose mail is routed through a larger
              postal town. In China it could be a county or a minor city.
              type: string -->
        <neighborhood></neighborhood>
        <!-- Covers actual P.O. boxes, drawers, locked bags, etc. This
              is usually but not always mutually exclusive with street.
              type: string -->
        <pobox></pobox>
      </postalAddress>
    </postalAddressList>
    <!-- List of organizations.
          type: list -->
    <organizationList>
      <!-- a organization entry -->
      <organization>
        <!-- The company as the user entered it.
              type: string -->
        <company></company>
        <!-- The position title at this company as the user entered it.
              type: string -->
        <title></title>
        <!-- The department at this company as the user entered it.
              type: string -->
        <department></department>
        <!-- The job description at this company as the user entered it.
              type: string -->
        <jobDescription></jobDescription>
      </organization>
    </organizationList>
    <!-- List of unspecified data of the contact.
          type: list -->
    <additionalDataList>
      <!-- an additional unspecified data entry for data that could not be assigned to any other mimetype -->
      <additionalData>
        <!-- type: string -->
        <mimetype></mimetype>
        <!-- type: string -->
        <data1></data1>
        <!-- type: string -->
        <data2></data2>
        <!-- type: string -->
        <data3></data3>
        <!-- type: string -->
        <data4></data4>
        <!-- type: string -->
        <data5></data5>
        <!-- type: string -->
        <data6></data6>
        <!-- type: string -->
        <data7></data7>
        <!-- type: string -->
        <data8></data8>
        <!-- type: string -->
        <data9></data9>
        <!-- type: string -->
        <data10></data10>
        <!-- type: string -->
        <data11></data11>
        <!-- type: string -->
        <data12></data12>
        <!-- type: string -->
        <data13></data13>
        <!-- type: string -->
        <data14></data14>
        <!-- type: string -->
        <data15></data15>
      </additionalData>
    </additionalDataList>
  </contact>
</contactList>