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:

...

The address interfaces are needed for the document function Recipient address.

The address providers are plug-ins that implement an interface to an address source. The use of the address providers can be connected with license costs. In the following overview you can see all address providers we offer. By clicking on an address providers you will find more detailed explanations and at least one sample configuration for the respective interface:

...

...

Configuration

The following parameters can be applied in all address providers:

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

...

Attributes

• 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-Dateiof the address provider.

• order In which order the provider tab is displayed in the recipient dialog.

• active If on true, the dialog is displayed.

• hiddenIfNotAvailable If on true, the dialog will not be displayed if the address source is not accessible.

By the id the corresponding address provider is loaded. An address provider itself can also be defined multiple times, but the correct Id must be configured.

...

Elements

• Debug Extended output in the log file.

• Uri (Optional) URL auf to WS Adressenaddresses.

• Timeout (Optional) Maximale Wartezeit bis Ergebnisse vom Webservice geliefert werdenMaximum waiting time until results are delivered by the web service.

• EnableProxyCredentials (Optional) Falls ein Proxy im LAN betrieben wird, können Logindaten im Proxy überschrieben werden. Andernfalls werden diese vom Internet Explorer übernommenIf a proxy is operated in the LAN, login data can be overwritten in the proxy. Otherwise they will be inherited from Internet Explorer.

• ProxyCredentialsName (Optional) Proxy Loginnamelogin name.

• ProxyCredentialsPassword (Optional) Proxy Passwortpassword.

• DetailsColumnMapping (Optional) Mappt Kontaktdaten in die Detailspalte in der Trefferliste. Es muss ein XPath mit entsprechendem Zugriff auf das Kontaktelement angegeben werden. BeispieleMaps contact details to the details column in the result list. An XPath with appropriate access to the contact element must be specified. Examples: ./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.

...

• If this parameter is set, only the specified AD users and AD groups will see this address interface. The permission works on the white-list principle. For each SID a VisibleFor tag is required. The SIDs can be read in the OneOffixx admin dashboard or via the Windows console with the command whoami /all. If this parameter is not set, the interface is visible to all users.

...

Icon

Some address providers can be provided with an icon, which is then displayed in the recipient dialog.

...

Configuration:

<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össeRecommended size: 16x16 oder or 32x32 Pixel
Empfohlenes Bildformatpixels
Recommended image format: 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 Konvertierungis also possible)

A Base64 string must be inserted between <icon> and </icon>.
For converting PNG or JPG files to Base64 strings the following web page can be used.

Example result from a conversion

data:image/png;base64, → Diesen Teil weglassen, nur die folgenden Zeichen verwendenLeave out this part, use only the following characters:

iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMAUExURQAAA[...]

...