Integration with Yandex-Tracker

Features

The following features are available for the integration with Yandex Tracker:

• Connection check.

  • Allure TestOps can check the validity of the provided credentials.
  • Permissions cannot be validated.

• Issue synchronization.

• Retrieving a list of issues.

  • Allure TestOps can retrieve and filter the list of issues from Yandex Tracker based on the user-provided data.

• Issue creation.

  • Issues can be created from defects.

• Launch export.

  • If a launch is linked to an issue, a link to the launch will be added as a comment in the specified issue.

There are 2 steps you need to perform to integrate with YandexTracker:

1. Create OAuth2 token on Yandex Cloud side.
2. Add integration on Allure TestOps side.

Create OAuth2 token on Yandex side

To be able to use YandexTracker, you need to be properly authenticated on Yandex side.

The creation of the authentication parameters is described in the official documentation of Yandex Cloud

https://cloud.yandex.com/en/docs/tracker/concepts/access

First, you need to authenticate at https://yandex.com/dev/:

1. Open https://oauth.yandex.com/client/new.

2. Add service name (for example, AllureIntegration).

3. Select Which platform is the app required for? and click Insert URL for development.

   

4. Scroll to Data access, type tracker and select permissions from the list Read from tracker and Write in tracker.

   

5. For the item Link to website, select Insert URL for development and click Create app.

   

6. You'll be redirected to the created application page, where you need to copy the ClientID (note that the token's lifetime is one year).

   

7. Follow the link https://oaut.yandex.com/authorize?response_type=token&client_id=application_ID, where application_ID - your current CLientID from the previous step.

8. Confirm authorization, if required.

   

9. Now, your OAuth2 token is created and enabled.

   

Add integration on Allure TestOps side

The general description of enabling of an integration is described in the Integration section.

Integration recap

1. Create credentials in the external system for API usage.
2. Add the required integration at the global level in Allure TestOps (you need administrator permissions).
3. Add the required integration at the project level and specify the credentials obtained in the step 1.

Global level

You need administrator permissions to configure the Allure TestOps instance at the global level.

1. Go to Administration → Integrations.

2. In the upper-right corner click + Add integration.

3. Search for Yandex Tracker.

4. Click the Yandex Tracker logo.

5. Provide the name of the integration.

6. Provide the URL of Yandex Tracker (most likely that'll be https://tracker.yandex.com).

7. Allure TestOps will use the default API endpoint (https://api.tracker.yandex.net) if the Endpoint field is left empty. See documentation.

   In most cases, you don’t need to specify this parameter.

8. Click Add integration.

Add Yandex Tracker to your project

You need to be a project owner to configure these settings.

1. In Allure TestOps, open your project.
2. Go to Settings → Integration.
3. Locate the Yandex Tracker integration you want to add.
4. Click Add integration.
5. In the modal window enter the credentials: – the organisation ID (can be found by following the link https://tracker.yandex.com/settings);
   • OAuth2 token (described in the very beginning of this very article).
6. Click Test connection.
7. Finalise the Integration settings by clicking on Add integration.

That's all folks – you can use Yandex Tracker now.