Skip to main content

GitHub Issues

Use Testiny as your GitHub test management tool and connect test cases and results to GitHub Issues. Testiny fully integrates into GitHub — you can create, link and look up GitHub issues from Testiny. Testiny 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 your GitHub organization — and you’re done!

info

Do you want to integrate Testiny with GitHub Actions? Learn how to submit automated tests to Testiny from your CI pipelines.

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 GitHub. A side panel opens where you need to define the following options for the connection:

  • GitHub Organization URL
    Enter the GitHub Organization URL.

  • Personal Access Token (PAT) Create a personal access token for your GitHub organization and copy it into this field. We recommend creating a fine-grained personal access token using minimal permissions (limit the access token to the repositories you want to integrate and only set the permissions "Read" or "Read & Write" for "Issues").

Using the GitHub Integration

Creating or linking GitHub Issues

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

GitHub 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 GitHub 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 GitHub issue. In this dialog you can select the GitHub repository, 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.

info

Currently, we do not support creating items/issues in GitHub projects and setting custom item fields. The GitHub integration in Testiny can link and create repository issues only.

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 GitHub) and select the issue you want to link.

Accessing GitHub Issues in Testiny

Connecting GitHub with Testiny allows you to directly look up and access GitHub 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].