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

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

Примечание

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

Важно

Мы не проводили внутреннее тестирование требований в интеграциях с Confluence Data Center, поэтому не можем гарантировать корректную работу ТестОпс с требованиями из этой системы.

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

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

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

1. Создайте токен в Confluence Data Center

Примечание

Пропустите этот шаг, если вы планируете использовать свое имя пользователя и пароль из Confluence Data Center в качестве учетных данных для интеграции.

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

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

3. В сайдбаре слева перейдите в раздел Personal access tokens.

4. Нажмите Create token.

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

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

6. Нажмите Create.

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

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

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

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

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

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

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

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

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

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

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

     Примечание

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

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

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

   1. Перейдите на вкладку, соответствующую учетным данным Confluence Data Center, которые вы планируете использовать, — Пароль или Персональный токен доступа.
   2. Введите имя пользователя и пароль нужной учетной записи в Confluence Data Center или токен, который вы получили на шаге 1.

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

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

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

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

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

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

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

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

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

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

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

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

   1. Перейдите на вкладку, соответствующую учетным данным Confluence Data Center, которые вы планируете использовать, — Пароль или Персональный токен доступа.
   2. Введите имя пользователя и пароль нужной учетной записи в Confluence Data Center или токен, который вы получили на шаге 1.

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

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

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

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

Важно

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

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

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

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

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

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

Важно

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

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

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

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

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