Интеграция с Confluence Cloud

Интеграция с Confluence Cloud позволяет связывать ручные тест-кейсы ТестОпс с требованиями, задокументированными на страницах Confluence Cloud (см. Требования).

Примечание

Чтобы настроить или удалить любую интеграцию ТестОпс с внешней системой, необходима глобальная роль «Администратор» в инстансе ТестОпс и, как правило, права администратора инстанса внешней системы.

Настройка интеграции и подключений с Confluence Cloud

Чтобы настроить интеграцию с Confluence Cloud:

1. Создайте API-токен в Confluence Cloud.
2. Подключите интеграцию с Confluence Cloud на уровне инстанса ТестОпс.
3. Добавьте настроенное подключение к Confluence Cloud в проект ТестОпс.

1. Создайте API-токен в Confluence Cloud

1. Перейдите в ваш инстанс Confluence Cloud.

2. Нажмите на ваш аватар и перейдите в раздел Account settings.

3. В верхнем меню перейдите на вкладку Security.

4. В разделе API tokens нажмите Create and manage API tokens.

5. Нажмите Create API token.

6. Заполните поля:

   • Name — введите название токена, которое поможет вам распознать интеграцию (например, Токен для ТестОпс).
   • Expires on — введите срок действия токена. После указанной даты интеграция перестанет работать. Чтобы возобновить ее работу, вам нужно будет создать новый токен.

7. Нажмите Create, затем нажмите Copy, чтобы скопировать токен в буфер обмена.

   Сохраните токен в безопасном месте, он понадобится для подключения интеграции с Confluence Cloud в ТестОпс.

2. Подключите интеграцию с Confluence Cloud на уровне инстанса ТестОпс

1. Перейдите в ваш инстанс ТестОпс.

2. Перейдите в раздел Администрирование → Интеграции.

3. Нажмите Добавить интеграцию.

4. В списке доступных интеграций выберите Confluence Cloud.

5. Заполните поля:

   • Название подключения — введите название, которое поможет вам распознать интеграцию (например, Confluence production).

   • Endpoint — введите URL-адрес вашего инстанса Confluence Cloud (например, https://example.atlassian.net/).

   • Тип учетных данных — нажмите на выпадающий список и выберите тип учетных данных Confluence Cloud, который будет поддерживать интеграция:

     • Все (глобальные и проектные) — интеграция может работать как с глобальными, так и с проектными учетными данными;
     • Только глобальные — интеграция может работать только с глобальными учетными данными;
     • Только проектные — интеграция может работать только с проектными учетными данными.

     Примечание

     Подробнее о поддерживаемых типах учетных данных см. Интеграции с внешними системами → Глобальные и проектные учетные данные.

6. Если ваш инстанс Confluence Cloud использует самоподписанный SSL-сертификат, уберите галочку напротив Проверка SSL-сертификата.

7. Если интеграция может работать с глобальными учетными данными Confluence Cloud, в секции Глобальные учетные данные:

   1. Введите электронную почту нужной учетной записи в Confluence Cloud.
   2. Введите API-токен, который вы сохранили на шаге 1.

8. Нажмите Добавить подключение.

В разделе Администрирование → Интеграции появится интеграция с Confluence Cloud с одним автоматически созданным подключением.

3. Добавьте настроенное подключение к Confluence Cloud в проект ТестОпс

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

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.

2. В списке настроенных интеграций найдите и откройте интеграцию с Confluence Cloud.

3. В списке настроенных подключений найдите и откройте ваше подключение к Confluence Cloud.

4. Нажмите Добавить в проект.

5. В списке доступных проектов выберите нужный проект ТестОпс.

6. Если интеграция может работать и с глобальными, и с проектными учетными данными Confluence Cloud, в поле Тип учетных данных нажмите на выпадающий список и выберите вариант, который будет использоваться в проекте:

   • Проектные — использовать проектные учетные данные для подключения к Confluence Cloud;
   • Глобальные — использовать глобальные учетные данные для подключения к Confluence Cloud.

7. Если интеграция будет работать с проектными учетными данными Confluence Cloud, в секции Проектные учетные данные:

   1. Введите электронную почту нужной учетной записи в Confluence Cloud.
   2. Введите API-токен, который вы сохранили на шаге 1.

8. Нажмите Добавить в проект.

Удаление подключений и интеграции с Confluence Cloud

Вы можете удалить подключение к интеграции с Confluence Cloud двумя способами — на уровне отдельного проекта (через настройки проекта) или на уровне всего инстанса ТестОпс (через раздел Администрирование).

Удаление подключения на уровне проекта

Важно

Последствия удаления всех подключений из интеграции с Confluence Cloud на уровне проекта:

• Подключения к интеграции с Confluence Cloud перестанут отображаться в списке подключений проекта, но продолжат работать в других проектах инстанса, в которых они были добавлены, и сохранятся в разделе Администрирование → Интеграции.
• Интеграция с Confluence Cloud перестанет отображаться в списке интеграций проекта, но сохранится в разделе Администрирование → Интеграции.
• Все связи со страницами Confluence Cloud, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.

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

1. Перейдите в ваш проект ТестОпс.
2. Перейдите в раздел Настройки → Интеграции.
3. В списке настроенных интеграций найдите и откройте интеграцию с Confluence Cloud.
4. Напротив нужного подключения к Confluence Cloud нажмите ⋯ → Удалить → Да, удалить.

Подключение перестанет работать в вашем проекте.

Удаление подключения на уровне инстанса

Важно

Последствия удаления всех подключений из интеграции с Confluence Cloud на уровне инстанса:

• Подключения и интеграция с Confluence Cloud будут полностью удалены.
• Все связи со страницами Confluence Cloud, которые относятся к интеграции, будут удалены из сущностей ТестОпс. Это действие необратимо — восстановить удаленные ссылки будет невозможно.

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

1. В ТестОпс перейдите в раздел Администрирование → Интеграции.
2. В списке настроенных интеграций найдите и откройте интеграцию с Confluence Cloud.
3. В списке настроенных подключений откройте карточку нужного подключения и напротив названия каждого проекта нажмите ⋯ → Удалить из проекта → Да, удалить.
4. Нажмите Назад в интеграцию, чтобы вернуться к списку подключений.
5. Напротив нужного подключения к Confluence Cloud нажмите ⋯ → Удалить → Да, удалить.

Подключение перестанет работать во всех проектах инстанса.