Version: Classic

Adressschnittstellen (classic)

warnung

Auf dieser Seite geht es um “classic” Vorlagen. Weitere Informationen finden Sie hier.

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

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

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[...]

Konfiguration​

Attribute​

Elemente​

Icon​

Konfiguration

Attribute

Elemente

Icon