Versions Compared

Old Version 2

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

Saved on

compared with

New Version Current

changes.mady.by.user Robert Mühsig

Saved on

Key

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

Häufig werden Kontaktdaten von Drittsystemen übergeben, was in einigen Fällen ein Kontaktmapping erfordert.

NOTE

Es gibt zwei verschiedene Arten von Kontakt-Mapping:

...

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>

Für diese Mapping-Arten müssen verschiedene Bezeichnungen für die Kontakt-Zielfelder verwendet werden.

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

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

...