Test Design StudioGo to Previous Topic: Tool WindowsGo to Next Topic: Server Explorer

Solution Explorer

The Solution Explorer is used to manage and interact with all opened solutions, projects, and files. It is perhaps the most important tool window in the application. If not already opened or visible, you can show Solution Explorer by selecting View -> Solution Explorer from the main menu.

Solution Explorer uses a tree-based structure to group and display data. Each item in the tree is referred to as a node. Select any node in the tree, and the properties of the selected node will be displayed in the Properties tool window. Right-click any node to display a context menu of available commands. The following types of nodes will be displayed in the tree:

Note:   If no solution is currently open, no data will be displayed in the tree.

Project File Structure

When you create a project, a file is created on the file system to store information about that project. Typically, this file is placed in a folder specifically for the purpose of storing data relevant to the project. All files/folders that are located within the same folder on the file system as the project file (including sub-folders) are eligible for direct inclusion in a project. Typically, only the files/folders that are included in a project will be displayed in the Solution Explorer. To see other available files/folders, select Project -> Show All Files from the main menu. The hidden files/folders that are available for direct inclusion that are not already part of the project will now be displayed directly in the tree.

Think of Solution Explorer as a managed view of the file system folder where a project is saved. You are then given the ability to control which items from the file system are included/excluded from the project itself.

Warning:   Deleting files/folders from a project may result in the permanent deletion of those items from your file system. Click here for details on how to remove a file/folder from a project.

The following screen highlights the relationship between a project loaded in Solution Explorer and the underlying file system represented by that project:

Note:   In the screen shot above, keep in mind that Unified Functional Testing are stored on the file system as folders and not individual files.

Solution Node

The Solution Node is the top-level node in the tree and represents the open solution. Grouped under the Solution Node will be an individual Project Node for each project that is part of the solution. You may also see the Miscellaneous Files Node grouped under the solution.

The following context-menu commands are available for the Solution Node.

Command Description
Add -> New Project... Allows you to add a new project to the solution.
Add -> Existing Project... Allows you to add an existing project to the solution.
Copy Full Path Copies the full path of the solution file to the clipboard.
Open Containing Folder Opens Windows Explorer to the folder where the solution file is located.
External Tools A list of external tools that can be executed against the solution file.
Properties Allows you to view the properties of the project (i.e. typically opens the Properties tool window).

Miscellaneous Files Node

When a file is opened in Test Design Studio that is not part of a project, a File Node will be created and grouped under the Miscellaneous Files Node. This allows you to interact with the file in a manner similar to files that are part of a project. When the editor for the file is closed, the File Node for that file will be removed.

Note:   The Miscellaneous Files Node is only visible when at least one miscellaneous file is open.
Tip:   You may configure document options to turn the use of the Miscellaneous Files Node on or off.

Project Node

A Project Node is created for each project that is part of a solution and will be grouped under the Solution Node. A Project Node is used to group the References Folder Node, Folder Nodes, and File Nodes to reflect the content of a project.

The Folder Nodes and File Nodes grouped under a project typically reflect the actual files and folders on the file system that are located in the same folder where the project file is located.

The following context-menu commands are available for the Project Node:

Command Description
Add -> Add New Item... Allows you to add a new file to the root folder of the project.
Add -> Add Existing Item... Allows you to add an existing file to the root folder of the project.
Add -> New Folder Allows you to add a new sub-folder to the root folder of the project.
Add Reference... Allows you to add a reference to the project.
Remove Removes the project from the solution without deleting any of the project data.
Load Project Loads a project into the solution that was not previously loaded.
Unload Project Unloads a project from the solution.
Copy Full Path Copies the full path of the project file to the clipboard.
Open Containing Folder Opens Windows Explorer to the folder where the project file is located.
External Tools A list of external tools that can be executed against the project file.
Properties Allows you to view the properties of the project (i.e. typically opens the Properties tool window).

References Folder Node

The References Folder Node is used to group all the references that are in use by the project. Each reference is reflected by a Reference Node.

Note:   The References Folder Node is only displayed for language-based projects that support references.

The following context-menu commands are available for the References Folder Node.

Command Description
Add Reference... Allows you to add a reference to the project.

Reference Node

The Reference Node represents a reference that is used by the project. Language-based projects automatically include a reference to the built-in language reference upon which they are based (i.e. a 'Unified Functional Testing' project will have a reference to the 'Unified Functional Testing' built-in language reference for VBScript). You may also add references to external library files and other projects within the same solution.

The following context-menu commands are available for the Reference Node.

Command Description
Remove Removes the reference from the project. This command is not available for built-in references.
View in Object Browser Navigates to the item in the Object Browser tool window.
Properties Allows you to view the properties of the reference (i.e. typically opens the Properties tool window).

File Folder Node

The File Folder Node is used to group and organize files and represents a physical folder on the file system.

The following context-menu commands are available for the File Folder Node.

Command Description
Add -> Add New Item... Allows you to add a new file to the selected folder.
Add -> Add Existing Item... Allows you to add an existing file to the selected folder.
Add -> New Folder Allows you to add a new sub-folder under the selected folder.
Exclude from Project Removes the folder from the project but does not delete the physical folder from the file system. The folder will become a hidden folder.
Include from Project Includes the hidden folder in the project.
Delete Removes the folder from the project and deletes the physical folder from the file system.
Copy Full Path Copies the full path of the folder to the clipboard.
Open Containing Folder Opens Windows Explorer to the folder.
External Tools A list of external tools that can be executed against the folder.
Properties Allows you to view the properties of the folder (i.e. typically opens the Properties tool window).

File Node

The File Node is used to represent a file stored in a project. A file can be grouped under a Project Node or Folder Node. Files that are not part of a project may be group under the Miscellaneous Files Node and behave similarly to a project file.

The following context-menu commands are available for the File Node.

Command Description
Open Opens the file using the default editor.
Open With... Opens the file allowing you to choose a specific editor.
Application Lifecycle Management Sub-Menu This sub-menu offers commands used to interact with files stored on a HPE Application Lifecycle Management server including the ability to upload/download files and work with version control.
Exclude from Project Removes the file from the project without deleting the physical file from the file system. The file will become a hidden file.
Include in Project Includes a hidden file in a project that already exists on the file system.
Delete Removes a file from a project and deletes the physical file from the file system. This option is not available for linked files or HPE Application Lifecycle Management files.
Remove Removes a linked file or HPE Application Lifecycle Management file from the project without modifying the source file. The local copy of a HPE Application Lifecycle Management file will be deleted from the file system.
Compare -> Mark as Base Compare File Marks a file as the base file to be used for subsequent executions of the Compare -> Compare To command. This is the first step of a file comparison process. Click here for details on comparing files.
Compare -> Compare To Compares the selected file to the file previous marked as the base file using the Compare -> Mark as Base Compare File command. This is the second step of a file comparison process. Click here for details on comparing files.
Compare -> Reset Base Compare File Resets the file marked as the base file using the Compare -> Mark as Base Compare File command. Click here for details on comparing files.
Compare -> Compare... Opens a dialog prompting you for the paths of two files to compare. Click here for details on comparing files.
Copy Full Path Copies the full path of file to the clipboard. In the case of Unified Functional Testing, the path will be to the folder that contains the script data.
Open Containing Folder Opens Windows Explorer to the folder where the file is stored. In the case of Unified Functional Testing scripts, this will be the parent folder of the folder that contains the script data.
External Tools A list of external tools that can be executed against the file.
Properties Allows you to view the properties of the file (i.e. typically opens the Properties tool window).