Using Git in the Eclipse IDE with the EGit Plugin
We assume a project is created in Codebeamer with a new bug added to a tracker.
Open your Eclipse IDE with EGit installed in it, and go to select > item, and look for > :
Figure: Create a New Project in Eclipse IDE
Click Next and setup SSH authentication data according to your settings:
Figure: Set Authentication Data to Clone Codebeamer Managed Git Repository
Click Next and then select which branch you would like to clone from (first time there is only 1 of them):
Figure: Select Branch(es) to Clone
Click Next to start procedure on last page a new project is generated in your workplace using Git.
Figure: Finalize Settings for Clone
Commit a Change to a Project
You can now make the changes and fix the issue in the source code. Those files which are changed but uncommitted are marked by a small white star icon. When your change is ready, commit it to your local clone. For this, you need not have a connection with the Codebeamer server: In the context menu (Package Explorer View), select the changed item or the parent of more changes, then select > (right mouse button):
Figure: Commit Changes to Local Project (local)
 | To correctly identify yourself as an author, set your Codebeamer account data to the appropriate field in the username <email@address> format. For more information, click here) |
| | Dont forget to associate your commit with an issue ID. Just add the issue-id to the beginning of the commit message like: #1234, #5678 (1 or more issue-ids). The Codebeamer project settings determine whether a commit is allowed or not when a valid issue ID isnt assigned. For more information see Tracing Source Code Changes to Requirements, Task and Bugs |
More changes can be committed to the project in the same way.
Push Changes to Codebeamer
When you are ready to share your work with other team-mates, local changes have to be pushed to Codebeamer server. Select > item from the context menu on project root and select the push target.
Select Codebeamer Managed Git Repository Target to Push Changes
Click Next and select Source Ref to select what you would like to push. Destination Ref selector will be automatically set to the most proper remote ref, but you can override it. Click Add spec which adds the defined ref-spec to the list below.
Select Refs for Push
You get a color coded explanation showing the result of the operation. Always read it carefully (tooltip also), because it might contain information about failure as well (e.g. a hook is rejected push because of unallowed author).
Result Screen of a Successful Push
After a successful push your changes are shared on Codebeamer, and the issue-association(s) is(are) made with the commit.
Create and Push Branch(es) to Codebeamer
Now create your own branch and share it with others (through Codebeamer). Select > and then click the New branch button, enter a name and click Done. To reflect your changes in the Eclipse GUI start a Checkout before leaving the branch dialog. No connection is needed with the Codebeamer server: Everything is performed on the developers machine. Make the changes on your branch; fix the issue in the source code etc. and commit your changes the same way as before (see above). These changes and the branch must be pushed to Codebeamer:
Push a New Branch and Changes to Codebeamer Managed Git Repository
You get a color coded explanation about the result of the operation. This is different from the result shown before in that the branch is now my-devel. Always check this dialog carefully (look at the tooltip too), because it might contain information about failure as well (e.g. a hook is rejected push because of a disallowed author):
Failure Screen of a Push
