Address interfaces

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

Recipient dialog: Search field for configured address providers

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.

Recipient dialog: address provider icon

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