Empfängeradresse – XML-Kontakt-Mapping

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

Note

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:

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

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

Auf die AdditionalPerson kann hiermit nicht gemappt werden.