Scheduled maintenance 2023.06.01. 07:30 CET
|Managing Projects #11125/HEAD / v13639|
Table of Contents
The Project Browser is a visual interface for viewing and navigating between projects and for managing project groups. The sub-menus under the Projects menu point to this page.
Note that it is possible to restore the old project list format (used before codeBeamer 7.4.0) and disable the new Project Browser. You can do this by adding the following line to the Application Configuration:
Structure of the Project Browser
The Project Browser is divided into two panels. On the right side you can find the projects. There are four tabs on this panel:
Managing Project Categories
Administrators with proper permissions can create project categories on the left side of the page. They can use these categories to represent a hierarchy of concepts.
The user must be member of a User Group that has the Project Category Admin permission.
Managing Project Categories
Click on the plus sign to create a category with a default name, or type a name in the text box and press Enter. It is not possible to create multiple categories with the same name.
It is possible to rename or delete a category using the drop-down menu. Note that deleting a category, which has child categories, deletes the whole sub-tree.
Drag the category to a new position to build a tree hierarchy. Dragging the category slightly to the left / right moves it to a lower or upper level in the tree.
Example 1. : Moving a category to the root level
Example 2. : Moving a category to a lower level
Example 3. : Moving a category to an upper level
Assigning Projects to Project Categories
There are three different options:
Managing Project Category Views
Administrators can select multiple categories and save this selection as a standalone view. These views are public, any user can access them. When activated, users only see the projects which are assigned to a category contained within the view.
Same as in the previous section.
Creating Project Category Views
Select the project categories first:
After that open the drop-down next to the Current View label:
Finally type a unique name in the text box and save the view:
Activating a Project Category View
Click on the small folder icon:
Then click on the view in the popup:
Deleting and modifying Project Category Views
When a non-default view is active, then the drop-down menu has an additional menu option to delete the view:
When you modify the view, then the Save button becomes active in the toolbar.
Filtering on the Project Browser
On the left panel, there are several filters. First of all, you can filter the project cards by name. Just start typing in the text box, and the cards that do not match the text will disappear.
Another filtering option is by color. You can switch between the coloring modes (see later) and then use the checkboxes to hide/show project cards with the given color:
You can also find on the left panel the New Project link and the export to excel icon. The export will save to an excel file the details of the projects visible on the Projects tab.
Anatomy of a card
In the Project Browser each project is represented as a card:
Cards have the following parts:
The arrow icon in the top-right corner (visible only when the mouse is above the card) opens an overlay showing some details (issues created, releases, recent activity, and so on) about the project:
Color, size and project icon
Each card has a color and a size. By default, all cards are blue and small sized. You can change this using the context menu:
You can choose from three predefined sizes and a couple of colors. These dimensions and colors have no predefined meaning: you can set them based on your preferences. The colors and sizes set on one tab are the same on all other tabs, but are only visible for the user who set them - other users can set other colors and sizes.
There is another way of changing the status color of a project card: through the project status field. This is only editable by project admins and can be set on the Admin page:
Here you can select only from three predefined colors. This color setting is the same for all users who can access the project.
It is possible to color the cards based on two properties: user defined colors and project status. You can switch between these two modes using the color switch on the left panel:
When you click on Project Status, the card colors will be set based on the project status. When you click on My Colors, you will see the colors defined by you.
The icon displayed on the card is also configurable. It can be set by project admins on the Admin page of the project:
Here you can select one from the many predefined icons and you can also upload your own 32x32 icon.
The context menu of a card
The context menu of a card contains the following items:
Organizing Project Groups
To keep the project organized you can change the order inside a category or a project group. You can simply reorder the project with Drag n' Drop (moving the cards with the mouse cursor). This order is only visible for you - other users probably will set some other order.
You can also update the category of a project or you can move it to an other project group. Just drop the card to an item in the category/project group list on the left panel:
And finally you can update the order of the project groups. By default they're sorted by name. You can change this by moving an item up or down in the list:
Managing Project Groups
On the Project groups tab you may want to manage your project groups. There are three basic operations you can do here.
You can create a new Project group. For this, you have to either click on the + icon before the project gropus:
This will create a new project group at the beginning of the list.
Or you can click between any two project groups to create a new set between them:
The second thing you can do on this page is adding a new project to a set. This can be done by clicking the + icon in behind the name of the project group. This will open a new overlay where you can select the projects you want to add to the set:
To remove a project from the project group click on Remove from set in the context menu of the card.
Finally, you can remove a project group comletely. To do this click on the x icon after the name of the project group.
Since project groups are completely private the above operations won't affect the other users.
Creating New Projects
To create a project you should be logged on the server and you must have Create Project group permissions (see Managing Groups).
To create a project:
The first page of this wizard is where you choose if you want to create a new default project, or copy or inherit many options from other existing template projects. This dialog looks like:
Figure: Create New Project wizard starting Dialog.
Creating Blank Projects
If you select the "Create a new project" without selection a template then the next dialog will appear where you can name your project.
Creating Projects by Using Template Projects
Alternatively on the 1st page of the wizard you can choose to copy great many options from an already existing template project. If you have choosen that option and picked the otherproject to copy from then this wizard page will appear next:
This page contains the many options and artifacts (Tasks, Bugs, Requirements etc...) which can be copied or inherited from the selected template project.
By carefully choosing between options you can save great amount of configuration work by copying or inheriting artifacts from the template project. Please read the explanations on this page about the detailed meaning of each option.
Creating Projects from Smart Templates
A Smart Template is a project template that contains predefined trackers, workflows and documents. Codebeamer comes with several Smart Templates that you can use to set up an environment for evaluation purposes quickly:
You can also create your own Smart Templates by exporting existing projects. This way you can reuse your artifacts several times, even between different codeBeamer instances. To export a project go to the Admin page of the project and click on Export under the General tab.
Final Steps: Adding Repositories to New Projects
As next step(s) of the wizard you have the option to create a new SCM (git/mercurial/subversion) repository in the new project. This is the same process as creating a new SCM repository, and it is optional during the project creation, because you can freely add new repositories at any time later.
Managing Project Members
When you create a project you will probably want to add other users to it in order to set up your team. Users added to your project become project members. To organize members into your team structure, you have to assign the right roles to each member.
Assign Roles to Members
A good practice is to set up the project roles (or custom roles) in advance when your project has been created by enabling the appropriate role access rights. Later on, when your team is finalized members can be assigned roles.
To Edit the Members List
Figure: Accounts and Roles dialog
Figure: dropping a user to a role
Project Admins can export to the members and the groups of the project to Excel. To do this just click on the Export Members quick link on the members page. This will download an Excel file with two sheets. The first sheet lists all the users of the project, while the second one lists the groups.
Assign Groups with Roles
You can assign a group with a role instead of assigning individual members. A group - which is a collection of users - can map to your organizational structure. For example, if you want to assign people from the sales or marketing departments to your project, you can create a guest group for them, and assign the guest group to the My guest role in the project. The My guestrole should have sufficient privileges to access the document manager, the Wiki and the forums, but you can prevent them from using the Trackers and from accessing the source code in your SCM system.Groups can be administered only by the System Administrator. See Managing Groups.
You can add groups to roles by clicking on the New Member link, where you can select a group instead of a role:
Figure: Roles and Groups Dialog.
Please see Administering Projects
Assigning SCM Repositories to Projects
To assign an internal, managed SCM system to the project, see Administering Projects.
To assign an external SCM system to the project, see Administering Projects.
codebeamer Knowledge Base
Services by Intland Software