Folders Pane (Options Dialog Box > GUI Testing Tab)

Relevant for: GUI tests and components

This pane enables you to enter the folders (search paths) in which UFT One searches for tests, components, actions, or resource files that are specified as relative paths in dialog boxes and steps.

For example, suppose you add the folder in which all of your tests are stored to the folders list. If you later insert a copy of an action to a test, you only have to enter the name of the test containing the action you want to insert in the Insert Copy of Action dialog box. UFT One searches for the test's path in the folders you specified in the Folders pane. For components and application areas, all files must be stored in an ALM path.

To access

  1. Do one of the following:

    • Ensure that a GUI test, action, or component is in focus in the document pane.

    • In the Solution Explorer, select a GUI test or component node or one of its child nodes.

  2. Select Tools > Options > GUI Testing tab > Folders node.
Important information

  • The Restore Factory Defaults button resets all Options dialog box options to their defaults.

  • The current test or component is listed in the Search list by default. It cannot be deleted.

    Relative paths are relative to this current test.

    UFT One 15.0 and earlier: Relative paths are saved as relative, but the list displays the full path that UFT One uses for this relative path.

    UFT One 15.0.1 and later: The list displays the relative path. Hover over the path to see the full path that UFT One uses for this path.

  • You can use a PathFinder.Locate statement in your test to retrieve the complete path that UFT One uses for a specified relative path based on the folders specified in the Folders pane. For details, see the PathFinder object in the Utility Objects section of the UFT One Object Model Reference for GUI Testing.

  • If you are working with the Resources and Dependencies model with Quality Center or ALM, specify an absolute Quality Center or ALM path.

  • UFT One searches for the specified test, component, action, or file in the order in which the folders are displayed in the search list. If the same file name exists in more than one folder, UFT One uses the first instance it finds

  • UFT One cannot resolve ALM folders paths specified in the Folders pane of the Options dialog box, if any of the folder names contain a forward slash.

    Workaround: Remove the slash in the folder name in ALM or specify paths using this folder using absolute paths (instead of relative paths that reference the Folders pane).
See also

User interface elements are described below:

UI Element

Description
Search list

Indicates the folders in which UFT One searches for tests, components, actions, or files. If you define folders here, you do not need to designate the full path of a test, component, action, or file in other dialog boxes or call statements. The order of the search paths in the list determines the order in which UFT One searches for a specified action or file.

Adds a new folder to the search list.

  • You can add a full path, a relative path, or an ALM path.

  • To add an ALM path when connected to ALM, click this button. UFT One adds [ALM], and displays a browse button so that you can locate the ALM path

  • When not connected to ALM, hold the Shift key and click this button. UFT One adds [ALM], and you enter the path. You can also type the entire ALM path manually. If you do, you must add a space after [ALM]. For example: [ALM] Subject\Tests.

  • UFT One searches ALM project folders only when you are connected to the corresponding ALM project.
Remind me to use relative paths when specifying a path to a resource

When associating a resource, you can choose to be prompted to use a relative path. For details, see Relative paths for test resources.

Provide warning to replace relative paths for resources associated with test saved in ALM Enables you display a warning in the Errors pane each time you open a test from ALM in which associated resources are saved with a relative path to the resource.