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 CollabNet TeamForge items, such as tasks or documents.

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 CollabNet TeamForge.

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

When making a code commit, add the associate command in the commit message like this:[<item id>], such as the TeamForgetracker artifact ID or task ID.
  • TeamForge item IDs are always letters followed by four or more numbers, such astask1029orartf10011.
  • To associate a commit with multiple CollabNet TeamForge items, separate the item IDs with commas.
  • All associations are displayed in the Associations section of the Commit Details page.
  • The Comment section lists the comments made with each commit.
Note: To associate an object in an integrated application, use the[<prefix_objectid>]format. Each integrated application displays its prefix on moving the mouse over the application name.
Tip: To remind yourself of the details of the association later, look in the Change Log tab of the associated Artifact Details page.


  • 0
    Red Byer

    How do you associate an already existing commit with a tracker?  (Say, someone didn't make the link correctly on check in?)   I have tried commit ID as the object ID but this does not work.  Specifically talking about git integrated with CloudForge and TeamForge here.

Please sign in to leave a comment.