- \n
- Using\u00a0defect URLs to link test results to YouTrack<\/li>\n
- Using the defect plugin for YouTrack to push and hover over YouTrack Issues<\/li>\n
- Using\u00a0reference URLs to link test cases to YouTrack<\/li>\n
- Using the reference plugin for YouTrack to look up YouTrack issues in the References field of TestRail entities such as test cases, test runs, and milestones<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n
You don\u2019t have to use all the listed integration options, and you can mix and match the integration with other tools. Configuring the integration usually only takes a few minutes.<\/p>\n
You can find more information about TestRail\u2019s reference and defect integrations here<\/a>.<\/p>\n
Configuring defects<\/h2>\n
Defect URLs<\/h3>\n
\n\nThe defect URLs are used to let TestRail know how to convert a Defect ID into a URL for your YouTrack instance. There are two types of URLs: View URLs and Add URLs.<\/p>\n
The\u00a0Defect View URL\u00a0<\/strong>is used to build a link to YouTrack based on the Defect ID, so you can simply click on an ID to open the issue directly in YouTrack.<\/p>\n
The\u00a0Defect Add URL\u00a0<\/strong>is used to create a link to the issue creation screen inside YouTrack. Once the URL is configured, a new Add link appears next to the Defects field in the Add Test Result dialog and the \u2018Defects\u2019 menu in TestRail\u2019s\u00a0Defect From Anywhere<\/a>\u00a0feature. This link allows you to jump to YouTrack\u2019s New Issue form to report a new bug.<\/p>\n
Add\u00a0<\/strong>Defect link in \u2018Add Result\u2019 dialog<\/p>\n
![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/GitHub_Add_Defect-1024x585.png\")
<\/a><\/p>\nAdd\u00a0<\/strong>Defect link in Defect From Anywhere<\/span><\/p>\n
![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip0-2.png\")
<\/a><\/p>\nIf you see the Add <\/strong>link, you can copy the ID of your new YouTrack issue and enter it into any Defects or References field inside TestRail.<\/p>\n
To configure YouTrack\u2019s Defect URLs in TestRail, select Administration > Integration<\/strong>. You can alternatively enter separate bug tracker URLs for each project under\u00a0Administration > Projects<\/strong>. Use the following example URLs to configure the addresses:<\/p>\n<\/div>\n<\/div>\n
YouTrack installation\nDefect View Url: https:\/\/<your-server>\/youtrack\/issue\/%id%\nDefect Add Url: https:\/\/<your-server>\/youtrack\/newIssue?<\/pre>\n
[et_pb_text admin_label=”Note” _builder_version=”4.4.2″ background_color=”#F0F8FF” hover_enabled=”0″ border_width_all=”1px” border_color_all=”#b0c4de”]<\/p>\n
Please make sure to replace
<your_server><\/code> with the actual address of the YouTrack instance you want to integrate with.<\/p>\n[\/et_pb_text]<\/p>\n
Example:<\/strong><\/p>\n
\n\nHere, the server name is <\/span>shabu.myjetbrains.com.<\/span><\/p>\n
Defect View URL: <\/strong>https:\/\/shabu.myjetbrains.com\/%id%<\/span><\/p>\n
Defect Add URL: <\/strong>https:\/\/shabu.myjetbrains.com\/youtrack\/newIssue?<\/span><\/p>\n
Here\u2019s how the Defect URLs look in TestRail:<\/p>\n<\/div>\n<\/div>\n
![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip1-2-1024x464.png\")
<\/a><\/p>\n\n\nAdditionally, if you have the defect plugin configured, you\u2019ll also be able to hover over the defect ID to view the issue details directly from within TestRail.<\/p>\n
Defect plugin<\/h3>\n
Defect plugins can be used to implement a deeper bug tracker integration and TestRail comes with a ready-to-use YouTrack defect plugin.<\/p>\n
To configure the defect plugin, select\u00a0Administration > Integration<\/strong>\u00a0and select\u00a0YouTrack<\/em>\u00a0in the\u00a0Defect Plugin<\/strong>\u00a0dropdown list. The next step is to configure all the necessary connection settings in the\u00a0Configuration\u00a0<\/strong>field. Project-specific plugins and configuration settings can optionally be specified under\u00a0Administration > Projects<\/strong>.<\/p>\n
![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip2-1.png\")
<\/a><\/p>\nWhen the defect plugin has been configured, a new Push\u00a0<\/strong>link is shown next to the Defects field in the\u00a0Add Test Result<\/strong> dialog. Clicking the link will open a popup dialog that enables you to push a bug report to YouTrack without leaving TestRail.<\/p>\n
Once the test result is added, hovering the mouse cursor over an issue ID will open a window with useful information and status details about the issue in YouTrack.<\/p>\n
Plugin customizations require the YouTrack20191 Defect and Reference Plugins, available with TestRail 6.5 and later.<\/strong><\/p>\n<\/div>\n<\/div>\n
<\/div>\n\n\n\n\n\n\nDefect plugin customizations<\/span><\/h3>\n<\/div>\n
\n\n\nThe YouTrack defect plugin was built to work with a standard YouTrack configuration. TestRail allows you to customize the fields which appear in the Push dialog as well as when hovering over Defect IDs. Preconfigured push fields and hover fields can be set to \u2018on\u2019 or \u2018off\u2019 in their respective [push.fields]<\/strong> and [hover.fields] <\/strong>sections, or change the order in which they appear by the fields in each section.<\/p>\n
Please keep in mind some fields (such as the title field) are always enabled and may not appear in these sections due to always beings required by either TestRail or YouTrack.<\/p>\n
The YouTrack Defect Plugin also supports modifying field properties as well as custom fields.<\/p>\n
In addition to enabling, disabling, or re-organizing fields as described above, it\u2019s also possible to change additional options per field. To do this, you would define a section for the field, such as\u00a0 [push.field.description]<\/strong>\u00a0and specify additional options within this section.<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n\n\n\n\n\n\n[push.field.description]\nlabel=Detailed Description\nrequired=true<\/pre>\n
Please see below for full list and explanation of the available field options:<\/p>\n
![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip3.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip4-1024x458.png\")
<\/a><\/p>\n![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/753\/wp-content\/uploads\/mceclip5.png\")
<\/a><\/p>\n