Page Comparison

...

<!-- AddressService -->
<AddressProvider id="E10A8313-A92D-4CB2-A12B-9AEB58F39207" order="1" active="true">
  <!-- serverside Excel/CSV address provider -->
  <AddressProvider id="62C19ADA-826B-4EBC-848D-B32E957D78C6" Title="myCSVFile.csv">
    <SearchParameters>
      <SearchParameter Name="firstName" Label="Vorname/Name" Type="String" Length="100" Sort="1" />
    </SearchParameters>
    <FilePath>myCSVFile.csv</FilePath>
    <Provider Name="CSV"></Provider>
    <Icon></Icon>
    <Mapping>
      <!-- Mapping -->
    </Mapping>
  </AddressProvider>
</AddressProvider>

...

• id 62C19ADA-826B-4EBC-848D-B32E957D78C6

• SearchParameter Liste mit allen Eingabemöglichkeiten.

  • Name Eindeutige Id für den Parameter. Entspricht den Spaltenüberschriften für CSV oder für Excel Dateien in welchen gesucht werden soll.

  • Label Angezeigter Text vor dem Eingabefeld

  • Typ Eingabetyp: String(Text), Long(Zahl), Boolean (Ja/Nein) oder Date (Datum)

  • Length Maximale Länge für Strings

  • Sort Sortierungswert gegenüber den anderen Parametern

• Mapping Mapping auf primedocs Kontaktfelder. Siehe Standard-Kontakt-Mapping.

• Provider Provider, entweder CSV oder EXCEL. Angegeben im Attribut Name.

• Title Der Titel, der dem Benutzer angezeigt wird.

• Icon Base64-Icon, das dem Benutzer im Empfängerdialog angezeigt wird.

...

• id 7E50AA46-A035-4F11-B44F-BBCBAB4780B7

• SearchParameter Liste mit allen Eingabemöglichkeiten

  • Name Eindeutige Id für den Parameter. Entspricht den Named Parameter für den Sql Query

  • Label Angezeigter Text vor dem Eingabefeld

  • Type Eingabetyp: String (Text), Long (Zahl), Boolean (Ja/Nein) oder Date (Datum)

  • Length Maximale Länge für Strings

  • Sort Sortierungswert gegenüber den anderen Parametern

• Mapping Mapping auf primedocs Kontaktfelder, siehe Mapping

• ConnectionString ConnectionString. Kann verschlüsselt sein.

• ConnectionProvider System.Data.Odbc, System.Data.SqlClient, MySql.Data.MySqlClient, Oracle.ManagedDataAccess.Client

• Title Der Titel, der dem Benutzer angezeigt wird.

• Icon Base64-Icon, das dem Benutzer im Empfängerdialog angezeigt wird.

...

• id DC124CDC-C2C0-4379-B9D4-079905E68DEA

• ServiceUser Der Benutzer, mit welchem sich der Provider beim Zefix-Dienst anmeldet.

• ServicePassword Das Passwort, mit dem sich der Provider beim Zefix-Dienst anmeldet: kann verschlüsselt sein.

• Mapping: Optionales Mapping, um die abgefüllten Informationen zu individualisieren, siehe Standard-Kontakt-Mapping. Mappt vom Objekt CompanyFull. Verfügbare Eigenschaften finden Sie unter https://www.zefix.admin.ch/ZefixPublicREST/swagger-ui/index.html .

...

• id 24425bd4-d6f1-4e2c-a323-3cc63fb5f07b

• Title Titel des Address Provider. Default: "Exchange"

• EWSUrl Uri des Exchange-Service-Endpunkts. Für Exchange Online ist dies immer "https://outlook.office365.com/EWS/Exchange.asmx""

• UserName Der Benutzer, mit welchem sich der Provider bei Exchange anmeldet

• Password Das Passwort, mit dem sich der Provider bei Exchange anmeldet (kann verschlüsselt sein)

• AppClientId Die AppClient ID der im AAD konfigurierten EWS-App (Nur Exchange Online)

• TenantId Die TenantId des AAD (Nur Exchange Online)

• Debug true falls zusätzliche Informationen geloggt werden sollen. Geloggt werden die vorhandenen Werte welche für das Mapping verwendet werden können.

• IgnoreSslErrors Ungültige SSL Zertifikate ignorieren oder nicht. Default: false. Nur bei OnPrem Variante teilweise nötig.

• Mapping Optionales Mapping, um die abgefüllten Informationen zu individualisieren.
  Folgende Daten können über das Standard-Kontakt-Mapping abgegriffen werden:

  • DisplayName

  • GivenName

  • Initials

  • CompanyName

  • EmailAddresses

    • Dictionary vom Typ EmailAddressDictionary und Enum EmailAddressKey als Key

  • PhysicalAddresses

    • Dictionary vom Typ PhysicalAddressDictionary und Enum PhysicalAddressKey als Key

  • PhoneNumbers

    • Dictionary vom Typ PhoneNumberDictionary und Enum PhoneNumberKey als Key

  • ContactSource

  • Department

  • JobTitle

  • Manager

  • Surname

  • Alias

  Bestimmte Werte aus den Dictionaries werden für das Mapping bereits extrahiert und als einfache Werte angeboten:

  • PhysicalAddressDictionary[PhysicalAddressKey.Business]

    • City → Contact.Address.City

    • Street → Contact.Address.Street

    • PostalCode → Contact.Address.PostalCode

    • State → Contact.Addess.State

    • CountryOrRegion → Contact.Address.CountryOrRegion

  • PhoneNumberDictionary

    • PhoneNumberKey.BusinessPhone → Contact.Phone.Business

    • PhoneNumberKey.CompanyMainPhone → Contact.Phone.CompanyMainPhone

    • PhoneNumberKey.Mobile → Contact.Phone.Mobile

    • PhoneNumberKey.BusinessFax → Contact.Fax.Business

  • MailBox

    • MailBox.Address → MailBox.Address

    • MailBox.Name → MailBox.Name

• Standard Mapping Das Standard-Mapping welches greift, wenn kein Mapping definiert ist, umfasst folgende Eigenschaften (Feldnamen aus Exchange):

  • GivenName

  • Surname

  • JobTitle

  • Profession

  • MiddleName

  • CompanyName

  • Department

  • BusinessPhone

  • CompanyMainPhone

  • BusinessFax

  • MobilePhone

  • PhysicalAddress.Business

    • City

    • PostalCode

    • Street

  • Mailbox.Address (Primary Email)

...

...

• id 91d36523-bae9-424e-9618-fae6162d20f7

• Title Titel des Address Provider. Default: "SAP C4C"

• EndpointUrl Url des SAP-C4C-Service-Endpunkts.

• UserName Der Benutzer, mit welchem sich der Provider am SAP C4C Service anmeldet

• Password Das Passwort, mit dem sich der Provider am SAP C4C Service anmeldet (kann verschlüsselt sein)

• SearchParameter Liste mit allen Eingabemöglichkeiten

  • Name Eindeutige Id für den Parameter. Entspricht dem Platzhalter in der Odata Query

  • Label Angezeigter Text vor dem Eingabefeld

  • Type Eingabetyp: String (Text), Long (Zahl), Boolean (Ja/Nein) oder Date (Datum)

  • Length Maximale Länge für Strings

  • Sort Sortierungswert gegenüber den anderen Parametern

• Query Die Query für die Abfrage am Service wird mit OData v2 geschrieben. Die Suchparameter können mittels {SearchParamId} innerhalb der Query referenziert werden. An dieser Stelle wird auf eine weitere Dokumentation der Query verzichtet, da im Anschluss drei Beispiele für eine Konfiguration gezeigt werden.

• Mapping Das zu definierende Mapping ist ein Standard-Kontakt-Mapping, welches als SourceAttribute den Namen des Properties der entsprechenden Entität enthalten muss. Das Mapping muss zwingend Konfiguriert werden. Es gibt kein Standardmapping das greift, wenn nicht explizit eines definiert wurde.

• Icon Base64-Icon, das dem Benutzer im Empfängerdialog angezeigt wird.

...