Accessing third-party reports and applications

The Integrations page allows you to access information generated by third-party tools. In the default CollabNet Baseline Project template, the Integrations page provides the following:

Accessing TestDirector and related information

If your site is configured to interoperate with TestDirector, defects are uploaded from TestDirector to Project Tracker into a TD Defect (read-only) artifact type. Project Tracker automatically creates a copy of each TD defect using the Defect Report artifact type. 

A query of the Defect Report artifact types on this page searches the TD Defect ID attribute of every defect, and returns all defects that have a value for this attribute.

You can use the TestDirector page on the Integrations page to view these original TestDirector defects, and to work with the corresponding Defect Report artifacts. You can assign the Defect Reports to the appropriate stage in your project's lifecycle, add information to these artifacts, and process them as you would any other defect in Project Tracker.

The following procedures describe how to view work with defects and other TestDirector information.

To view TestDirector information on the Integrations page:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations page on the Page navigation toolbar or the Integrations > TestDirector for Quality Center link in the left navigation pane.
  4. In the activity area, click the link for the appropriate search.
    The activity area is either directly below the page navigation toolbar or at the top of the page. It is the area with a light blue background:
    View active defect reports - View artifacts of type Defect Report that have been copied from TestDirector Defects.
    View all defect reports - To view all artifacts of type Defect Report.
    View active TD defects - These are defects that were entered into the TestDirector product and have been uploaded to CollabNet. You cannot edit these defects, since TestDirector continually updates its data. If you want to create an editable version of these defects.
    View TestDirector reports - These are summary reports generated from TestDirector and uploaded to the CollabNet Environment.
    Launch TestDirector system - This is a link to the TestDirector product.

To assign a defect that originated from TestDirector to a particular subpage:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations page on the Page navigation toolbar or the Integrations > TestDirector for Quality Center link in the left navigation pane.
  4. In the activity area, click View active defect reports.
    The activity area is either directly below the page navigation toolbar or at the top of the page. It is the area with a light blue background
  5. Click the link for the defect report that you want to work with.
  6. Typically, you would set the Stage in Lifecycle attribute for this defect report to Code & Build.
  7. Enter other required information on this defect.
  8. Submit your changes.

Accessing and working with CruiseControl and related information

The following procedures describe how to upload and view build results, launch CruiseControl, and view the code base.

To launch CruiseControl or view the code base:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations page on the Page navigation toolbar or the Integrations > CruiseControl link in the left navigation pane.
  4. In the activity area, click the link for the appropriate search.
    The activity area is either directly below the page navigation toolbar or at the top of the page. It is the area with a light blue background:
    Launch the CruiseControl system - Launch the CruiseControl application.
    Go to code repository - This is a link to Subversion tool and is equivalent to clicking the Subversion link in the left navigation pane.

To view build results:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations page on the Page navigation toolbar or the Integrations > CruiseControl link in the left navigation pane.
  4. In the activity area, click View CruiseControl results - To view build results reports. These reports are uploaded to Subversion.

To upload build results:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations icon on the Page navigation toolbar or click the Integrations > CruiseControl link in the left navigation pane.
  4. In the activity area, click View CruiseControl results.
    The activity area is either directly below the page navigation toolbar or at the top of the page. It is the area with a light blue background.
  5. From the Build Results page, click Upload document.
  6. Locate the build results document that you want to upload and click Save.
    Note that this document is saved in the project's version control repository. If you want to rename or delete this document, you must use your version control client.

Reading and creating Testing and Build documentation

You can read testing documentation from a Documentation table on the Integrations page for TestDirector, and build documents from the Integrations page for CruiseControl. If you are responsible for authoring deployment process documents, you can download templates for these documents from this page and upload draft or final documents.

If you have a content developer role in the project (or have both VersionControl - Commit and VersionControl - Add permissions granted by an administrator), you can also add information to this page as well as view this page. However, the project owner administrator may prefer to take requests for additions to this page and be the sole person who actually performs the updates.

The Documentation table on this page contains a View other project documents link. Clicking this link is equivalent to clicking the Documents and files link in the left navigation pane.

Important: If you experience any difficulty uploading documents on this page, ask your project administrator to be sure that two Subversion integrations settings are turned off for the project. The administrator should click the project link on the Projects page, clickEdit project > Tool configuration, then turn off the Message must name artifact and Committer must own artifact settings in the Subversion section of the page.

To download a project document template from the Mercury or CruiseControl Integrations page:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations icon on the Page navigation toolbar and then the Mercury or CruiseControl page, or click the Integrations > TestDirector for Quality Center link or the Integrations > CruiseControl link in the left navigation pane.
  4. In the Process Documents section, click the View document templates link.
  5. Click the link for the template that you want to edit.
  6. Save this file locally and edit it.

To add or update a project document on the Mercury or CruiseControl Integrations page:

  1. Click the Projects page.
  2. Click the link for a project that uses a project template.
  3. Click the Integrations icon on the Page navigation toolbar and then the Mercury or CruiseControl page, or click the Integrations > TestDirector for Quality Center link or the Integrations > CruiseControl link in the left navigation pane.
  4. In the Process Documents section, click the Upload document link.
  5. Browse to the document that you want to upload.
  6. Click Save.
    Note that this document is saved in the project's version control repository. If you want to rename or delete this document, you must use your version control client.