Directory Maintenance
The Directory Maintenance technology can be used for preparing and maintaining users' home and profile directories.
Directory Maintenance is divided into a User Home Directory node and a User Profile Directory node. Both nodes allow you to configure a model or template of the files and folders that should be present on or copied to the user's home directory and/or the user's profile directory.
Where to find Directory Maintenance
What |
Where |
Global level |
Composition > Actions By Type > Files and Folders > User Home / Profile Directory |
Application level |
Open the application at Composition > Applications, go to Configuration > Actions |
Configuration
The User Home Directory and User Profile Directory nodes consist of two tabs:
- The Files tabs: allow you to configure the model directories of Workspace Control. They provide an Explorer-like view of the model directories, files and sub-folders. A model directory contains all folders and resources that you can use when configuring the contents of the user's home directory or profile directory.
- The Actions tabs: allow you to configure the contents of the user's home directory and profile directory, based on your selection of folders and resources from the model directories.

Select the drive in the Default home drive field on the Settings tab:
- When Resolve home drive from Active Directory is selected, Workspace Control will first try to retrieve the user's home drive letter from the Active Directory User Profile Properties.
- When Use %reshomedrive% if available is selected, Workspace Control will create exceptions to the default Drive to home directory setting by using the %reshomedrive% environment variable.
The Overview in the users Workspace Analysis Details also shows the Home Directory and Profile Directory rules that apply to the user.

- When configuring the settings of a file or folder, you can replace its name with the username. This is useful if you want to copy a file or folder with the same name as the user's logon name to the user's home directory.
- By specifying an alias for the object, the original object name will be overwritten when it is copied to the home directory of a user. This is useful if the home directory of a user should contain a specific object whose values depend on the group membership of the user.
- Select which action should be taken in the Action field, depending on whether you selected a folder or a file the Object field. When specifying an Action for a file, the option Set specific values in INI-file allows you to configure INI file values. After configuring INI-file values, select Run once if these values should be set only once.
- Required connection state specifies the required connection state that allows the setting to be applied. For example, this allows you to configure a setting that will only be applied if a computer has an online connection state.

-
Click the Files tab of the User Home Directory or User Profile Directory node, depending on the directory that you want to configure.
-
Select the folder to which you want to add a folder or User resource and click New. This will open the Select File(s)/Folder(s) window, which allows you to select and add folders and resources to the model directory.
-
Select or browse to the file or folder that you want to add and click OK. The selected file or folder will be added to the Model directory folder of the Home Directory or Profile Directory node, depending on your selection in step 1. You can only use these files and folders to configure the user's Home Directory and Profile Directory.
Examples
- When configuring the settings of a resource, the option Replace with %username% allows you to replace the name of the resource with the username. This is useful if you want to copy a file or folder with the same name as the user's logon name to the user's home directory.
For example, if you want to copy a log file to the home directory of users Jackson, Greene and Smith, make sure that the model directory contains the files jackson.log, greene.log, and smith.log. When these users then log on, the correct files with their login name will be copied to their home directory. This means that you do not need to create an entry for each individual user (jackson.log, greene.log, smith.log), but can create one entry with %username%.log instead.
- By specifying an alias for the resource, the original resource name will be overwritten when it is copied to the home directory of a user. This is useful if the home directory of a user should contain a specific resource whose values depend on the group membership of the user.
The administrator of IvantiDemo has added two INI files to the model directory of Home Directory Maintenance, app_group1.ini and app_group2.ini.- app_group1.ini has value "green".
- app_group2.ini has value "blue".
- If user petersent logs on, who belongs to group 1, app_group1.ini should be copied to his home directory and renamed to app.ini
- If user williamsj logs on, who belongs to group 2, app_group2.ini should be copied to his home directory and renamed to app.ini
You can configure this by specifying the alias "app.ini" for both files. This ensures that the home directory of user petersent will contain an app.ini file with value "green" and the home directory of user williamsj will contain an app.ini file with value "blue".