Configuring project tools

Configuring project tools

As the Project owner, you can select and configure the project tools that are appropriate for your project. The configuration settings available to you depend on site defaults that are set by an administrator.

• When you use a project template, you override the global defaults set by the site administrator and establish your local settings as the values to be used for your project.
• If you create a project without a project template, your project's settings change whenever a site administrator changes the defaults.

Any explicit setting by any project permanently overrides any inherited value. For example, if integration between Project Tracker and version control is turned on by default, you may create a project that makes use of this feature. However, if you do not configure the default behavior from the Tool Configuration page, a site administrator can disable the integration feature and it will cease to work for your project.

To override site-wide default settings for a project:

1. Log in to the CollabNet platform.
2. Select a project link.
3. From the project home page, click Edit project.
4. Under the Other Operations heading, click Tool Configuration.
5. Optionally, make changes to the settings.
6. Click Save Settings .

Project Navigation

The Project Navigation section controls the vertical navigation bars at the left of the screen. You have two options:

• You can turn the Project tools links on or off.

  The Project tools links provide access to the development tools that you have enabled for the project.

  Note: If this option does not appear, your domain administrator has turned it off by default.

• You can turn the Project pages links on or off.

  The Project pages links connect to the pages and subpages you create to manage your project work items.

Version Control: this section will only appear if Project Tracker is the tracking component for this project.

Project Tracker integration

Selecting this will provide a comment in each artifact associated with a commit in the Version control tool. To associate an artifact with a commit, the artifact number must be added to the commit message. This simplifies tracking changes to the source code through the tracking component.

Message must name artifact

Selecting this will force every user to add at least one artifact number to each commit message. Using this in conjunction with the Project Tracker integration option will allow you to easily identify code changes made in relation to specific artifacts.

Committer must own artifact

This option will verify that each artifact mentioned in a commit message is owned by the user making the commit. Issue owners then become responsible for verifying the validity of a commit before it is added to the version control repository. This option is only applicable when the Project Tracker integration option is selected.

Documents & files

Maximum file upload size

Your domain administrator or host administrator has set the upper size limit of items added to the Documents & files tool.

Offer to lock new documents

Users who reserve documents for editing can lock the files from edits by others.

Project Tracker: this option will only appear if Project Tracker is the tracking component for this project.

Enable email

Once activated, email messages will be sent when a change is made to an artifact.

Detailed email

This option will put the full content of any changes made to an artifact in an email. Be aware that sensitive material entered in a Project Tracker artifact will be sent in the email.

Discussion forums

Maximum attachment size

You can limit the acceptable size for any attachment to a discussion forum.

Send posting subjects

Selecting this will add the forum posting subject to the subject line of any notification emails sent to the end user.

Send posting bodies

Selecting this will add the forum posting body to the body of any email sent to the end user.

ETL

Enable data harvesting

Selecting this option will enable the "Extract Transform Load" (ETL) mechanism to harvest data for the Tracker metrics tool. Note that when you disable this setting for your project, you will not be able to generate Tracker metrics reports.