Location Editor
Test locations are edited using the Location . The editor contains three tabs:
Overview
This tab provides an overview of the test location, including its general information, property groups, Eclipse workbench properties, and general properties.
This tab contains the following sections:
-
General Information
Contains the test location's name, description, file path within the workspace, and host name or IP address. The test 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 location in the
Test Navigator
and select Test Connection or Alt+Shift+T, T
2.
-
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.
Note, the Eclipse Workbench Properties section will only appear if one or more Eclipse Workbench properties are associated with the test location.
-
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 location.
[1] Test 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 location.
The file name represents the test location file (*.location) within the workspace. When the test 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 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 location. For example, the CLASSPATH general property contains
dependencies on the target host.
In addition, the ROOTDIR general property contains absolute path of the directory on the target host where
the dependencies configured in
Artifact are deployed when a test suite is executed. If the
ROOTDIR general property is not provided or invalid for the target host, the dependencies are deployed to a temporary directory on the target host.
Note, the General Properties tab will only appear if one or more general properties are associated with the test 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 location, as defined in the
Target Platform.
Note, the Eclipse Workbench Properties tab will only appear if one or more Eclipse Workbench properties are associated with the test location.
All file paths are absolute and operating system dependent based on the target operating system.
Related tasks
Creating a location