Tools: OnTime

This topic explains how to integrate TestRail with Axosoft OnTime. There are currently two ways to integrate TestRail with OnTime, namely:

You don't 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 and this guide explains how to configure the integration and how it works.

Defect URLs

The defect URLs are used to let TestRail know how to access your OnTime instance. Once the URLs have been configured, a new Add link appears next to the Defects field in the Add Test Result dialog. This link allows you to jump to OnTime's New Case form to report a new bug. Additionally, entered case IDs are linked to your OnTime instance to make it easier to track the status of your cases.

To configure OnTime's URLs in TestRail, select Administration > Site Settings > Integration Tab. You can alternatively enter separate bug tracker URLs for each project under Administration > Projects. Use the following example URLs to configure the addresses: 

OnTime Now (Hosted)
Defect View Url: https://name.ontimenow.com/viewitem.aspx?id=%id%&type=defects
Defect Add Url:  https://name.ontimenow.com/edititem.aspx?type=defects

OnTime 2011 or later
Defect View Url: http://your-server/viewitem.aspx?id=%id%&type=defects
Defect Add Url:  http://your-server/edititem.aspx?type=defects

OnTime 2019 or earlier
Defect View Url: http://your-server/defects/viewdefect.aspx?defectid=%id%
Defect Add Url:  http://your-server/defects/addeditdefect.aspx

Desktop client*
Defect View Url: https://store.axosoft.com/keyserver/viewitem.aspx?t=0&i=%id%

Desktop client alternative
Defect View Url: ontime://0_%id%

*) Desktop client: OnTime's desktop client uses a special protocol handler (ontime:) to allow links from web applications to bugs. Axosoft provides a special redirect link for this (via https://store.axosoft.com/).

Defect plugins

Defect plugins can be used to implement a deeper bug tracker integration and TestRail comes with a ready-to-use OnTime defect plugin. To configure the defect plugin, select Administration > Site Settings > Integration Tab and select OnTime in the Defect Plugin dropdown list. The next step is to configure all the necessary connection settings in the Configuration field. Project specific plugins and configuration settings can optionally be specified under Administration > Projects.

When the defect plugin has been configured, a new Push link is shown next to the Defects field in the Add Test Result dialog. Clicking the link will open a popup dialog that enables you to push a bug report to OnTime without leaving TestRail. Once the test result was added, hovering the mouse cursor over an defect ID will open a window with useful information and status details about the defect in OnTime.

OnTime Now (Hosted)

If you are using OnTime Now you can find your API token when you login to your Axosoft Store account and click the Settings button next to your Hosted instance. You will need to use the Security Guid value of the OnTime Sdk Settings box for the integration settings (the token value in TestRail's configuration settings).

Please note that you also need to use a slightly different address for the defect plugin connection settings. You can find the correct URL on the same page as mentioned above (the Sdk URL address in the table at the bottom of the page). 

If your normal OnTime Now address is this: https://name.ontimenow.com
Then your SDK address likely looks like this: http://namesdk.ontimenow.com

OnTime Installation

The TestRail defect plugin for OnTime requires that the OnTime SDK is installed and configured on your OnTime server. Please contact the Axosoft support if you have any questions about the SDK. We can also usually give tips on how to install the SDK.

Please note: The OnTime defect plugin was built to work with a standard OnTime installation. While the plugin will work with most OnTime configurations, you might need to customize the plugin if you've made critical changes to your OnTime instance (such as adding additional required fields to your forms).

Reference URLs

The reference URLs are used to link test cases to cases stored in OnTime via the References field. Once the URLs have been configured, case IDs entered in the References field are linked to your OnTime instance to make it easier to jump to related issues, feature specifications or requirements.

To configure OnTime's URLs for the References field, select Administration > Site Settings > Integration Tab. You can alternatively enter separate reference URLs for each project under Administration > Projects. Use the following example URLs to integrate TestRail with OnTime: 

OnTime Now (Hosted)
Reference View Url: https://name.ontimenow.com/viewitem.aspx?id=%id%&type=defects
Reference Add Url:  https://name.ontimenow.com/edititem.aspx?type=defects

OnTime 2011 or later
Reference View Url: http://your-server/viewitem.aspx?id=%id%&type=defects
Reference Add Url:  http://your-server/edititem.aspx?type=defects

OnTime 2019 or earlier
Reference View Url: http://your-server/defects/viewdefect.aspx?defectid=%id%
Reference Add Url:  http://your-server/defects/addeditdefect.aspx