XML-Kontakt-Mapping

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

HINWEIS

Es gibt zwei verschiedene Arten von Kontakt-Mapping:

Das XML-Kontakt-Mapping (auf dieser Seite dokumentiert)
XML-Kontakt-Mapping-Konfiguration haben etwa diese Form:

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

Das Standard-Kontakt-Mapping (Link)
Standard-Kontakt-Mapping-Konfigurationen haben etwa diese Form:

<Mapping>
  <Map Source="lastNameSource" Target="Person_LastName" />
</Mapping>

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

Adressprovider, welche das XML-Kontakt-Mapping verwenden:

Konfiguration

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>

Nachfolgend sind alle möglichen Kontakt-Zielfelder aufgelistet.

Person
(Alle Personen-Zielfelder benötigen Person_LastName oder 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 (Wert Business oder Private)
- Options_AddressingType (Wert An, Cc oder Bcc)
- Options_PersonOverFirm (Wert true oder false)
- Options_CountryView (Wert true oder false)
- Options_CountryCodeView (Wert true oder false)
- Options_SalutationView (Wert true oder false)
- Options_SalutationSeparatetLine (Wert true oder false)
- Options_SecondNameView (Wert true oder false)
- Options_PositionView (Wert true oder false)
- Options_InterneAddress (Wert true oder false)
Provider
- Provider_ID
- Provider_Name
- Provider_Updated (Datum, z. B. 2023-01-24)
- Provider_Published (Datum, z. B. 2023-01-24)
- Provider_AddressLabel
- Provider_URL
ExtendedField
(Die Namen von ExtendedFields können frei gewählt werden, es wird jeweils der Prefix Dynamic. hinzugefügt. Nachfolgend sind einige Beispiele aufgeführt.)
- ExtendedField_Field1 (erzeugt ExtendedField Dynamic.Field1)
- ExtendedField_CustomerNumber (erzeugt ExtendedField Dynamic.CustomerNumber)
- ExtendedField_MaritalStatus (erzeugt ExtendedField Dynamic.MaritalStatus)

Auf die AdditionalPerson kann hiermit nicht gemappt werden.