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

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

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

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

Чтобы добавить ссылку на задачу вручную, воспользуйтесь одним из способов:

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

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

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

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

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

Реализация ссылок зависит от используемого вами тестового фреймворка. Пример кода для 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. Нажмите Отправить.

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

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