Help Index

JIRA Website

How does Testuff integrate with JIRA?

Although Testuff is a hosted service it can automatically send every reported defect to your JIRA account. You can run your manual tests with Testuff and continue to use JIRA for bug tracking.

The integration is done by the desktop client. Therefore, it should also work if you host JIRA on an internal server. Our server doesn’t need to access your bug tracker server and you don’t need to change anything in your security or firewall configuration to make it work.

How do I configure JIRA with Testuff?

  1. In Testuff, go to Settings > Bug Tracker and click the Add bug tracker link.
  2. Choose JIRA from the bug trackers combo box.
  3. Fill in the JIRA server address in the URL field. This should be the JIRA URL, omitting any file names that may appear after the last slash.
  4. Set the Default Project. Defects exported from Testuff projects that do not have a custom JIRA project will be exported using this project name.
  5. Try the integration – click on Test connection. You’ll be prompt to enter username/password, if not yet entered *.
  6. You may click the Submit sample link to make sure Testuff can create bug reports in JIRA. If all goes well the new bug report should be displayed.
  7. Don’t forget to click OK to save the settings.

* Jira cloud requires a Token, rather than a password. Here’s how to get the token:

  • Log in to
  • Click Create API token
  • From the dialog, enter a memorable and concise Label for your token and click Create
  • Click Copy to clipboard, then paste the token in Testuff, as the password

Setting up automatic 2-way integration

Testuff supports an industry-unique option to automatically update your reported defects in Testuff, with any change made to them in your Jira. Here’s how to set it up:

  1. Go to your Jira and select: Jira Software->Jira Settings->System->Under Advanced: Webhooks.
  2. Create a Webhook, using the URL in Testuff settings->Bug trackers->Jira (under “Automatic 2-ways Integration URL”).
  3. You’re all set to report defects from Testuff to your Jira account, and get back automatic updates.

* Note that only existing defects (in Testuff) will be updated upon change (in Jira).

How do I add my custom fields?

  1. The best and easiest way is to use the Show available custom fields link and then select those you wish to add.

Or, do it manually:

  1. Go to your JIRA New issue page (make sure it’s the page where you enter the new issue fields).
  2. Right click on it and select View source.
  3. Find the name and code for your JIRA custom fields.
  4. Enter them in the Add bug tracker custom fields window (see link in the bug tracker settings).
  5. Make sure to use customfield_number as the correct code format.

Note you can report a defect as a sub-task to a Jira existing task by using the Parent_ID predefined field (enter the Jira key, which usually comes in the format of TES-number).

Can I associate a Testuff defect to a JIRA project?

Yep. You can add the field Project to the Bug Reporter, from the Settings->Bug Tracker window, and then report each defect to a selected Jira project, while reporting the defect. That’s just cool.

You can also set the integration as a project-to-project relation. Simply follow the instructions below. Projects that do not have a custom JIRA project set to them will use the default one from the general settings.

  1. Go to the home screen via the house icon at the top left.
  2. Click the Manage projects link and select a project by clicking on the Edit link next to it.
  3. Under General tab, fill in the JIRA project for this Testuff project.
  4. Click OK to save the settings.

The integration doesn’t work. What should I do?

Make sure your JIRA server accepts remote API calls. Log in to the JIRA web interface and perform the following:

  1. Click the Administration link in the top bar.
  2. Choose General Configuration on the left side.
  3. Go to the bottom and click Edit Configuration.
  4. Under the Options title, go to Accept remote API calls and turn it ON.
  5. Click Update at the bottom.

I get an error message about a “required field”. What does it mean?

Testuff recognizes that your JIRA is asking for a mandatory field to which it doesn’t have a default parameter to pass. To add this field’s parameters:

  1. If the field is a custom field, follow the steps in the relevant paragraph above. If not, then:
  2. Go to your JIRA New issue page (make sure it’s the page where you enter the new issue fields).
  3. Right click on it and select View source.
  4. Save the file and send it to our support.
  5. The field defaults will be soon added for you by us and you’ll be notified.

How do I integrate my Jira requirements with Testuff?

First, go to the Testuff project settings window and select your tracker as the requirement tool.

Then from the Requirements screen:

  1. Click on the more link, at the bottom of the screen.
  2. From the menu, select Add from Jira.
  3. Now, enter a Jira ID, or a few of them separated by commas.
  4. You can also add requirements (and same for defects) from Jira by using your Jira filters. This is easily done: First set these filters in Jira, then write filter=FILTER_NAME in the Add requirements/defects dialog window in Testuff. It’s that easy.

Please contact us for any help integrating Testuff with your JIRA.

Help Index