Disciplined source code changes, associated with valid tasks, increase stability, consistency, transparency and traceability in collaborative software development environments. When a managed repository is used (e.g. Git, SVN, Mercurial), codeBeamer provides links to show the associations between a Task-ID and SCM commits by default. This level of traceability can also be explicitly configured for external repositories. The script that enables the Task-Commit associations is called SCMLoop.
See Installing SCM Loop
In codeBeamer 5.5 you can now edit commits, see Tracing Source Code Changes to Requirements, Task and Bugs , and Version Control: Subversion (SVN), Git, Mercurial and CVS .
When the SCMLoop script is enabled, it will intercept the source code commits and will invoke CodeBeamer to associate the commits with a CodeBeamer tracker item (e.g. a task or a bug).
When SCMLoop is installed, either by default with a managed repository, or explicitly, you should use the following syntax in the commit messages, when committing changes to your SCM:
#1234 Fixed an NPE
where 1234 is the tracker item that you want the commit associate with. Enter (for example)
#1234, #3456,#4533 Fixed memory leak
where 1234, 3456 and 4533 are the tracker items that you want the commit to associate with. A space between the (,) and (#) is optional.
Entering (for example)
Fixed an NPE to resolve [BUG:1234]
will NOT associate the commit with any tracker item but
#1234 Fixed an NPE. See [BUG:5678]
will associate with tracker item 1234, and the text will have a Wiki link to 5678 as well.
The commit syntax with # is configurable by a regular expression in the
When SCMLoop is installed and enabled (see Installing SCM Loop , commits in the SCM commit action will require a tracker item (task, bug etc.) ID entered either from an IDE or from the SCM command line interface, together with the commit command.
CodeBeamer records the file name, file version, user name, and date/time in the CodeBeamer database and associates it with the tracker item having the specified ID. There is also a mechanism for browsing the SCM repository using CodeBeamer's SCM Web interface and see the tasks associated to each file.
Enabling a Task-Based Process for a Project
When SCMLoop is installed, the CodeBeamer server receives notifications on SCM commit actions. This can be enforced for any project by enabling the task-based process. When this enforcement is active, each commit action must be associated with a valid task. The advantage of a task-based commit process is the automated association between software changes (commits) and tracker items (task assignments, change request, bugs etc.).
Enabling a Task-Based Process
To enable a task-based process:
Open a project,
Click on Admin tab,
Click on SCM Settings,
Having the SCM system already selected, click on Set,
Select the Allow checkins/commits only with valid CodeBeamer Issue IDs check box,
Select the Allow checkins/commits only for members with SCM-Commit permission check box,
Click on Save.
Figure: Configuring task-based commit, and user commit access on the repository.
Allow checkins/commits only with valid CodeBeamer Issue IDs
When enabled, the commit action will be checked.
Allow checkins/commits only for members with SCM-Commit permission
Select to enable commits only for CodeBeamer project members with SCM access permission. When the check box is unchecked then the user of the commit action will not be verified.
Committing Actions from IDEs
Developers can associate commit actions from their IDEs, from the CVS or Subversion command line interface or from other clients e.g. WinCVS or Tortoise SVN. CodeBeamer provides deep integration with IBM Websphere Studio and with the Eclipse IDE, enabling developers to commit changes from their IDEs with associated tasks. From the IDE, you can associate one or more files with one or more items (n:n relationship) on commit actions.
Figure: Example Commit with Task ID from the CVS Command Line Interface
The following SCM commit history chart can be sorted by date, author, comment text or file.
Figure: SCM Commit History Chart
Accessing SCM Modules Associated with Tracker Items
In the tracker items summary viewer, the database icon is displayed when an item has associated SCM commits. In the following figure, the tasks or issues associated with commits (code changes) are shown with the SCM icon.
Figure: Tracker Issue Summary List
To view details on commit history click on an issue. The following figure shows a single Tracker Item, with the SCM Commits tab selected, to show the file changes associated with the Bug.
Figure: A Tracker Items' SCM Commits
Reassign Commits to Tasks
A privileged project administrator or the submitter of a Commit to a SCM Repository, can now edit commits listed in SCM Repository --> Browse Commits:
Figure: A Commit in an SCM Repository
Via Edit in the popup menu of a commit, you can open an editor screen, which allows you to change the comment and re-assign the commit to different CodeBeamer Tasks:
Figure: Edit the Commit in the SCM Repository
changing the commit information in CodeBeamer, not in the underlying SCM Repository. If you have set the SCM Repository Synchronization to "Checkout regularly all files from repository" or manually execute "Synchronize and reparse the project now", any changes made here will be overwritten with the old values stored in the repository.
Whenever possible, try to correct your mistake in the SCM Repository directly.