XML contact 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:
<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 requirePerson_LastName
orPerson_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 requireAdditionalPerson_LastName
orAdditionalPerson_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
(ValueBusiness
orPrivate
)Options_AddressingType
(ValueTo
,Cc
orBcc
)Options_PersonOverFirm
(Valuetrue
orfalse
)Options_CountryView
(Valuetrue
orfalse
)Options_CountryCodeView
(Valuetrue
orfalse
)Options_SalutationView
(Valuetrue
orfalse
)Options_SalutationSeparatetLine
(Valuetrue
orfalse
)Options_SecondNameView
(Valuetrue
orfalse
)Options_PositionView
(Valuetrue
orfalse
)Options_InterneAddress
(Valuetrue
orfalse
)
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 prefixDynamic.
is added in each case. Below are some examples).ExtendedField_Field1
(creates ExtendedFieldDynamic.Field1
)ExtendedField_CustomerNumber
(creates ExtendedFieldDynamic.CustomerNumber
)ExtendedField_MaritalStatus
(creates ExtendedFieldDynamic.MaritalStatus
)
PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland