Home Portal

Skip to end of metadata
Go to start of metadata
This article describes the steps necessary to enable opening the XTRF workflow directories in your default file manager (e.g. Windows Explorer or Total Commander) by clicking on their paths displayed in the Workflow Graph tab.

Workflow Directories

  • All settings of Windows and Firefox described below need to be configured on each computer on which you want this feature to be enabled.
  • All settings of XTRF described below need to be configured for each XTRF user who would like this feature.

Settings to be Pre-Configured in Windows

Your server's XTRF Home Directory, which is the location where XTRF stores your files, needs to be mapped via your local network to a local virtual drive. The path of the XTRF Home Directory on your server can be found in Advanced Configuration, referred to as the System Home Directory.

The instructions on how to map a network location to a local drive can be found here:

For the purpose of this article, let us assume that the XTRF Home Directory is E:\XTRF_data and that you mapped it to drive X:. As a result, the content of the E:\XTRF_data folder on your server is displayed whenever you open drive X: on your computer. Now you can map XTRF paths so that it always uses X:  wherever  E:\XTRF_data is used.

Settings to be Configured in XTRF

  1. Go to System > Preferences > Directories Mapping. These settings allow all system paths to be transformed from server-based into locally recognized ones.
  2. A table with two columns, Server Side Directory and Local Directory, displays all the current mappings.
  3. Click Edit.

    • The Server Side Directory should be the same as what you entered for System Home Directory in Advanced Configuration.
    • For Local Directory, enter the local path to the mapped directory from the server.
  4. Make any necessary modifications.
    • To add new mappings, enter them into the appropriate field and then click Add Folder Mapping. For example, set E:\XTRF_data as the Server Side Directory and X: as the Local Directory.

      Please note that both Server Side Directory and Local Directory should end with a slash (for Linux paths) or backslash (for Windows paths).

    • To remove any unnecessary mappings, click Delete Icon next to the desired item.
  5. Click Save.

Settings to be Configured in Firefox

  1. Open about:config
  2. Right-click on the list.
  3. Select New / Boolean
  4. Enter the following string name: network.protocol-handler.expose.file
  5. Set the value to false.
  6. Close all Firefox windows.
  7. Open the prefs.js file. The location of the file is:
    • for Windows Vista and 7: C:\Users\[YOUR_USER_NAME]\AppData\Roaming\Mozilla\Firefox\Profiles\[YOUR_PROFILE_NUMBER].default\
  8. Add the following lines and save the file:

    Replace YOUR_XTRF_ADDRESS with the proper URL address, e.g. http://xtrf.yourcompany.com/

Settings to be Configured in Windows

  1. Download the files xtrfdir.batxtrfdir_explorer.reg and xtrfdir_totalcmd.reg and place them in C:\xtrfdir

    If you place the files in a different folder, you must edit the REG files and change the path leading to the BAT file. Remember to use double backslash in your path (like in the default path).

  2. Check if xtrfdir.bat contains correct paths to the applications:

    1. EXPLORER_PATH should point to Windows Explorer executable (explorer.exe)

    2. TOTALCMD_PATH should point to Total Commander executable (TOTALCMD.EXE)

      Setting the path to Total Commander is optional. Use it only if you have Total Commander installed on your system and you want to use it to handle XTRFDIR links.

  3. Run xtrfdir.bat

  4. If you want the links to be opened in Windows Explorer, run xtrfdir_explorer.reg. If you want the links to be opened in Total Commander, run xtrfdir_totalcmd.reg. You will then be asked to confirm the modifications to the Windows Registry.

  5. When you first open an xtrfdir:// link in your browser, you will be prompted to confirm the use of the new protocol. Click "Accept".
  6. To change application used by the XTRFDIR protocol afterwards, run a different REG file.
  • No labels