Adressschnittstellen

Die Adressschnittstellen werden für die Dokumentfunktion "Empfängeradresse" benötigt.

Die Address Provider sind PlugIns, die eine Schnittstelle zu einer Adressquelle implementieren. Die Verwendung der Address Provider kann mit Lizenzkosten verbunden sein. In der folgenden Übersicht sehen Sie alle Address Provider, die wir anbieten. Mittels Klick auf einen Address Provider finden Sie genauere Erklärungen und mindestens eine Beispielkonfiguration zur jeweiligen Schnittstelle:

Typ Id Name
Server E10A8313-A92D-4CB2-A12B-9AEB58F39207 Server basierte Address Provider
Client 833075BF-DDE5-4E9B-83B9-E9803C96E391 Abacus
Client F3D23EE5-F722-4082-842C-1168F7FDF1B8 Cobra
Client 328E6C4E-549B-4108-8ED2-D76B7E422F6B Creativ
Client 8C51B042-81EA-46E3-A429-821641E19A6A Generic SQL
Client 00BA9804-2430-4585-AE60-FCCA29909781 LDAP
Client 6EA5E6E3-1329-4B02-8779-0952C1119A15 Lotus Notes
Client A244D5EF-93F6-4A2C-9B62-F6DA64590B8C Microsoft Outlook
Client 121CE113-143E-4125-980A-20B6341F9FC9 Microsoft Dynamics
Client 739DEC43-D4F0-47F6-ADDD-C6AC73A93B02 Microsoft Navision
Client 96078EBE-4A8F-4D53-883E-9E9D0F07BC2A Microsoft SharePoint
Client B16EC67C-444E-46DC-A659-93E95BB4EB4D NEST
Client C6445223-DEBE-4817-9E50-E843F507C1BC RUF
Client 6A3354D7-6423-48C0-A3F0-F636E606196D SAP Puls
Client D66AA3D8-B184-4AED-BE93-6AA86FA1867E TelSearch.ch
Client 5f4865d3-9d7e-47bd-846d-546f7f7dd0ad UserDefinedAddressProvider z. B. für Excel
Client 0861976E-318F-41A1-AE45-6D894A7E7292 Vertec

Empfängerdialog: Suchfeld für konfigurierte Address Provider

Konfiguration

Folgende Parameter können in allen Address Provider angewandt werden:

<AddressProvider id="nguid" order="0" active="true" hiddenIfNotAvailable="true">
  <Debug>false</Debug>
  <Uri></Uri>
  <Timeout></Timeout>
  <EnableProxyCredentials>false</EnableProxyCredentials>
  <ProxyCredentialsName></ProxyCredentialsName>
  <ProxyCredentialsPassword></ProxyCredentialsPassword>
  <DetailsColumnMapping>//AddressProviderData/@Id</DetailsColumnMapping>
  <Visibility>
    <VisibleFor>S-1-2-34-5678901234-5678901234-567890123-4567</VisibleFor>
    <VisibleFor>S-9-8-76-5432109876-5432109876-543210987-6543</VisibleFor>
  </Visibility>
</AddressProvider>

Attribute

  • id GUID des Address Provider
  • order In welcher Reihenfolge die Provider-Lasche im Empfängerdialog angezeigt wird
  • active Wenn auf true, wird der Dialog angezeigt.
  • hiddenIfNotAvailable Wenn auf true, wird der Dialog nicht angezeigt, wenn die Adressquelle nicht erreichbar ist.

Durch die id wird der entsprechende Address Provider geladen. Ein Address Provider selbst kann auch mehrfach definiert werden, allerdings muss die korrekte Id konfiguriert werden.

Elemente

  • Debug Erweiterte Ausgabe in der Log-Datei.
  • Uri (Optional) URL auf WS Adressen.
  • Timeout (Optional) Maximale Wartezeit bis Ergebnisse vom Webservice geliefert werden.
  • EnableProxyCredentials (Optional) Falls ein Proxy im LAN betrieben wird, können Logindaten im Proxy überschrieben werden. Andernfalls werden diese vom Internet Explorer übernommen.
  • ProxyCredentialsName (Optional) Proxy Loginname.
  • ProxyCredentialsPassword (Optional) Proxy Passwort.
  • DetailsColumnMapping (Optional) Mappt Kontaktdaten in die Detailspalte in der Trefferliste. Es muss ein XPath mit entsprechendem Zugriff auf das Kontaktelement angegeben werden. Beispiele: ./Person/LastName, ./AddressProviderData/@Id, ./ExtendentFields/Item[@Key='Dynamic.Detail'].
  • Visibility (Optional) Ist dieser Parameter gesetzt, sehen nur noch die angegebenen AD-Benutzer und AD-Gruppen diese Addressschnittstelle. Die Berechtigung funktionert nach dem Prinzip der White-List. Für jede SID wird ein VisibleFor-Tag benötigt. Die SIDs können im OneOffixx Admin-Dashboard oder über die Windows-Konsole mit dem Befehl whoami /all ausgelesen werden. Ist dieser Parameter nicht gesetzt, ist die Schnittstelle für alle Benutzer sichtbar.

Icon

Einige Address Provider können mit einem Icon versehen werden, das dann im Empfängerdialog angezeigt wird.

Empfängerdialog: Address Provider Icon

Konfiguration:

<Icon>iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMAUExURQAAAOIaAOIbAeMbAuMcAuMdA+MeBeMfBuMgB+MiCeQjCuQkC+QkDOQnD+UqEuUrE+UsFOUvF+UxGeY0G+Y0HOY4IOc7JOc+J+hBKuhBK+hFL+hFMOhJM+lJNOlPOupUQOtVQetWQutaRutdSuteS+xiT+xnVe1rWe1tXO1vXu5zYu50ZO51Ze93Z+54aO95ae96ae98be+Cc/CBcfCDdPCFd/CGePGJevGKfPGLffGMf/GNgPGOgfKShPKUh/OYjPOZjfOckPSjmPSnnPWsovato/aupvayqfa0q/e4r/e4sPe5sfe6svi9tvjCuvjFvvnIwfnLw/nOyPrQyvrTzvrUzvvc1/ve2vzf2/zh3v3o5f3o5v3r6P3s6v7v7f7w7/7y8f708v729f739v/49//6+v/8+//8/P/9/f/+/v///wAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAOq7jwsAAAEAdFJOU////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////wBT9wclAAAACXBIWXMAAA7DAAAOwwHHb6hkAAAAGXRFWHRTb2Z0d2FyZQBwYWludC5uZXQgNC4wLjE3M26fYwAAATdJREFUOE+d0VdTwkAUBWAXsYCiiL33riiKFTt2sWIDxIItOf//fd0WEpgNmfE8JHfv/SabTaqoR/4DiLrLlAIiohYyRSBnIqojI4AaWCnZRAvq+EVFC95Pppr5vQyEY4AoKIDfm3inqG0wlGV9UdHejbTJFk+7fQ4QN1hLgdEAicylPoGUAyT53NqicDbTQoKXmHeAxWMbtMeuvs27tRxaHSBAbDDZREITh6+4ZwexX9IBjJ/r5Q6SQMINhKdPP/CYAzuEHiy0kfqRI2Sr2UwLvvCw1R/FAf+WWtAwnnyBgTFXsNrt8w+jEHQFb8jsb+KCz/WgdnDvGZh1BzsDNf68GSkHoaXtqCjY786fIy3mTlAMzfCHrVcAvq6VW6OnAuCNRjmXgEWOZFRLxgIinkDGE5TGA1D6B0+SGX0LZzDfAAAAAElFTkSuQmCC</Icon>

Empfohlene Grösse: 16x16 oder 32x32 Pixel
Empfohlenes Bildformat: PNG (JPG ist auch möglich)

Zwischen <Icon> und </Icon> muss ein Base64-String eingefügt werden.
Für das Konvertieren von PNG- oder JPG-Dateien zu Base64-Strings kann folgende Webseite verwendet werden.


Beispiel-Resultat aus einer Konvertierung

data:image/png;base64, → Diesen Teil weglassen, nur die folgenden Zeichen verwenden:

iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMAUExURQAAA[...]