Configuration

The Outlook Add-In provides functionalities for the use case “mailbox archiving” as described in chapter Mailbox archive. At startup the ImageMaster Outlook Add-In reads the assigned policy from the mailbox property defined in the registry key “MsxCustomAttributeSchema” and retrieves the configuration for this policy from the initial Coordinator web service (registry key “ConfigCoordinatorURL”). For a full list of configuration parameters for Coordinators see the AdminClient user manual [UM AdminClient], chapter Coordinator settings. For details on the user interface see the Content Services for E-Mail user manual [UM Mail].

The following registry keys are inserted in HKEY_LOCAL_MACHINE during the setup of the ImageMaster Outlook Add-In by the installer (item 1 and 2) or manually / by a software distribute tool (item 4-5). Starting with ImageMaster 9.4.2, setting the registry keys in HKEY_LOCAL_MACHINE is optional.

All path elements in the table below relate to the following base path:

  • Software\T‑Systems\ImageMaster\OutlookAddIn\

 

Path element

Type

Description

Optional

1.  

ConfigCoordinatorUrl

Type String / REG_SZ

URL of the initial Coordinator web service

No

2.  

CoordinatorUsername

CoordinatorPassword

Type String / REG_SZ

Keys to configure the credentials used for the WSCoordinator

The credentials have to be encrypted via the PasswordEncrypter tool.

Yes

 

3.  

CustomAttributePolicyName

CustomAttributeMailboxId

Type String / REG_SZ

AttributeName for policyName and ImaMailboxId

Possible values are “CustomAttribute1” … “CustomAttribute15”.

 

 

4.  

EnableCaching

Type String / REG_SZ

The caching settings are configured in the policy settings (see [UM AdminClient] for details).

By default, caching is disabled on terminal sessions, while it is enabled on non-terminal sessions. With this key the default can be changed:

If it is set to “true”, the caching settings of the policy settings are enabled.

If it is set to “false”, caching will be deactivated (the caching settings of the policy settings are ignored).

Yes

 

5.  

logDir

Type String / REG_SZ

Key to override the default log directory
Default log directory: %HOMEDRIVE%%HOMEPATH%

Yes

6.  

TmpDir

Type String / REG_SZ

Overrides the directory where temporary retrieved e-mails are stored (optional).
Default temporary directory:
%LOCALAPPDATA%\T-Systems\Temp

Yes

Table 226: Registry keys for HKEY_LOCAL_MACHINE

The registry keys provided below are inserted in HKEY_CURRENT_USER by the ImageMaster Outlook Add-In at run time (item 1 and 2) or manually / by a software distribute tool (item 3). Starting with ImageMaster 9.4.2, setting the registry keys HKEY_CURRENT_USER is optional.

All path elements in the table below relate to the following base path:

  • Software\T‑Systems\ImageMaster\OutlookAddIn\

 

Path element

Type

Description

1.

OfflineEnabled

Type DWORD (32-bit) / REG_DWORD

Stores state of offline synchronization enabled: value 0 or 1.

2.

LoggingEnabled

Type DWORD (32-bit) / REG_DWORD

Stores state of logging enabled: value 0 or 1.

3.

ForceLoggingEnabled

Type DWORD (32-bit) / REG_DWORD

Overrides logging enabled: if set to 1, logging will be done, independent from policy or user settings.

Table 227: Registry keys for HKEY_CURRENT_USER

Further server-side configuration, which relates to the Outlook Add-In, can be set up via the AdminClient. In particular the Outlook Client Add-In versions that are accepted by the ImageMaster Integration Service can be defined on server-side. See section Global settings in the E-Mail configuration room of the AdminClient [UM AdminClient].