Skip to content
This repository has been archived by the owner on May 14, 2018. It is now read-only.

3. How to Pick a Git Commit and Link it to a Work Item in RTC

Jump to bottom
Laura Schneider edited this page Nov 13, 2017 · 2 revisions

  • Open the desired Work Item. You can also create a new Work Item but you have to save it once. It is only possible to add Git Commits to already existing Work Items.

  • Click the Git Icon at the top.

⚠️ If the Git Icon is grayed out, you have open changes in the Work Item. You must first save this changes with the Save button.

Git WI Editor Button

  • Error if no GIT Repository is defined. To register a GIT Repository, see here.

Error No Repository

  • (Optional) If there is more than one Git Repository defined in the Project Area, you have to select the desired Git repository in the list of registered Git Repositories

(If you have only one valid repository registered, this step will be skipped)

Git Repo Selector

  • (Optional if access token is not already saved) Enter your GitLab access Token for: <server name>

    • Personal Access Tokens must be generated within the GitLab Repository user Profile pages.
    • You can store one Personal Access Token per Git Server URL.
    • This Personal Access Token will be used for all subsequent access of this RTC User to access a GIT Repository on the GIT Server
    • The Personal Access Token is securely stored on the database of the Server
    • To revoke a Personal Access Token, you simply have to revoke the Personal Access Token on the GitLab profile. Next time you try to access the GIT Repository, you will be asked again for a Personal Access Token.

First Time AT

Select the Commits You Want to Link to this Work Item

ℹ️ Currently we only

  • load commits from the Master Branch
  • load the last 100 commits

from a GitLab Repository.

  • Filter: Filters for "commit title" and "author". Search for In-String match.
  • Greyed out commits on the left side are already linked with this Work Item
  • Use the arrow keys to add/remove Commits from the selection

Git Picker UI

  • Proceed with the Button "Link the commits" to link the commits to the Work item. The Work Item is automatically saved.

➡️ The new links should be visible at the link page. Link Type is "Git Commits"

Git Commit Links

  • You can hover with the mouse over a Commit Link and get the most important information about the Git Commit.

Git Rich Hover

  • You can click on a Link and will automatically be forwarded to the GitLab Commit viewer.

  • Within the GitLab Commit, you will see a comment with the back link to the Work Item.

< Previous Page | Next Page >

Clone this wiki locally