Document settings

Relevant for: GUI tests and components

Use the Test or Business Component Settings dialog box or the Additional Settings pane in an application area to set testing options that affect how UFT One works with a specific test or component.

Different panes and settings are available, depending on the document in focus (test, component, or application area), as well as the Add-ins loaded.

To access
  • Have a test open in the document pane, or selected in the solution explorer.

    Select File > Settings.

  • Create or open an application area.
Important information

Clicking the Restore Factory Defaults button resets all product settings, including ALM connection information, the recent files list, and anything defined in the Options dialog box, such as startup options, UI layout, GUI, API, and BPT testing options, remote connection credentials, and more.

Most business components inherit settings from the component's application area and are displayed as read-only in the Business Component Settings dialog box.

Note: You can also set testing options that affect all tests and components. For details, see Global options.

The table below lists the panes contained in the Settings dialog box.




The properties of the test or component, for example, its description and associated add-ins. You can also set the status of a component.

(components only)

Options for capturing or loading a snapshot image to be saved with the component for display in ALM.

(tests only)

The run session preferences for your test.

(components only)

The Windows-based applications on which the component can record and run.


The resources associated with your test or component, such as function libraries, shared object repositories, and data tables.

(tests/scripted components only)

Options for viewing existing built-in and user-defined environment variables, adding, modifying and saving user-defined environment variables, and selecting the active external environment variables file.


Options for setting how UFT One recovers from unexpected events and errors that occur in your testing environment during a run session.

Log Tracking

Options for activating and setting run-time preferences for tracking log messages generated by the log framework that monitors events occurring in your application.

Local System Monitor

Options for activating and setting preferences for tracking system counters during a run session.