Ссылки на задачи из таск-трекеров

Вы можете связывать тест-кейсы и запуски с задачами в таск-трекерах: Jira, Redmine и др. Чтобы это сделать, сначала настройте интеграцию с требуемым таск-трекером.

После настройки интеграции вы можете добавить ссылки на задачи вручную через интерфейс ТестОпс или автоматически из результатов тестов, загруженных в ТестОпс. Если вы хотите вручную добавить ссылку на задачу к автоматизированному тест-кейсу, вам нужно изменить политику обновления метаданных вашего проекта.

Добавление ссылок вручную

К тест-кейсам

Чтобы добавить ссылку на задачу к тест-кейсу:

1. Перейдите в раздел Тест-кейсы.
2. Откройте тест-кейс.
3. В правой части экрана найдите блок Связанные задачи из баг-трекера и нажмите на значок карандаша.
4. Нажмите + Добавить.
5. В поле Баг-трекер выберите таск-трекер.
6. В поле Ключ выберите задачу, к которой вы хотите привязать тест-кейс.
7. Нажмите Отправить.

Чтобы добавить ссылки сразу к нескольким тест-кейсам, используйте пункт Добавить метаданные в меню групповых операций.

К запускам

Чтобы добавить ссылку на задачу к запуску:

1. Перейдите в раздел Запуски.
2. Нажмите на значок ⋯ справа от нужного запуска и выберите Изменить.
3. В открывшемся окне нажмите + Добавить в разделе Связанные задачи из баг-трекера.
4. В поле Баг-трекер выберите таск-трекер.
5. В поле Ключ выберите задачу, к которой вы хотите привязать запуск.
6. Нажмите Отправить.

Автоматическое добавление ссылок из результатов тестов

Ссылки на задачи могут быть добавлены к тест-кейсам автоматически при загрузке результатов тестов в ТестОпс. Для этого необходимо указать их в вашем коде и создать маппинги для таск-трекеров в настройках вашего проекта.

Указание ссылок на задачи в коде

Реализация ссылок зависит от используемого вами тестового фреймворка. Пример кода для JUnit 5:

@Test
@JiraIssue("AE-2")
@DisplayName("Creating new issue by authorized user")
public void shouldCreateIssue() {
    steps.openIssuesPage(OWNER, REPO);
    steps.createIssueWithTitle(ISSUE_TITLE);
    steps.shouldSeeIssueWithTitle(ISSUE_TITLE);
}

Обратите внимание на строку, начинающуюся с @JiraIssue. Эта строка связывает тест-кейс с задачей AE-2 в Jira.

Код выше создаст файл с результатами теста, в котором будет указано поле labels. Это поле содержит все атрибуты, которые будут применены к тест-кейсу при загрузке файла в ТестОпс.

...
"labels": [
    {
      "name": "jira",
      "value": "AE-2"
    },
...

Чтобы узнать больше о поле labels, см. Ключи маппинга.

Создание маппингов

1. Откройте ваш проект.
2. Перейдите в раздел Настройки → Задачи из баг-трекера.
3. Нажмите + Создать.
4. В поле Ключ укажите значение, которое вы используете в вашем коде. Для приведенного выше примера это jira.
5. В поле Баг-трекер выберите интеграцию с таск-трекером, которую вы ранее добавили в ваш проект. Для приведенного выше примера это интеграция с Jira.
6. Нажмите Отправить.

Изменение политики обновления метаданных

Чтобы связывать автоматизированные тест-кейсы с задачами через интерфейс ТестОпс, а не в результатах тестов, измените политику обновления метаданных, настроив игнорирование задач из результатов тестов:

1. Откройте ваш проект.
2. Перейдите в раздел Настройки → Обновление метаданных.
3. Нажмите + Создать.
4. В поле Поле выберите issue.
5. В поле Политика выберите from_test_case.
6. Нажмите Отправить.