Address interfaces

Owned by Dinah Bolli (Unlicensed)
Last updated: Jun 16, 2023
3 min read

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:

Type

Id

Name

Type

Id

Name

Server

E10A8313-A92D-4CB2-A12B-9AEB58F39207

Server based address providers

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 e.g. for Excel

Client

0861976E-318F-41A1-AE45-6D894A7E7292

Vertec

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 of 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 to WS addresses.

  • Timeout (Optional) Maximum waiting time until results are delivered by the web service.

  • EnableProxyCredentials (Optional) If 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 login name.

  • ProxyCredentialsPassword (Optional) Proxy password.

  • DetailsColumnMapping (Optional) Maps 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) 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>

Recommended size: 16x16 or 32x32 pixels
Recommended image format: PNG (JPG is 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, → Leave out this part, use only the following characters:

iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAMAAABEpIrGAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAMAUExURQAAA[...]

 

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland