File Associations

Controls the creation of file associations in the user environment.


You can use dynamic tokens to extend Workspace Environment Management actions to make them more powerful.

File association list

A list of your existing file associations. You can use Find to filter the list by name or ID against a text string.

To add a file association

  1. Use the context menu Add command.
  2. Enter details in the New File Association dialog tabs, then click OK.

Name. The display name of the file association, as it appears in the file association list.

Description. This field is only shown in the edition/creation wizard and allows you to specify additional information about the resource.

File Association State. Toggles whether the file association is Enabled or Disabled. When disabled, it is not processed by the agent even if assigned to a user.

File Extension. The extension used for this file association. If you select a file name extension from the list, the ProgID field automatically populates (providing that the file type is present on the machine the administration console is running on). You can also type the extension directly.

ProgID. The programmatic identifier associated with an application (COM). This value automatically populates when you select a file name extension from the list. You can also type the ProgID directly. To discover the ProgID of an installed application, you can use the OLE/COM Object Viewer (oleview.exe), and look in Object Classes/Ole 1.0 Objects.

Action. Allows you to select the action type: open, edit, or print.

Target. Allows you to specify the executable used with this file name extension.

Command. Allows you to state any specific commands the executable should follow.

Set as Default Action. Toggles whether the association is set as a default for that file name extension or not.

Overwrite. Toggles whether this file association overwrites any existing associations for the specified extension.

Run Once. By default, Workspace Environment Management creates a file association every time the agent refreshes. Select this option to create the file association once, rather than at every refresh. This speeds up the agent refresh process, especially if you have many file associations assigned to your users.

Action Type. Describes what type of action this resource is.

For example, to add a new file type association for text (.txt) files for users to automatically open text files with the program you selected (here, iexplore.exe), complete the following steps.

Step 1. On the Administration Console > Actions > File Associations > File Association List tab, click Add.

Step 2. In the New File Association window, type the information and then click OK.

New file type association


  • File Association State. Select Enabled.
  • File extension. Type the file name extension. In this example, type .txt.
  • Action. Select Open.
  • Target application. Click Browse to navigate to the applicable executable (.exe file). In this example, browse to iexplore.exe located in the C:\Program Files (x86)\Internet Explorer folder.
  • Command. Type “%1” and make sure to wrap %1 in double quotes.
  • Select Set as Default Action.

Step 3. Go to the Administration Console > Assignments > Action Assignment tab.

Step 4. Double-click the user or user group to which you want to assign the action.

Step 5. Go to the Administration Console > Administration > Agents > Statistics tab and then click Refresh.

Step 6. Right-click the agent and then select Refresh Workspace Agent(s) in the context menu.

Step 7. Go to the machine on which the agent is running (user environment) to verify that the created file type association works.

In this example, if you double-click a file with a .txt extension in the end-user environment, that file automatically opens in Internet Explorer.

File Associations

In this article