Project Explorer view

The Project Explorer view displays a hierarchical view of all resources (projects, files, folders, etc) in the workspace. For each project, its folders and files are shown in the tree. From this view you can open files in the editor view, create new resources, manage existing resources (copy, cut, paste, move, rename), and import/export resources.

Files that you select in the Project Explorer view affect the information that is displayed in other views.

For C/C++ projects, you can also do the following:

Toolbar

Button Name Description
Minimize Minimizes the view.
Maximize Maximizes the view.
Collapse All Collapses all elements in the tree down to the top level elements.
Link with Editor Toggles whether to link to the active editor. When enabled, whichever resource is open in the editor will be selected in this view.
Menu Click the black upside-down triangle icon to open a menu of items specific to the view.
Top Level Elements
Choose whether to show projects or working sets as top level elements. Choosing working sets allows easy grouping of projects in large workspaces.
Select Working Set
Opens the Select Working Set dialog to select a working set for the view.
Deselect Working Set
Deselects the current working set.
Edit Active Working Set
Opens the Edit Working Set dialog to allow changing the current working set.
Customize View
This command allows customization of view filters and content modules. The previous will allow you to suppress the display of certain types of files while the later will allow entirely new types of content to be shown in the view.
Link Editor
Toggles whether to link to the active editor. When enabled, whichever resource is open in the editor will be selected in this view.

Context menu

Command Description
New Allows you to create new resources in the workspace. Many types of resources can be created.
Copy/Paste/Delete/Move/Rename Performs the specified action on the resource.
Import/Export Allow you to import and export resources to/from the workspace.
Clean Project Runs the project's clean command, as specified in the project properties.
Build Project Runs the project's build command, as specified in the project properties.
Refresh Looks for any changes to the selected resource and its children. This is useful if you make a change to resources outside of the workbench.
Close Project Closes the selected opened project. Closed projects will be ignored by the workbench.
Close Unrelated Projects Closes all projects not related to the selected project.
Open Project Opens the selected closed projet. The project will become available to you and the workbench again.
Remote Reconciler Click the Remote Reconciler context menu to open a menu of items related to synchronizing your local projects with one or more remote locations. These menus allow you to perform actions that are also available when you open the Remote Reconciler view, but directly from the Project Explorer view:
Synchronize with <current context>
<current context> is the remote context set as [current] in the Remote Contexts view.
Refreshes the view, looking for local and remote changes to the project resources.
Push/Pull Settings
Lists the settings available for synchronization with remote resources. These settings are also available when you open the project preferences and select the Remote Contexts page, but directly from the Project Explorer view.
Configure Automatic Remote Refresh...
The default Remote Refresh Interval (in seconds) is set to 0. A zero setting indicates that no automatic refresh is done. Change the setting, for example to 10 to indicate that you would like to looking for local and remote changes to the project resources every 10 seconds.
Push on Save
When enabled, the resource will be pushed every time a save is performed on the resource to the <current context>.
Push to All Contexts
When enabled, the resource will be pushed every time a save is performed on the resource to all contexts available for the project. Push on Save must be enabled to enable Push to All Contexts.
Push on Build
When enabled, the resource will be pushed every time a build is launched for the project. Also check Project > Build Automatically setting to set the automatic build option for the project. Push on Build is not available for C/C++ or IBM i projects.
Pull on Remote Update
Pulls all files in the remote location of the project into the project when a remote change is refreshed. Certain file types are ignored for download. These can be changed in the Remote Reconciler preferences. Note that with this setting, when a remote change is refreshed, the resources are automatically synchronized. A remote change is refreshed when one of the following is triggered:
  • A setting in Configure Automatic Remote Refresh....
  • Selecting the Refresh Remote right click menu.
  • Pressing the
    Refresh the resources in the view, ensuring that there are remote counterparts view toolbar button.
Push to <current context>
Pushes selected resources with pending local changes to the remote context set as [current] in the Remote Contexts view.
Pull from <current context>
Pulls selected resources with pending remote changes from the remote context set as [current] in the Remote Contexts view.
Replace Remote
Replaces the remote file with the local copy. This option is only available at the file level when there is a pending local change or conflict.
Replace Local
Replaces the local file with the remote copy. This option is only available at the file level when there is a pending remote change or conflict.
Show In
This menu allows you to show your selected resource in the selected view as follows:
Remote Reconciler
Selects the local location of the resource in the Remote Reconciler view.
Remote Contexts
Selects the <current context> of the project in the Remote Contexts view. This is only available at the project level.
Remote Systems
Selects the remote location of the resource in the Remote Systems view.
Remote Contexts Click the Remote Contexts context menu to open a menu of items related to remote contexts available for your project. These menus allow you to perform actions that are also available when you open the Remote Contexts view, but directly from the Project Explorer view. This menu is only available at the project level.
<current context>
context list
<current context> is the remote context set as [current] in the Remote Contexts view. The <current context> is displayed at the top followed by any other contexts if any have been added to the project. The icon for the <current context> is displayed as selected. Selecting a context that is not the current context will make it the current context.
Create Context...
Allows you to create a new context to add to your project.
Add Context..
Provides a list of all the remote contexts available for the remote connection as can be seen in the Contexts subsystem of the remote connection. Selecting a context will add the context to the project.
Show in Remote Systems view Selects the remote location of resource in Remote Systems view
Software Analyzer Allows you to configure you project for performance tuning. This is only available with remote C/C++ development tools.
Associate local location... If you already have a remote project, you might wish to associate a local location with the project in order to facilitate the use of local tools such as source control systems with your project code. Such local tools will then be able to see a local copy or version of your files and then operate on that copy or version. This will bring up the Associate Local Location Wizard.
Associate Local Location Wizard
By default, the local location will be inside your local workspace. You may select another location if you choose by unchecking the "Use default location" checkbox and selecting a different location. Once you have selected a location and configured your synchronization options, hitting Finish will convert the project to use that location, and transfer any files to the local system if required.
Remove local location... If you already have a local location associated with a remote project, you can remove the local location in order to work with your project in a purely remote manner only. This will bring up the Remove Local Location Wizard.
Remove Local Location Wizard
The wizard will show you the list of projects for which it will remove the local location. Check or uncheck these projects as desired, and then hit Finish. These projects will then no longer have local locations associated with them.
Run As Allows you to launch an application.
Debug As Allows you to launch an application for debugging.
Team Menu items in this sub-menu are related to version control management, and are determined by the version control management system associated with the project.
Compare With Commands in the Compare With sub-menu allow you to do the following types of compares:
  • Compare two or three selected resources with each other
  • Compare the selected resource with local history. This shows all changes you have made to the resource.
  • Compare the selected resource with the versions in the version control management system.
Replace With Allow you to replace the selected resource with another from local history or, if the project is under version control management, there may be additional commands to replace with a version from the version control management system.
Restore from Local History Opens the Restore from Local History dialog, which can be used to restore the project to a previous state.
Properties Opens the Properties of the selected resource.

Feedback