Compass Version 1.3

Project Administration

Projects in Compass allow administrators to group common build plans and user groups together into logical groups. Typically a project consists of all members of a development team that work on the same code base along with all of the build plans that execute tasks with that code base. Projects are created and managed on the Administration page in the 'Project Administration' Section. This section looks like this:

Creating a New Project

As you can see, there is a button at the bottom of this section for creating a new project. To Create a new project, click the 'Create Project' Button and the create project dialog appears. A dialog asking for the name of the project is brought up and after entering a valid name and clicking 'Create' the new project is created and added to Compass. The project name is the only requirement for starting a new project; and once it has been created it will be added to the project list table, like 'Compass Demo' is shown above.

Deleting Projects

To Delete a project, select the checkbox on the line for the project you want deleted. Then click the 'Delete Selected Projects' button and after confirming the deletion, Compass will delete the project and remove it from the project list table. Compass also cleans up all build output and build history when a project is deleted. Any files that wish to be maintained must either be downloaded and saved prior to a project being deleted, or the project must not be deleted.

Setting Users' Project Permissions

On the Compass Administration page there is a section for managing user permissions called User Administration. From this section, each user's permissions can be set for each project. However, when adding a block of users to a project this is painstakingly slow, so in Compass version 1.1 user permissions can also be set on a per project basis for added conveinence. For each project, administrators can click on the 'User Permissions' button for each project to bring up the project permissions dialog:

On this dialog, all users are listed in a paginated table and their project access level is specified for both regular user level access and project administrator access. site-wide Administrators can make all Compass users have user level access to a project by clicking the 'Select All Users' button and then clicking 'OK'. Likewise, site-wide administrators can make all Compass users have project admin access by clicking the 'Select All Admins' button and clicking 'OK'.

Project Setup and Detailed Administration

To set up a new project, or to modify an existing project, Administrators can click on the project name in the project list table. This will navigate the user to the Project Admin page. On this page administrators can create and modify build plans, view the project build history, schedule builds, and set project configuration options. See the Project Admin page documentation for more information on howconfigure a project.