Version: Classic

XML contact mapping

Configuration

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

note

NOTE There are two different types of contact mapping: XML contact mapping (documented on this page)
XML contact mapping configuration have about this form:

Contact lastNameSource ```xml **Default contact mapping** ([Link](./default-contact-mapping)) Standard contact mapping configurations have approximately this form: - ``` ``` 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

<ContactMapping>
  <ContactItemXPath>Contact</ContactItemXPath>
  <ContactElement id="Person_PostOfficeBoxCityZipCode">PERSON_ZIPCODE</ContactElement>
  <ContactElement id="Person_PostOfficeBoxCityZipCode">"FESTER WERT"</ContactElement>
  <ContactElement id="Company_Street" when="TYPE = 'Interne Adresse'">STREET</ContactElement>
</ContactMapping>

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)

Configuration​

Configuration