Page Comparison

...

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

...

...

SAP C4C (Cloud for Customer)

...

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

Mit der ODataQuery können auch abhängige Entitäten geladen werden. Dabei muss beachtet werden, dass abhängige Entitäten immer als Array vom Service zurückgegeben werden. Dies bedeutet, dass für das SourceAttr

Über die Url https://{SAPC4CUrl}/sap/c4c/odata/v1/c4codataapi/$metadata können sämtliche im Service enthaltene Entities mit ihren Properties und Navigationproperties eingesehen werden. Dies ist insbesondere für die Query und das Mapping hilfreich.

...