Интеграция с Битрикс24

Интеграция с Битрикс24 позволяет:

• связывать сущности ТестОпс (тест-кейсы, запуски, результаты тестов, дефекты, карантин) с задачами Битрикс24 (см. Ссылки на задачи из таск-трекеров);
• создавать задачи Битрикс24 через интерфейс открытого дефекта в ТестОпс (см. Связывание дефектов с задачами).

Примечание

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

Настройка интеграции

Чтобы настроить интеграцию с Битрикс24:

1. Создайте входящий вебхук в Битрикс24.
2. Подключите интеграцию с Битрикс24 на уровне инстанса ТестОпс.
3. Добавьте настроенное подключение к Битрикс24 в проект ТестОпс.

1. Создайте входящий вебхук в Битрикс24

1. Перейдите в ваш инстанс Битрикс24.

2. В сайдбаре слева перейдите в раздел Приложения → Разработчикам.

3. На вкладке Готовые сценарии нажмите Другое → Входящий вебхук.

4. В поле Настройка прав нажмите + выбрать и добавьте права:

   • Пользователи (user);
   • Задачи (task);
   • Рабочие группы (sonet_group);
   • Задачи (расширенные права) (tasks_extended);
   • Задачи (tasks).

5. В поле Вебхук для вызова rest api скопируйте часть вебхука после rest/ до закрывающего / (например, 1/123abcdefgh45i67).

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

6. Нажмите Сохранить.

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

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

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

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

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

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

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

   • Endpoint — введите URL-адрес вашего инстанса Битрикс24 (например, https://example.bitrix24.ru/).

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

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

     Примечание

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

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

7. Если интеграция может работать с глобальными учетными данными Битрикс24, в секции Глобальные учетные данные введите часть вебхука, которую вы сохранили на шаге 1.

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

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

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

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

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

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

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

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

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

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

7. Если интеграция будет работать с проектными учетными данными Битрикс24, в секции Проектные учетные данные введите часть вебхука, которую вы сохранили на шаге 1.

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

Удаление интеграции

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

Важно

Последствия удаления интеграции:

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

• Удаление на уровне проекта — все связи с задачами Битрикс24, которые относятся к интеграции, будут сохранены в сущностях ТестОпс, но вы не сможете создавать новые связи для этого проекта.

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

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

3. В списке настроенных подключений найдите ваше подключение к Битрикс24 и убедитесь, что оно не используется в проектах ТестОпс.

   Если интеграция подключена к проектам, удалите ее из них. Для этого откройте карточку подключения к Битрикс24 и напротив названия каждого проекта нажмите ⋯ → Удалить из проекта → Да, удалить.

4. Напротив нужного подключения к Битрикс24 нажмите ⋯ → Удалить → Да, удалить.