The Source Module brings a code repository directly to your projects. It allows code browsing, version comparisons and checking of the repository history. Additional functionalities, such as links between Tickets and Commits, Commit commands and more are also available.

At the moment, Source module can access only Subversion repositories.

1. Creating a Repository

When you start working with activeCollab's Source Module, the first thing you'll need to do is tell activeCollab where your repository is and how to connect to it. The number of repositories per project is unlimited, so you can have as many repositories as you want.

When adding a new repository you need to:

  1. Set the repository's name;
  2. Enter the root path to the repository (repository URL or direction);
  3. Type in your SVN password and username;
  4. Set how frequently do you want activeCollab to check for new revisions.

To check if your parameters are correct and ensure that activeCollab can reach the defined repository, use the Test Connection button.

Source Module configuration

You can find step-by-step instructions on how to set-up the Source Module in the activeCollab Tutorial, which is found the Configure Source Module article.

After you complete all of these tasks, click on the Submit button at the bottom of the page and your repository connection will be added to the project.

On the Source page, a list of all repositories will be displayed together with a graphical view of activities:

When entering a repository page you will get a preview of all commit messages grouped by date. By default, activeCollab only displays commit messages and the number of modified files, but you can also display paths of all added, modified and deleted files and folders for that commit with a single click by clicking the Show all paths button.

2. Browse Code and Commit History

Once a repository is created and configured, you will be able to browse through and see all folders and files within it:

By clicking on a file, you can see a history of all revisions to it, as well as being able to view all previous versions of that file and compare them. This can be done with the Revision Comparison tool, which marks new lines of code in green and deleted lines in red.

All files can also be downloaded in their original format.

3. Commit Messages

activeCollab can also parse commit messages and:

  1. Link Commit with Tickets, Tasks and Milestones. Recognized formats are: Ticket #ID, Task #ID and Milestone #ID where ID is the actual ID of that object.
  2. Close Ticket, Tasks and Milestones. The following formats are recognized: Complete Ticket #ID, Completes Ticket #ID or Completed Ticket #ID. These commands are also available for Tasks and Milestones.
  3. Display commits in the Ticket they are related to. The commit tab will allow you to see and access all files that are linked to that Ticket.