Project Set Editor

Overview Editor

The project set editor (PSF editor) is used to edit project set files. It has three areas

• The table at the top shows the content of the project set
• The area at the bottom shows details about the project set entry that is selected in the table
• On the right side are the buttons for manipulating the project set

Description of the content table

The table show the entries of the project set. It has the following columns:

• Name: The icon, name and repository information of the currently loaded project. Only the name if the project is not loaded.
• Tag: The tag of the project in the project set. For CVS as team provider this is HEAD or the name of the version or branch
• Preferred Path Problems: If there are problems concerning the preferred local directory they will be shown in this column. Possible problems are:
  • The specified preferred local directory has undefined path variables
  • The project is not loaded to the preferred local directory
  • The preferred local directory is the same or inside an other preferred local directory
  • Different preferred local directories are specified for one project (only possible when using Project Set Projects).
  The column displays the icon
  • when the entry has a path problem
  • when a sub entry has a path problem
• Tag Conflict: Shows the conflicts if a project is referenced in different versions inside a project set (only possible when using Project Set Projects)
. The column displays the icon
• when the entry has a tag conflict
• when a sub entry has a tag conflict
• State: Displays the state of the project entry. The possible states are
  •  Loaded = the project is loaded with the tag specified by the project set
  •  Not loaded = the project is not loaded in the workspace
  •  Loaded different = the project is loaded with a different tag than specified by the project set
  •  Loaded not shared = the project in the workspace is not shared
• Provider: The team provider for the entry. To improve clarity this column has the width zero, but can be resized if required.
• Server Location: The server location for the entry. To improve clarity this column has the width zero, but can be resized if required.

The context menu in the table shows the same actions as on the right side of the editor. If the project is loaded then actions normally associated with projects such as "Compare with" and "Replace with" are also available. The additional actions apply to the loaded version of the project!

Description of the details area

The area below the table shows the details of the selected entry.

At the top of this area the name of the selected entry is shown.

In the next line there is an entry field for editing the preferred local directory for the entry. An empty entry means that the default location in the workspace directory will be used. It is only editable for root entries. Sub entries must be edited in the project set that directly contains them. The buttons beside the entry field have the following funtionality:

• Browse: Opens a file browser for selecting a local directory
• Current: Sets the preferred local directory to the directory in which the project is currently stored
• Add Var: Opens a dialog for selection of a defined path variable and inserts the selected variable. (The variables must be defined at the preference page)

The two areas at the bottom display more details for the selected entry and the loaded project. The areas can be hidden and shown by clicking the blue triangle beside the area header. The preferred local directory is here shown with the resolved path variables. Differences between the entry and the loaded project are marked in red.

Description of the buttons

The buttons for the possible actions on the right side of the editor.

• Add shared projects to set: Opens a dialog to select projects that should be added to the project set. Only shared projects that are not already in the project set are listed
• Remove selected: Removes the selected project(s) from the project set.
• Set selected to loaded tag: Set the tag of the selected entries to the tag the project has in the workspace
• Load/Replace selected: Load or replace (if already exists) the selected projects with the tag specified in the project set
• Load/Replace all: Load or replace (if already exists) all projects of the project set with the tag specified in the project set
• Open included PSF: Opens a new PSF editor for the project set file of the selected project set project

The buttons for manipulating (add, remove, change tag) are disabled if sub entries are selected. These entries must be changed in a PSF editor for their direct parent project. The load/replace buttons are disabled if an entry and its parent are selected.

The checkbox "Load/Replace recursively" determines whether the projects will be loaded recursively if one of the two "Load/Replace" buttons is clicked. The default state of this checkbox can be set in the preference page for the project sets.

Saving the project set

By pressing <CTRL> and "s" or selecting "Save project set" from the context menu anywhere in the editor the project set is saved. Also when closing the editor you will be asked if the changes should be saved to the project set file.