2.5 Creating an Issue

The plugin allows you to create an issue on the connected Git platform (GitHub/GitLab). This is useful when you have created a task or defect in RTC and would like to transfer it to Git without having to copy and paste all the information.

Simply go to the work item in RTC that you would like to create as an issue in Git and open the plugin. Creating an issue works much like creating a link. Just select the first item in the list on the issues tab. It should have the text "Create a new issue in Git*" and a green plus icon on the left.

It's possible that you will see a warning symbol to the right of the item like in the image below.

This warning symbol indicates that the current work item has already been created as a Git issue. This information can also be seen by hovering over the icon. You can still create a Git issue when this warning is present (maybe you need to create it in a different Git repository). This is just meant to help prevent the accidental creation of duplicate issues in Git.

Clicking the plus icon will add it to the list just like is done with links.

When you press the save button the issue will be created in Git and automatically linked to the current work item. It is also possible to add some other links to be created together with the new issue as described in the Creating Links page.

By default, the issue is created using markdown syntax for styling. If you use the feature often you may wish to customize what information is taken from the work item and how it is formatted in the new issue. If so, check out the Custom Issue Templates page for information on how to customize newly created issues using a custom issue template.