Editing a workbench location

Test workbench locations are edited using the Location Editor. The editor contains three tabs:

Overview

This tab provides an overview of the test workbench location, including its general information, property groups, Eclipse workbench properties, and general properties.

This tab contains the following sections:

General Information

Contains the test workbench location's name, description, file path within the workspace, and host name or IP address. The test workbench location's name1, description, and host name or IP address are editable.

The connection to the target host may be tested by clicking the Test Connection link2. Alternatively, right-click the test workbench location in the Test Navigator and select Test Connection or Alt+Shift+T, T2.

Property Groups

Contains a link to the General Properties and Eclipse Workbench Properties tab. Clicking a link will open the associated tab.

Eclipse Workbench Properties

Contains links to the Eclipse Workbench properties in the Eclipse Workbench Properties tab. Clicking a link or the More... button will open the Eclipse Workbench Properties tab.

General Properties

Contains links to the general properties in the General Properties tab. Clicking a link or the More... button will open the General Properties tab.

Note, the General Properties section will only appear if one or more general properties are associated with the test workbench location.

1 Test workbench locations have a file name and logical name. The logical name is used in the Test Navigator of the Test Perspective, dialogs, editors, and wizards to represent the test workbench location. The file name represents the test workbench location file (*.location) within the workspace. When the test workbench location is created, the logical name defaults to the file name (excluding the .location file extension) and may be modified without modifying the file name. The logical name allows customization of the test workbench location name without affecting the file name within the workspace.

2 The Agent Controller or Integrated Agent Controller (local host only) is required to be configured and running.

General Properties

This tab contains the table of general properties associated with the test workbench location.

Note, the General Properties tab will only appear if one or more general properties are associated with the test workbench location.

General properties can be added to the table by clicking the Add... button and entering the property name, operator (=, !=, >, <, >=, or <=), and value.

All file paths are absolute and operating system dependent based on the target operating system.

Selected general properties can be removed (Remove), moved up (Up), or moved down (Down). Existing general properties may be edited by double-clicking the general property in the table and and modifying the property name, operator, and/or value.

Eclipse Workbench Properties

This tab contains the table of Eclipse Workbench properties associated with the test workbench location, as defined in the Target Platform.

All file paths are absolute and operating system dependent based on the target operating system.

Related tasks
Creating a workbench location