Using Mercurial in Eclipse with the MercurialEclipse Plugin
Perform the following steps to use Mercurial in Eclipse:
1. Create a Bug/Task item in Codebeamer: remember the item's id highlighted on this screenshot:
2. Open your Eclipse IDE with Mercurial Eclipse installed in it, and go to Java perspective. Select > item from the context menu, then look for > :
3. Click Next and setup the URL and authentication data according to your settings:
4. After clicking Finish to start the clone process, a new project is generated in your workspace using Mercurial.
Commit a Change to the Project
To correctly identify the author, MercurialEclipse must be configured using > > . Set the Mercurial Username field to the Codebeamer user as:
Edit the source code to fix the issue. The files which are changed but uncommited, are marked by a small icon (white star). When your change is ready, commit it to your local clone. This doesn't require any connection with Codebeamer server. Select > item from context menu on the changed item (or the parent of more changes):
 | We recommend that you associate your commit with an issue ID. Do this by adding hash (#) issue number to the first line of the commit message. For example, #1234, #5678 are two issues that can be associated with a commit. If a commit is made without a valid issue ID, Codebeamer project settings determine whether it is allowed. |
Several commits can be made for the next step, pushing to Codebeamer.
Push Changes to Codebeamer
When you're ready to share your work with the team, your local source code changes should be pushed to the Codebeamer server. The push URL might differ from the clone (or pull) URL. Select > item from context menu on project root, give URL and authentication data (ssh is used as push URL in our example):
You will get a short explanation message about the result of the operation. Always read it carefully, because it might contain information about failure as well (e.g. a hook is rejected push because of unallowed author). After a successful push your changes are shared over Codebeamer and you can check the association between the commits and their related issues:
Setup SSH on the Windows Platform
Additional setup is necessary on the Windows platform to use the MercurialEclipse plugin via SSH: read more about it in Mercurial Client on Windows.