Adressschnittstellen (classic)


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

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

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland