Task: Create a New, Empty Project Tree

• Permissions Required
• Create a New, Empty Project Tree
• Links

Permissions Required

You will need the following permissions to add a new project tree as a child of project tree T.

• PTREE_READ T to access the Project Tree page for T.
• PTREE_ADD_CHILD T to add the new project tree to T.

Create a New, Empty Project Tree

To create a new project, tree proceed as follows.

1. If the CodeSonar Web GUI is not already open, open it now.
2. If you are not already signed into a hub user account that has sufficient permissions for this task, sign in now.
3. Decide on a name for the project tree.
   Note that project tree names must be unique: the new name cannot be the same as the name of an existing project tree for which you have PTREE_EXISTS permission.
4. Decide on a parent project tree for the project tree.
5. Navigate to the Project Tree page for the project tree you chose in the previous step.
   (If you are adding the new project tree as a child of the hub's root project tree, it is sufficient to navigate to the hub Home page.)
6. Click the Create Project Tree link under the page heading. The page will expand to provide more functionality, as shown below.

   

7. Enter the name of your new tree in the New Project Tree Name field.
8. Click Create.
   If CodeSonar successfully creates a new project tree, it will print a confirmation message above the page heading and update the table of projects and project trees to include the new project tree (note that the visibility of the corresponding table row will depend on your table pagination and table sort order).

   Otherwise, it will print an error message above the page heading to explain why creation was unsuccessful. Possible issues are:

   • You do not have permission to create a new project tree.
     If you believe you should have this permission, make sure you are signed in to your hub account. If you are signed in and still unable to create a new project tree, check with your hub administrator to make sure you have correct permission settings.
   • There is already a project tree with the specified name (and you have PTREE_EXISTS permission for that project tree).
     Retry with a different name.
   • You specified an empty name, or one that consists entirely of whitespace.
     Retry with a name that contains at least one non-whitespace character.

What Next?

You may wish to move one or more existing projects or project trees to be children of your new project tree.

• Move a single project or project tree to a different parent project tree
• Move multiple projects or project trees (or both) to a different parent project tree

Links

• Typical CodeSonar Tasks
• CodeSonar GUI Reference