XML contact mapping

Owned by Dinah Bolli
Last updated: Dec 06, 2023 by Robert Mühsig
2 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:

XML contact mapping (documented on this page)
XML contact mapping configuration have about this form:

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

Default contact mapping (Link)
Standard contact mapping configurations have approximately this form:

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

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

Address providers that use the XML contact mapping:

Configuration

mit Erklärungen

<ContactMapping> <!-- Standard-Einstellung, jeweils für entsprechenden Adressprovider aus der Dokumentation entnehmen --> <ContactItemXPath>Contact</ContactItemXPath> <!-- Mapping von Adressproviderdatum mit Key "PERSON_LASTNAME" (mögliche Keys: siehe Dokumentation vom entsprechenden Adressprovider) --> <ContactElement id="Person_LastName">PERSON_LASTNAME</ContactElement> <!-- Mapping von definiertem Wert "FESTER WERT" --> <ContactElement id="Person_Title">"FESTER WERT"</ContactElement> <!-- Mapping von Adressproviderdatum mit Key "STREET", aber nur, wenn das Adressproviderdatum mit Key "TYPE" den Inhalt "Interne Adresse" hat --> <ContactElement id="Company_Street" when="TYPE = 'Interne Adresse'">STREET</ContactElement> </ContactMapping>

ohne Erklärungen

All possible contact target fields are listed below.

  • Person
    (All person target fields require Person_LastName or Person_FirstName.)

    • Person_LastName

    • Person_FirstName

    • Person_Title

    • Person_SecondName

    • Person_NickName

    • Person_Initials

    • Person_Profession

    • Person_Position

    • Person_SalutationShort

    • Person_Salutation

    • Person_Greeting

    • Address

      • Person_Street

      • Person_CareOf

      • Person_Apartment

      • Person_Floor

      • Person_City

      • Person_ZipCode

      • Person_PostOfficeBox

      • Person_PostOfficeBoxCity

      • Person_PostOfficeBoxCityZipCode

      • Person_Country

      • Person_CountryShortCode

    • Communication

      • Person_Language

      • Person_Phone

      • Person_Email

      • Person_Fax

      • Person_Mobile

      • Person_Homepage

  • AdditionalPerson
    (All additional person target fields require AdditionalPerson_LastName or AdditionalPerson_FirstName.)

    • AdditionalPerson_LastName

    • AdditionalPerson_FirstName

    • AdditionalPerson_Title

    • AdditionalPerson_SecondName

    • AdditionalPerson_NickName

    • AdditionalPerson_Initials

    • AdditionalPerson_Profession

    • AdditionalPerson_Position

    • AdditionalPerson_SalutationShort

    • AdditionalPerson_Salutation

    • AdditionalPerson_Greeting

  • Company

    • Company_Name

    • Company_Supplement

    • Company_Department

    • Address

      • Company_Street

      • Company_CareOf

      • Company_Apartment

      • Company_Floor

      • Company_City

      • Company_ZipCode

      • Company_PostOfficeBox

      • Company_PostOfficeBoxCity

      • Company_PostOfficeBoxCityZipCode

      • Company_Country

      • Company_CountryShortCode

    • Communication

      • Company_Language

      • Company_Mobile

      • Company_Homepage

      • Company_PhoneDirect

      • Company_PhoneCentral

      • Company_EmailDirect

      • Company_EmailCentral

      • Company_FaxDirect

      • Company_FaxCentral

  • Options

    • Options_SelectedAddress (Value Business or Private)

    • Options_AddressingType (Value To, Cc or Bcc)

    • Options_PersonOverFirm (Value true or false)

    • Options_CountryView (Value true or false)

    • Options_CountryCodeView (Value true or false)

    • Options_SalutationView (Value true or false)

    • Options_SalutationSeparatetLine (Value true or false)

    • Options_SecondNameView (Value true or false)

    • Options_PositionView (Value true or false)

    • Options_InterneAddress (Value true or false)

  • Provider

    • Provider_ID

    • Provider_Name

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

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

    • Provider_AddressLabel

    • Provider_URL

  • ExtendedField
    (The names of ExtendedFields can be chosen freely, the prefix Dynamic. is added in each case. Below are some examples).

    • ExtendedField_Field1 (creates ExtendedField Dynamic.Field1)

    • ExtendedField_CustomerNumber (creates ExtendedField Dynamic.CustomerNumber)

    • ExtendedField_MaritalStatus (creates ExtendedField Dynamic.MaritalStatus)

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland