You don\u2019t have to use all listed integration options and you can mix and match the integration with other tools. Configuring the integration usually only takes a few minutes. This guide explains how to configure the integration and how it works.<\/p>\n
Enhanced Assembla integration<\/h2>\n
TestRail provides an integration with Assembla which utilizes OAuth, allowing users to quickly connect their TestRail and Assembla instances without needing to configure API keys or enter additional credentials.<\/p>\n
Connecting to Assembla<\/h3>\n
As a TestRail Administrator, you can connect to an Assembla instance in the Integration view of the Administration area. In this view, press the Configure Assembla<\/strong> button and proceed with connection dialog:<\/p>\n With your Assembla Organization URL and Space entered in the dialog, you can press the Connect Account button and TestRail will complete the configuration for you. Alternatively, you can enter the API Key and API Secret.<\/p>\n The Defect integration<\/strong> and Reference integration<\/strong>\u00a0options allow you to also automatically configure the Defect and Reference integrations for your instance.<\/p>\n With TestRail connected to Assembla, you can connect your TestRail account to Assembla using OAuth. In the My Settings<\/strong> area of your user account, open the OAuth tab<\/strong>: Pressing the Connect Account<\/strong> button will retrieve an access token from Assembla and save it to your TestRail account. Alternatively, you can manually enter a User Access Token<\/em>\u00a0on the Settings <\/strong>tab.<\/p>\n You can also disconnect your user account at any time.<\/p>\n With TestRail connected to Assembla using an API Key and Secret, you will need to create an API key and secret in your Assembla account. You can do this under Account > API Applications & Session. Please ensure to check the boxes for API access and Repository access.<\/p>\n Once you save, the API key and secret will be available. In TestRail, you should store your key and secret in the corresponding User Variables<\/a> configured for the integration.<\/p>\n The defect URLs are used to let TestRail know how to convert a Defect ID into a URL for your Assembla instance. There are two types of URLs: View URLs and Add URLs.<\/p>\n The Defect View URL<\/strong> is used to build a link to Assembla based on the Defect ID, so you can simply click on an ID to open the issue directly in Assembla.<\/p>\n The Defect Add URL<\/strong> is used to create a link to the issue creation screen inside Assembla. 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 Push Defect From Anywhere<\/a> feature. This link allows you to jump to Assembla\u2019s New Issue form to report a new bug.<\/p>\n If you use the Add<\/strong>\u00a0link, you can copy the ID of your new Assembla issue and enter it into any Defects or References field inside TestRail.<\/p>\n You can configure Assembla\u2019s URLs in TestRail globally under Administration > Integration or on a per-project basis within any project\u2019s settings. Use the following example URLs to configure the addresses:<\/p>\n Please make sure to replace If your Assembla instance is located in the EU, your URLs should begin with https:\/\/eu-app.assembla.com\/\u2026<\/p>\n The reference URLs are implemented in a very similar manner to Defect URLs described above. The primary difference is Reference URLs are used for the \u2018References\u2019 field on various TestRail entities (instead of the Defects field).<\/p>\n The Reference View URL<\/strong> is configured in the same manner as described above and allows TestRail to create a direct link to a Assembla based on an ID entered into a References field.<\/p>\n The Reference Add URL<\/strong> is also configured in the same way as the Defect Add URL. Once configured, an Add<\/strong> link will appear next to each References field in your instance or project. If you use the\u00a0Add<\/strong> link, you can copy the ID of your new Assembla issue and enter it into any Defects or References field inside TestRail.<\/p>\n If you have the Reference plugin configured, you\u2019ll also be able to hover over a Reference ID to view the issue details directly from within TestRail. Keep reading to learn how to use and configure the Defect and Reference Plugins.<\/p>\n Defect plugins can be used to implement a tight bug tracker integration and TestRail comes with a ready-to-use Assembla defect plugin. To configure the defect plugin, select Admin > Integration<\/strong> and select Assembla in the Defect Plugin<\/strong> dropdown list. The next step is to configure all the necessary connection settings. Project-specific plugins and configuration settings can optionally be specified under Admin > Projects<\/strong>. When the defect plugin has been configured, a new Push<\/strong> link is shown next to the Defects<\/strong> field in the Add Test Result<\/strong> dialog. Clicking the link will open a popup dialog that enables you to push a bug report to Assembla without leaving TestRail.<\/p>\n Once the test result is added, hovering the mouse cursor over a defect ID<\/strong> will open a window with useful information and status details about the defect in Assembla.<\/p>\n When the defect plugin has been configured, a new Push<\/strong> link is shown next to the Defects<\/strong> field in the Add Test Result<\/strong> dialog. Clicking the link will open a popup dialog that enables you to push a bug report to Assembla without leaving TestRail.<\/p>\n The Assembla defect plugin was built to work with a standard Assembla 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] and [hover.fields] 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 Assembla.<\/p>\n The Assembla 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 [push.field.description] and specify additional options within this section.<\/p>\n Please see below for full list and explanation of the available field options:<\/p>\n You can also use the above-mentioned approach to add custom fields to TestRail\u2019s Push Defect dialogue. To do this, simply add a line with your custom field to the [push.fields] section to add a field as below:<\/p>\n Custom fields are designated by customfield_. The ID value for a custom field can be obtained through the Assembla API, using your browser to inspect a custom field\u2019s value within a ticket, or in the URL of a custom field\u2019s edit screen.<\/p>\n Then, add a [field.settings.customfield_] section. This section is required so the plugin can push and\/or retrieve data from your tool. The following is an example:<\/p>\n The following field types are supported:<\/p>\n The Assembla Defect Plugin supports submitting attachments to Assembla as well. This field can be turned on and off, but cannot be customized. To submit one or more attachments to Assembla, simply drag the attachment to the attachments or description areas of the push dialog or click on the area to choose an attachment from your file system.<\/p>\n Reference plugins can be used to retrieve additional information from IDs entered into the References field of TestRail entities, such as test cases, test runs, and milestones. The Reference Plugin is configured on the References tab of the integration settings in the same manner the Defect Plugin is configured.<\/p>\n The plugin supports hovering over Reference IDs but does not support a Push dialog for the References field. It is also possible to customize the fields which appear via link hovering and add custom fields, as described above.<\/p>\n If you have the Defect Plugin already configured for Assembla, you can simply copy your [connection] and [hover.fields] sections from the Defect Plugin into the Reference plugin configuration. Alternatively, you can choose different fields to be displayed for References and Defects.<\/p>\n TestRail also supports custom defect plugins. If your team uses TestRail Server, it is possible to further customize the defect plugin (or build your own) to support additional field types or other data. Please see our Custom Plugins documentation <\/a>for additional information.<\/p>\n","protected":false},"excerpt":{"rendered":" This topic explains how to integrate TestRail with Assembla. There are currently three ways to integrate TestR […]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":6734,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"class_list":["post-28872","page","type-page","status-publish","hentry"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/28872","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/comments?post=28872"}],"version-history":[{"count":5,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/28872\/revisions"}],"predecessor-version":[{"id":28904,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/28872\/revisions\/28904"}],"up":[{"embeddable":true,"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/pages\/6734"}],"wp:attachment":[{"href":"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-json\/wp\/v2\/media?parent=28872"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}![\"\"](\"https:\/\/docs.testrail.techmatrix.jp\/testrail\/docs\/9\/wp-content\/uploads\/configure_assembla_integration.png\")
<\/a><\/p>\nOAuth for users<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\nAPI key and secret for users<\/h3>\n
<\/a><\/p>\n<\/a><\/p>\nDefect URLs<\/h2>\n
Assembla installation\nDefect View Url: https:\/\/app.assembla.com\/spaces\/<space>\/tickets\/%id%\nDefect Add Url: https:\/\/app.assembla.com\/spaces\/<space>\/tickets\/new?from=tickets<\/code><\/pre>\n<space><\/code> with the actual name of the portfolio and space in Assembla you want to integrate with.<\/p>\nReference URLs<\/h2>\n
\u200bDefect plugins<\/h2>\n
\nPlease make sure to use your workspace ID and not the workspace name. The ID can be found found in the URL bar when logged into your Assembla instance.<\/p>\nCustomizations<\/h2>\n
[push.field.description]\nlabel=Detailed Description\nrequired=true<\/code><\/pre>\n\n\n
\n \nOption<\/th>\n Description<\/th>\n<\/tr>\n<\/thead>\n \n label<\/td>\n Specifies the display name of the field in the Push Defect dialogue\u00a0(Required for custom fields)<\/em><\/td>\n<\/tr>\n \n size<\/td>\n Specifies whether the field is displayed as a compact field\u00a0(compact)<\/em>\u00a0or uses the full width of the dialogue\u00a0(full)<\/em><\/td>\n<\/tr>\n \n remember<\/td>\n Specifies if previously selected values for this field should be remembered and restored the next time the Push Defect dialogue is opened<\/td>\n<\/tr>\n \n required<\/td>\n Specifies if this field is mandatory or optional and whether users are required to enter a value for this field in the Push Defect dialogue<\/td>\n<\/tr>\n \n type<\/td>\n Specifies the type of this field, please see section Custom fields below for a list of supported field types\u00a0(Required for custom fields)<\/em><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Custom fields<\/h3>\n
[push.fields]\n...\ndescription=on\ncustomfield_11002=on<\/code><\/pre>\n[field.settings.customfield_11002]\nlabel=Customer\nsize=compact\ntype=dropdown\nrequired=true<\/code><\/pre>\n\n\n
\n \nField Type<\/th>\n Description<\/th>\n<\/tr>\n<\/thead>\n \n dropdown<\/td>\n A dropdown list that allows users to select one of the multiple options<\/td>\n<\/tr>\n \n multiselect<\/td>\n Allows users to select multiple, pre-defined options<\/td>\n<\/tr>\n \n string<\/td>\n A small free-text field for up to 250 characters<\/td>\n<\/tr>\n \n text<\/td>\n A large free-text field without practical size limitations<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Attachments<\/h2>\n
Reference plugin<\/h2>\n
Additional customizations<\/h2>\n