Intland's free requirements, development and test management hosting.
This server hosts 100.000+ users on the cloud!

codeBeamer Eclipse Studio Tutorial

This is a quick tutorial to teach you how to work offline with codeBeamer Eclipse Studio.
Note: this is intentionally kept as concise as possible, and assumes some basic understanding of Eclipse, Mylyn and Mercurial.


Installing the Tools

You have to start with installing the following tools:
  1. You can install codeBeamer Eclipse Studio easily with Eclipse Update.
  2. You can install HgEclipse also in a minute.
  3. Downloading codeBeamer and installing it is straightforward, too. Just follow the instructions of the setup wizard.

Launching a New Collaborative Project

Now you are ready to start your new project:
  1. Login to codeBeamer (CB from now).
  2. Click the Projects tab. Click New Project and fill in the details.
  3. Click Source Code and choose Mercurial as your SCM System. (If you have some existing code, you can easily import it uploading a Mercurial bundle via the web interface.)

When the project is created, add some tasks that you will work on offline:

  1. Click the Trackers tab and choose the Task tracker.
  2. Submit some issues, and assign them to your own user account.
To learn more about the project collaboration features available in CB, codeBeamer Knowledge Base is your best resource.

Importing the Project to Eclipse

First clone your own repository of the code, and import the project to Eclipse:
  1. Click File, New and choose the Clone Existing Mercurial Repository wizard. Enter your user credentials and the pull URL of the repository, and submit the dialog. (To figure out your pull URL, open up your browser, login to CB, choose your project and click the Source Code tab. The URL will be in the top part.)
All right, at this point the code is already on your computer.

Importing Tasks to Mylyn

Now bring your tasks to Eclipse, or to be precise, to its task management plugin called Mylyn:
  1. Open the Planning perspective in Eclipse.
  2. Open the Task Repositories view, and create a new task repository of the CodeBeamer type. (Your CB server URL is http://localhost:8080/cb by default.)
  3. Open the Task List view, and create a new query. Select the previously created task repository in the first step. Then select your new project, the Task tracker and check Assigned to me. Click Finish.
Your tasks will now appear in Eclipse. For more information on Mylyn, you should start reading here.

Working Offline

Here is where the fun starts. You can go completely offline now.
  1. Activate the task you want to resolve in the Task List view.
  2. Start coding, and commit your changes using the Synchronization View. (Note: the default commit messages offered by the system will contain the ID of the related CB issue. It's a good idea not to leave the reference there, because CB will associate your change sets with your issues, opening up a lot possibilities later.)
  3. Activate another tasks, and work that. Commit these changes, too.


When you are ready to publish your changes back to CB you need to come online again.
  1. Code: switch to Synchronization View and push your source code change sets to Mercurial.
  2. Tasks: simply let the Task List view synchronize with server automatically in the background. Or, if you are in a hurry, select a set of tasks and click Synchronize in the popup menu.


It's that simple! Now you are ready to work offline, on the plane, on your customers' site or on the beach. We suggest learning more via these links:

Happy coding!

Other Tutorials

Chinese Translation

Read the Chinese translation of this article.