| Table of Contents |
|---|
Häufig werden Kontaktdaten von Drittsystemen übergeben, was in einigen Fällen ein Kontaktmapping erfordert.
HINWEIS
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 |
|---|
...
| ||
<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 | ||
|---|---|---|
| ||
<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_LastNamePerson_FirstNamePerson_TitlePerson_SecondNamePerson_NickNamePerson_InitialsPerson_ProfessionPerson_PositionPerson_SalutationShortPerson_SalutationPerson_GreetingAddress
Person_StreetPerson_CareOfPerson_ApartmentPerson_FloorPerson_CityPerson_ZipCodePerson_PostOfficeBoxPerson_PostOfficeBoxCityPerson_PostOfficeBoxCityZipCodePerson_CountryPerson_CountryShortCode
Communication
Person_LanguagePerson_PhonePerson_EmailPerson_FaxPerson_MobilePerson_Homepage
AdditionalPerson
(All additional person target fields requireAdditionalPerson_LastNameorAdditionalPerson_FirstName.)AdditionalPerson_LastNameAdditionalPerson_FirstNameAdditionalPerson_TitleAdditionalPerson_SecondNameAdditionalPerson_NickNameAdditionalPerson_InitialsAdditionalPerson_ProfessionAdditionalPerson_PositionAdditionalPerson_SalutationShortAdditionalPerson_SalutationAdditionalPerson_Greeting
Company
Company_NameCompany_SupplementCompany_DepartmentAddress
Company_StreetCompany_CareOfCompany_ApartmentCompany_FloorCompany_CityCompany_ZipCodeCompany_PostOfficeBoxCompany_PostOfficeBoxCityCompany_PostOfficeBoxCityZipCodeCompany_CountryCompany_CountryShortCode
Communication
Company_LanguageCompany_MobileCompany_HomepageCompany_PhoneDirectCompany_PhoneCentralCompany_EmailDirectCompany_EmailCentralCompany_FaxDirectCompany_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_IDProvider_NameProvider_Updated(
...
Date,
...
e.
...
g.
2023-01-24)Provider_Published(
...
Date,
...
e.
...
g.
2023-01-24)Provider_AddressLabelProvider_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)
...
HINWEIS
...