Skip to main content

Jira Cloud

Use Testiny as your Jira test management tool and connect test cases and results to Jira Issues. Testiny fully integrates into Jira Cloud — you can create, link and look up issues, requirements or defects from Testiny. You are also able to view linked testing activities directly from Jira — a fully fledged two-way integration.

Testiny further makes complex issue-type configuration (with all its custom fields etc.) unnecessary. Testiny reads your issue-configurations and performs the whole configuration in the background. Just link Testiny with Jira — and you’re done!

Configuration​

To configure a new integration, you need to have admin rights in Testiny. Go to Settings > Integrations and click on 'Add button Add integration' for Jira. A side panel opens where you need to define the following options for the connection:

  • Jira Server URL
    Enter the Jira server URL — it usually has the format: https://your_organization.atlassian.net

  • Jira Email Address
    Testiny connects with Jira using one of the user accounts available in your Jira instance. Please enter the email of the user that you’d like to use for the Testiny connection.

  • Jira API token
    To increase security, Testiny uses an API token instead of a password to interact with the Jira API.
    Please create an API token directly in Jira. Using minimal permissions is strongly recommended (i.e. using a dedicated Jira user account limited to CREATE_ISSUES and EDIT_ISSUES permissions). Creating an API tokens is described in detailed on this page. Then copy the API token into this input field.

When the above fields are filled in, click the button "Test connection" to check if the credentials are valid and a connection to Jira can be established. When you’ve successfully connected Testiny with Jira, you can now also install the Jira add-on for a full two-way integration or skip this step for now and configure which projects you want to connect. To configure the mapping of the projects, click "Continue" or directly go to the "Projects" tab. Here, you can define the scope of the integration for:

  • Testiny Projects

    • All projects
      By default, the integration is configured for all existing and future projects of your Testiny organization.
    • Only specific projects
      If you want to configure an integration for specific Testiny projects only, select this option. Now you can select for which projects you want to enable this integration.
    • For defects, for requirements or for both
      You can also define if you want to use this integration for defects only, for requirements only, or for both.

  • Jira Projects

    • All projects
      By default, the integration is configured for all projects of the tool you’re integrating with.
    • Only specific projects
      If you want to configure an integration for specific projects only, select this option. Now you can select which projects you want to enable this integration for.

Jira add-on​

For a full bi-directional integration, intstall the Jira add-on on the official Atlassian Marketplace enabling backwards linking from Jira to Testiny. you’re able to view testing activities done in Testiny directly within Jira — e.g. see which requirements in Jira are covered by which test cases or which bugs are linked to a certain test-run. By activating this integration, you gain full traceability from Jira as well as from Testiny.

note

You need admin rights in Jira to install the Jira add-on from the Atlassian marketplace.

  • Install the app from the official Atlassian marketplace. You can also navigate in Jira to Apps > Find new apps and search for "Testiny".

  • After installing the app, select "Configure" in the Jira add-on.

  • Create an installation token for the Jira-App in Testiny. Go to the "Details" tab of your Jira Cloud integration and click the button "Create installation token" as shown in the screenshot below:

Jira add-on — Installation Token

  • Copy the installation token, paste it inside the add-on in Jira configuration window into the field showing "Paste Testiny installation token" and press "Connect".

You’ve successfully connected your Jira instance with Testiny. From now on, you’re able to view testing activities also within Jira issues.

Enabling inline view in Jira

If you want to see linked test cases and runs directly in your Jira issues, you can enable the inline view by going to the menu and clicking "Links to Testiny". Jira add-on — Enable inline view

Using the Jira Integration​

Viewing Testiny Activities inside Jira​

From any Jira issue you can see all Testiny entities that link the current issue (including test cases, test run results, etc.).
Using these links you can directly access the relates Testiny entry to lookup further details.

Creating or linking Jira Issues​

Within Testiny, you can link test runs and executions to Jira issues. If you find a bug during your tests, you can create an issue in Jira directly from Testiny. It is also possible to link requirements to test cases or create requirements in Jira directly from Testiny to build up your test coverage matrix.

Jira issues can be created (or linked to) in Testiny from the following entities:

  • Test cases
    It is possible to link requirements to test cases (a requirement can be any type of Jira issue) or to create a requirement that is automatically linked to the test case.

  • Test runs and test executions
    Testiny provides the ability to create defects (or link an existing issue) directly from a test run or a test execution.

When creating a requirement or a defect in Testiny, a create dialog will open where you can set the fields for the Jira issue. In this dialog you can select the Jira project, the issue type and set other fields. Click "Create" to confirm. If pop-ups are allowed, the newly created issue will open in a new browser tab. Otherwise, a small window with the details and a link to the issue will appear.

When linking a requirement or a defect, a search dialog will open where you can search all existing issues directly in Testiny (no need to switch to Jira) and select the issue you want to link.

Accessing Jira Issues in Testiny​

Connecting Jira with Testiny allows you to directly look up and access Jira issues. Testiny shows essential information such as the issue status or the issue type inline. For further details on linked issues, the issue can be opened directly from Testiny by clicking the issue ID. Testiny supports issue links in various places:

  • Test cases
  • Test runs
  • Test results

If you have any further questions, need to get assistance, or want to leave feedback, either create a topic in our forum, use Testiny’s built-in feedback system or simply write us an email to: [email protected].

Technical details: How does the integration work?​

If you’re curious how the integration works, the next section might be interesting for you :-)

  • Testiny Jira add-on:
    The Jira add-on (an Atlassian app, installed from the Atlassian Marketplace) provides the functionality to authenticate with Jira and link a Testiny organization with a specific Jira instance. Inside Jira, details from Testiny (like status of a test run, a test result linked to a defect) are directly rendered by the Atlassian app(inside an iframe). Only the Jira instance, which was configured with the Jira authentication-token is allowed to access the Jira interface for the respective organization.

  • Looking up issues: Looking up issues in Testiny does not require the Jira add-on. Testiny directly interacts with the Jira REST API and retrieves live data. Data is retrieved in the context of the user used to connect Testiny with Jira.

  • Creating issues: Testiny automatically creates a new issue (using the default type from the Jira integration for requirements or defects) directly in Jira using the Jira REST API. If the browser settings allow opening a new window/pop-up, the issue is automatically opened in a new tab and can be adjusted immediately. The issue is created with the user context that is used to link Testiny with Jira.

  • Linking existing issues: Searching for issues works directly using the Jira REST API. Users can directly link with existing issues.

Jira Server/Data Center​

Testiny also supports an integration with Jira Server or Jira Data-Center. Please have a look at the Jira Server/Data-Center documentation.