Versions Compared

Old Version 3

changes.mady.by.user Dinah Bolli (Unlicensed)

Saved on

compared with

New Version 4

changes.mady.by.user Dinah Bolli (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

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:

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

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

  • Code Block
    <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

Code Block
languagexml
<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

Code Block
languagexml
<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

  • 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)

NOTE
The AdditionalPerson cannot be mapped to with this.