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 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 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.

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

  • You can use a PathFinder.Locate statement in your test to retrieve the complete path that UFT 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 Object Model Reference for GUI Testing.
  • UFT 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 uses the first instance it finds

  • UFT 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 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 searches for a specified action or file.

Adds a new folder to the search list.

  • To add an ALM path when connected to ALM, click this button. UFT 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 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 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.