UserDefinedAddressProvider

Mit dem UserDefinedAddressProvider können Benutzer ihre persönlichen, lokalen Empfängerlisten im Empfängerdialog konfigurieren. Die Datenquellen exisiteren nur für den Benutzer und werden lokal im OneOffixx-Appdata Verzeichnis gespeichert. Unterstützt werden die folgenden Dateitypen:

  • xls
  • xlsx
  • csv (mit ; als Trennzeichen)

Beispielkonfiguration

<!-- User defined AddressProvider -->
<AddressProvider id="5f4865d3-9d7e-47bd-846d-546f7f7dd0ad" order="7" active="true">
  <ContactFields>
    <ContactElement id="Company_Name" />
    <ContactElement id="Company_Supplement" />
    <ContactElement id="Company_Department" />
    <ContactElement id="Company_Street" />
    <ContactElement id="Company_City" />
    <ContactElement id="Company_ZipCode" />
    <ContactElement id="Company_PostOfficeBox" />
    <ContactElement id="Company_PostOfficeBoxCity" />
    <ContactElement id="Company_CountryShortCode" />
    <!-- If Country ShortCode is mapped, Country is ignored and mapped according to the provided code. -->
    <ContactElement id="Company_Country" />
    <ContactElement id="Company_PhoneDirect" />
    <ContactElement id="Company_PhoneCentral" />
    <ContactElement id="Company_EmailDirect" />
    <ContactElement id="Company_EmailCentral" />
    <ContactElement id="Company_FaxDirect" />
    <ContactElement id="Company_FaxCentral" />
    <ContactElement id="Company_Mobile" />
    <ContactElement id="Company_Homepage" />
    <ContactElement id="Greeting" />
    <ContactElement id="Language" />
    <ContactElement id="Person_Title" />
    <ContactElement id="Person_LastName" />
    <ContactElement id="Person_FirstName" />
    <ContactElement id="Person_SecondName" />
    <ContactElement id="Person_NickName" />
    <ContactElement id="Person_BirthDate" />
    <ContactElement id="Person_Profession" />
    <ContactElement id="Person_Position" />
    <ContactElement id="Person_Street" />
    <ContactElement id="Person_City" />
    <ContactElement id="Person_ZipCode" />
    <ContactElement id="Person_PostOfficeBox" />
    <ContactElement id="Person_PostOfficeBoxCity" />
    <ContactElement id="Person_CountryShortCode" />
    <!-- If Country ShortCode is mapped, Country is ignored and mapped according to the provided code. -->
    <ContactElement id="Person_Country" />
    <ContactElement id="Person_Phone" />
    <ContactElement id="Person_Email" />
    <ContactElement id="Person_Fax" />
    <ContactElement id="Person_Mobile" />
    <ContactElement id="Person_Homepage" />
    <ContactElement id="SalutationShort" />
    <ContactElement id="Salutation" />
    <!--<ContactElement id="Provider_ID" />
    <ContactElement id="Provider_Name" />
    <ContactElement id="Provider_Updated" />
    <ContactElement id="Provider_Published" />
    <ContactElement id="Provider_AddressLabel" />
    <ContactElement id="Provider_URL" isText="true" />
    
    Is Legacy and has been Replaced with UserDefinedField in version 3.7.1 (still works for compatibility uses but is not supposed to be used anymore)
    <ContactElement id="ID" /> -->

    <ContactElement id="UserDefinedField" />
    <ContactElement id="ExtendedField_Field1" />
    <ContactElement id="ExtendedField_BriefInhalt" />
  </ContactFields>
</AddressProvider>

Jedes der in der Konfiguration aufgeführte ContactElement kann mit einer Spalte in der ausgewählten Datei verbunden werden. Details zum ContactMapping siehe XML-Kontakt-Mapping.

Suchfelder

Im UserDefinedAddressProvider stehen die folgenden Suchfelder zur Verfügung:

Empfängerdialog: UserDefinedAddressProvder Suchfelder

Die Suchfelder können nicht bearbeitet werden und sind statisch. Ausnahme: Suchfeld Benutzerdefiniert übernimmt als Label den Spaltennamen aus der Zuweisung.

Die im Suchfeld eingegebenen Werte werden in den Spalten gesucht, welche den ContactElements zugeordnet sind. Die Suchfelder werden erst aktiv, wenn den entsprechenden ContactElements eine Spalte aus der Datei zugeordnet ist.

Zuordnung Suchfeld → ContactElement:

  • Firma → Company_Name
  • Vorname → Person_FirstName
  • Name → Person_LastName
  • Strasse → Person_Street, Company_Street
  • PLZ → Person_ZipCode, Company_ZipCode
  • Ort → Person_City, Company_City
  • Land → Person_Country, Person_CountryShortCode, Company_Country, Company_CountryShortCode
  • Benutzerdefiniert → UserDefinedField, ID ID ist Legacy und sollte ab Version 3.7.1 nicht mehr verwendet werden - existiert nur aus Gründen der Rückwärtskompatibilität.

Verwendung von ExtendedFields

Der UserDefinedAddressProvider unterstützt die sogenannten ExtendedFields. Sie können der Konfiguration als <ContactElement id="ExtendedField_Bezeichnung" /> hinzugefügt werden und stehen dann in der Mapping-Konfiguration zur Verfügung. ExtendedFields können z. B. für variable Texte in Serienbriefen oder zur Übergabe eines Feldes, das nicht standardmässig im Empfängerdialog zur Verfügung steht (z. B. der Beziehungsstatus einer Person) verwendet werden. Details siehe XML-Kontakt-Mapping.

Konfiguration im Empfängerdialog

Über das Zahnradsymbol in der Eingabemaske kann die ausgewählte Datenquelle bearbeitet werden. Ist die Datenquelle [Neu] ausgewählt, wird eine neue Konfiguration erstellt.

Empfängerdialog: UserDefinedAddressProvder Konfiguation

Optionen

  • Name: Name der Konfiguration
  • Datei: Zu verwendende Datei. Die Datei kann entweder über die Schaltfläche mit Auswahl im Windows Explorer, oder durch Eingabe des Pfades direkt im Textfeld (unterstützt Umgebungsvariablen wie z. B. %APPDATA% oder %USERPROFILE%) ausgewählt werden.
  • Überschriften: Definiert ob die Datei Spaltentitel enthält oder nicht.
  • Mapping: Konfiguration für die Datenzuweisung Datei → Empfänger. In der Spalte "Feld" sind alle ContactElements aufgeführt die in der AddressProvider-Konfiguration definiert sind. In der Spalte "Spalte" kann pro Feld eine Spalte aus der eingelesenen Datei ausgewählt werden.