Default contact mapping

Owned by Dinah Bolli (Unlicensed)
Last updated: Jan 15, 2024
1 min read

Contact data is often transferred from third-party systems, which in some cases requires contact mapping.

NOTE

There are two different types of contact mapping:

Default contact mapping (documented on this page)
Standard contact mapping configurations have approximately this form:

  • <Mapping> <Map Source="lastNameSource" Target="Person_LastName" /> </Mapping>

XML contact mapping (XML contact mapping)
XML contact mapping configuration have about this form:

  • <ContactMapping> <ContactItemXPath>Contact</ContactItemXPath> <ContactElement id="Person_LastName">lastNameSource</ContactElement> </ContactMapping>

For these mapping types, different names must be used for the contact target fields.

Address providers, which use the default contact mapping:

The mapping functionality behind the default contact mapping is documented in Mapping.

All possible contact target fields are listed below.

  • Person

    • Person_LastName

    • Person_FirstName

    • Person_Title

    • Person_SecondName

    • Person_NickName

    • Person_Initials

    • Person_Birthday (Date, e.g. 2023-01-24)

    • Person_Profession

    • Person_Position

    • Person_SalutationShort

    • Person_Salutation

    • Person_Greeting

    • Person_Picture (Base64 encoded image)

    • Address

      • Person_Street

      • Person_CareOf

      • Person_Apartment

      • Person_Floor

      • Person_City

      • Person_ZipCode

      • Person_PostOfficeBox

      • Person_PostOfficeBoxCity

      • Person_PostOfficeBoxCity_ZipCode

      • Person_Country

      • Person_CountryShortCode

    • Communication

      • Person_Language

      • Person_Mobile

      • Person_Homepage

      • Person_PhoneDirect

      • Person_EmailDirect

      • Person_FaxDirect

  • AdditionalPerson

    • AdditionalPerson_LastName

    • AdditionalPerson_FirstName

    • AdditionalPerson_Title

    • AdditionalPerson_SecondName

    • AdditionalPerson_NickName

    • AdditionalPerson_Initials

    • AdditionalPerson_Birthday (Date, e.g. 2023-01-24)

    • AdditionalPerson_Profession

    • AdditionalPerson_Position

    • AdditionalPerson_SalutationShort

    • AdditionalPerson_Salutation

    • AdditionalPerson_Greeting

    • AdditionalPerson_Picture (Base64 encoded image)

  • Company

    • Company_Name

    • Company_Supplement

    • Company_Department

    • Company_Picture (Base64 encoded image)

    • Address

      • Company_Street

      • Company_CareOf

      • Company_Apartment

      • Company_Floor

      • Company_City

      • Company_ZipCode

      • Company_PostOfficeBox

      • Company_PostOfficeBoxCity

      • Company_PostOfficeBoxCity_ZipCode

      • Company_Country

      • Company_CountryShortCode

    • Communication

      • Company_Language

      • Company_Mobile

      • Company_Homepage

      • Company_PhoneDirect

      • Company_PhoneCentral

      • Company_EmailDirect

      • Company_EmailCentral

      • Company_FaxDirect

      • Company_FaxCentral

  • Option

    • AddressType (Value CompanyAndPersonData, CompanyData or PersonData)

    • AddressTypeOption (Value Business or Private)

    • AddressingType (Value To, Cc or Bcc)

    • PersonOverFirm (Value true or false)

    • CountryView (Value true or false)

    • CountryCodeView (Value true or false)

    • CapitalizedCity (Value true or false)

    • CompanyView (Value true or false)

    • SalutationView (Value true or false)

    • SalutationSeparateLine (Value true or false)

    • SecondNameView (Value true or false)

    • PositionView (Value true or false)

    • InterneAddress (Value true or false)

    • ShowProviderLayout (Valuetrue or false)

  • AddressProviderData

    • AddressProviderData_Id

    • AddressProviderData_Name

    • AddressProviderData_Updated (Date, e.g. 2023-01-24)

    • AddressProviderData_Published (Date, e.g. 2023-01-24)

    • AddressProviderData_Label_Type (Value text or html)

    • AddressProviderData_Label_FormattedString

    • AddressProviderData_Label_ParseAddressData (Value true or false)

    • AddressProviderData_ProviderResponse

    • AddressProviderData_Link_Type (Value VCard or WebPage)

    • AddressProviderData_Link_Href

  • ExtendedField
    The names of ExtendedFields can be chosen freely. Below are some examples:

    • ExtendedField_Field1 (creates ExtendedField Field1)

    • ExtendedField_CustomerNumber (creates ExtendedField CustomerNumber)

    • ExtendedField_MaritalStatus (creates ExtendedField MaritalStatus)

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland