Task: Move a Single Project or Project Tree
To a Different Parent Project Tree

Projects and project trees are organized into a single overall project tree hierarchy.

From time to time, you may wish to change the organization of the hierarchy and move projects and project trees around by changing their parent project trees, as described here.

These tasks describe the methods for moving a single project or project tree. If you wish to move multiple projects, project trees, or both, see Task: Move Multiple Projects or Project Trees (or both) .

Permissions Required

The following permissions are required in order to move a single project or project tree in the manner described here.

Element Moved to Destination Parent S Permissions Required
project tree T
project P

Destination Parent Project Tree

Before you can move a project (project tree), you will need to decide on a destination: a project tree that will become the parent project tree for that project (project tree). This project tree must already exist on the hub (you cannot implicitly create a project tree by specifying it as a parent).

As part of the move procedure, you will specify the path to the destination project tree. This must be the full project tree path: a /-separated sequence of project tree names, with a leading / representing the root project tree.
For example:

/ The root project tree.
/TeamA A project tree named TeamA, whose own parent is the root project tree.
/TeamA/SubteamB A project tree named SubteamB, whose parent is TeamA; the parent of TeamA is the root project tree.

Move A Single Project

To move a single project:

  1. View the Project page for the project you wish to move.
  2. Click the Project Details link under the page heading.

    screenshot: analysis page with location of show logs link marked

  3. Click the edit link on the Parent Path line of the expanded section.
    screenshot fragment: description editing form expansion
  4. Enter the full path to the destination parent project tree (as described above).
  5. Click the save button.
  6. If there are multiple project trees that match the specified path and for which you have PTREE_EXISTS permission, CodeSonar will display a table of the matching project trees and ask you to select one.
    (Otherwise, the move will take place without this step.)
    1. Click the Use This One button corresponding to the project tree that you wish to set as the new parent.

    Once it has moved the project, CodeSonar will print a confirmation message and a Continue link.

Move A Single Project Tree

The procedure for moving a single project tree is very similar to that for moving a single project. The only difference is the location of the functionality.

To move a single project tree:

  1. View the Project Tree page for the project tree you wish to move.
  2. Click the Project Tree Details link under the page heading.

    screenshot: analysis page with location of show logs link marked

  3. Click the edit link on the Parent Path line of the expanded section.
    screenshot fragment: description editing form expansion
  4. Enter the full path to the destination parent project tree (as described above).
  5. Click the save button.
  6. If there are multiple project trees that match the specified path and for which you have PTREE_EXISTS permission, CodeSonar will display a table of the matching project trees and ask you to select one.
    (Otherwise, the move will take place without this step.)
    1. Click the Use This One button corresponding to the project tree that you wish to set as the new parent.

    Once it has moved the project tree, CodeSonar will print a confirmation message and a Continue link.

Links