You can connect tracker artifacts with other CollabNet TeamForge items such as documents or topics. Creating associations between items enables you to define relationships, track dependencies, and enforce work flow rules.

Associate a Tracker Artifact with a Document, Task, Integrated Application Object, or Forum

When a tracker artifact is related to other TeamForge items, such as tasks, documents, integrated application objects, or discussions, you can connect the tracker artifact to the other item by creating an association.

Creating associations between items helps you to define relationships, track dependencies, and enforce work flow rules.

  1. Click Trackers from the Project Home menu.
  2. On the list of project trackers, find the tracker artifact with which you want to create an association. Use the filter if needed.
  3. Click the artifact title.
  4. On the View Artifact page, click the Associations tab. The list of existing associations appears.
  5. Click Add.
  6. In the Add Association Wizard window, select the items with which you want to associate the artifact:
    • ENTER ITEM ID - If you know the item’s ID, you can enter it directly.
    • ADD FROM RECENTLY VIEWED - Select one of the last ten items you looked at during this session.
    • ADD FROM RECENTLY EDITED - Select one of the last ten items you changed.
  7. Click Next.
  8. You may add a comment in the ASSOCIATION COMMENT text box.
  9. Save your work.
    • Click Finish and Add Another to add additional associations.
    • Click Finish to return to Details page.
  10. Click the Associations tab to view a graphical representation of all the associated items. Through the Association Viewer, you can choose to view associations in the form of a list or flip over to the Trace view to explore the layers of associations (including parent/child dependencies) laid out in a timeline. You can scroll across the Trace view by dragging the mouse over the association layer or use the ‘Previous’ and ‘Next’ arrows to view all the objects as events in a timeline.

While the Associations tab shows the count of the total number of associations, you can only view the most recent 500 associations when you click the Associations tab in case the artifact has more than 500 associations. You can, however, browse through the Association Viewer to view older associations.

You can click on each node on the graphical association viewer to filter and display the associated items in the table below the association viewer thus matching the number of associations provided on the selected node. For example, if the node that you select for filtering is having two associations on it, the table displays the two associated items as a result of the filtering process.

Associate a Tracker Artifact with a File Release

To track the source and resolution of a bug or a feature request, associate its tracker artifact with the file release in which it was discovered and fixed.

Tracker artifacts associated with file releases are also displayed separately, providing a simply way to track all issues that were discovered in or fixed in a specific file release.

  1. On the Project Administration page, enable both the REPORTED IN RELEASE and FIXED IN RELEASE fields.
    • REPORTED IN RELEASE - When submitting a new artifact, the user can choose from a drop-down list of all releases in the project to identify the release in which the issue was discovered.

    • FIXED IN RELEASE - After the issue is fixed, the user can choose from a drop-down list of all releases in the project to identify the release in which the issue was fixed.

  2. When submitting a new artifact, choose the release in which the issue was discovered from the REPORTED IN RELEASE drop-down list. The drop-down list shows all releases in the project, except those that are in pending status.

  3. After the issue is fixed, update the artifact by choosing the release in which the issue was resolved from the FIXED IN RELEASE drop-down list. The drop-down list shows all releases in the project, except those that are in pending status.

The associated tracker artifacts are displayed on the View Release page, in the REPORTED TRACKER ARTIFACTS and FIXED TRACKER ARTIFACTS sections.

Associate a Tracker Artifact with a Code Commit

When checking in files to your SCM repository, you can create links to one or more tracker artifacts or other CollabNet TeamForge items.

Associations track the links between code and the bugs, feature requests, or other tracker artifacts that the code addresses. You can also associate code commits with other TeamForge items, such as tasks or documents.

A project administrator can make associations mandatory for all code commits. When this is made mandatory, the following additional rules pertaining to code commit can also be set:

  • Code commits can be performed only for open artifacts.
  • To perform a code commit, the committer must be the owner of the specific artifact.

You can create tracker artifact associations from whatever interface you normally use to check code into your SCM repository. You do not have to log into TeamForge.

Use the same syntax for commits to CVS and Subversion repositories.

When making a code commit, add the associate command in the commit message like this: [<item id>], such as the TeamForge tracker artifact ID or task ID.

  • TeamForge item IDs are always letters followed by four or more numbers, such as task1029 or artf10011.
  • To associate a commit with multiple TeamForge items, separate the item IDs with commas.
  • All associations are displayed in the Associations tab of the Commit Details page.
  • The Comment section lists the comments made with each commit.