Change storage location for user data

The storage location and structure of the client user data can be configured differently from the default using the ELO_USER_HOME environment variable. Keep in mind that these should still remain on a local drive. Fast access to files in temp or doccache are especially important for client performance.

Since ELO 12.04, the Intray and In use work areas can be stored separately using the variables ELO_USER_INTRAY and ELO_USER_CHECKOUT. This ensures that there is significantly less impact on network path performance, for example.

Configuration

In order to configure the environment variables, the following items need to be taken into account:

1. The name of the environment variable must be ELO_USER_HOME, ELO_USER_INTRAY or ELO_USER_CHECKOUT.

2. The variable should always be defined in the user area of the environment variables and not in the machine area.

3. The variables must always be written in uppercase.

4. The variables must begin and end with a % sign.

5. You should ensure that the resolved file paths do exceed the maximum length allowed in Windows of 255 characters.

   If the environment variable is defined in a different way than by using the interface in Windows, please ensure that the registry entry is of the type REG_EXPAND_SZ since otherwise it will not be possible to resolve the corresponding variable.

Information

If the environment variable is defined in a different way than by using the interface in Windows, please ensure that the registry entry is of the type REG_EXPAND_SZ since otherwise it will not be possible to resolve the corresponding variable.

Variables

Variable	Result	Comment
%APPDATA%	C:\Users{Username}\AppData\Roaming	Windows 7/Vista, the equivalent will be used in XP
%TEMP%	C:\Users{Username}\AppData\Local\Temp	Windows 7/Vista, the equivalent will be used in XP
%ELOPROFILENAME%	Profile name of the currently connected ELO profile	Is required
%ELOUSERID%	User ID of the user logged on to ELO	Is required
%ELOUSERNAME%	User name of the user currently logged on to ELO	Please ensure these are unique

Please note

The variables %ELOPROFILENAME% and %ELOUSERID% are required in the definition. The value %APPDATA%\ELO Digital Office\%ELOPROFILENAME%\%ELOUSERID% is recommended as the default for the environment variable.

Example

Variable: %APPDATA%\ELO Digital Office GmbH\%ELOPROFILENAME%\%ELOUSERID%\

If Ms. Meier (Windows user name: Meier) logged on with the ELO user Administrator (user ID=0) and the profile DEMOSERVER02, then the environment variable would look like this:

C:\Users\Meier\AppData\Roaming\ELO Digital Office GmbH\DEMOSERVER02\0\

Please note

Due to this uniqueness, the user name should not be used for the file paths. If the user name is changed later, the user will no longer be able to find any files that it checked out. The specific structure for the ELO Java Client will be created within this folder.

Please note

As soon as the environment variable has been defined, the ELO Java Client will access the new checkout directory. The old files will no longer be displayed.

You must therefore ensure that all users have checked in their documents before the variables are defined, as otherwise the files must be manually moved.