JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

CodeSonar® 9.2p0 CONFIDENTIAL CodeSecure Inc

Task: Move Multiple Projects or Project Trees (or both)
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.

This task describes the method for moving one or more projects or project trees from one parent project tree to a different parent project tree.
If you only have one project or project tree to move, you may prefer to use the method described in Task: Move a Single Project or Project Tree.

Permissions Required

The following permissions are required for each single project or project tree that you wish to move from current parent project tree C to destination parent project tree S.

Destination Parent Project Tree

Before you can move the projects and project trees, you will need to decide on a destination: a project tree that will become the parent project tree for those projects and project trees. 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 Projects/Project Trees

To move multiple projects or project trees (or both) from their current parent project tree to a destination parent project tree S, proceed as follows.
(Note that the Move Projects button is also available, with the same behavior, on the Project Search Results and Home pages.)

  1. View the Project Tree page for the current parent project tree.
  2. Click the Move Projects button under the table of projects and project trees. The page will expand to provide more functionality, as shown below.

    screenshot fragment: expansion after clicking Move Projects

    Table rows The table contents will update to show
    • only those projects for which you have PROJECT_WRITE permission, and
    • only those project trees for which you have PTREE_WRITE permission.
    Note that these are only a subset of the permission requirements for moving: the full set of permissions will be checked before each move takes place.

    If there are no items to display, CodeSonar will display a message instead of the table.
    Note that table contents are still affected by the Visible Projects setting: you may need to change this setting in order to see the projects you want to move.
    Checkboxes The table now includes a column of checkboxes. Click in a checkbox to select the corresponding project or project tree, click again to deselect.
    Check/Uncheck Buttons
    Check All Click to select all projects and project trees in the table (including those on other pages of a paged table).
    Uncheck All Click to unselect all projects and project trees in the table (including those on other pages of a paged table).
    Check These N Click to select all projects and project trees on the current page of the table. The number N corresponds to the number of projects on the current page. (Only present if table has multiple pages.)
    Uncheck These N Click to unselect all projects on the current page of the table. The number N corresponds to the number of projects on the current page. (Only present if table has multiple pages.)
  3. Use the checkboxes to select the projects and project trees that you want to move.
  4. Enter the full path to the new parent project tree in the New Parent Path field (as described above)..
  5. Click the Move Selected Projects button to remove the project and project trees you have selected.

    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 for the selected projects and project trees.

    CodeSonar will print progress messages as it moves the projects and project trees. When it has finished, there will be a confirmation message for each item that has been moved, along with a Continue link.

  6. Click Continue to return to the Project Tree page.

Links

 

To report problems with this documentation, please visit https://support.codesecure.com/.