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

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

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

Примечание

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

• Администрирование — необходимы права администратора инстанса;
• Настройки в конкретном проекте — необходима роль владельца этого проекта.

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

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

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

2. На уровне инстанса ТестОпс добавьте интеграцию с Битрикс24, указав:

   • название интеграции;
   • URL-адрес Битрикс24.

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

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

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

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

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

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

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

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

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

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

2. Добавьте интеграцию с Битрикс24 в ТестОпс

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

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

3. Нажмите + Добавить интеграцию в правом верхнем углу.

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

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

   • Название — название, которое поможет вам распознать интеграцию, например, Bitrix24 production.
   • Endpoint — URL-адрес вашего инстанса Битрикс24, например, https://example.bitrix24.ru/.

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

3. Включите интеграцию для проекта ТестОпс

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

1. Перейдите в раздел Администрирование → Интеграции.
2. В списке настроенных интеграций найдите и откройте вашу интеграцию с Битрикс24.
3. Перейдите на вкладку Проекты.
4. Справа от поля поиска нажмите +.
5. В выпадающем списке Проект выберите нужный проект ТестОпс.
6. В поле Секрет введите часть вебхука, которую вы сохранили на шаге 1.
7. Нажмите Проверить соединение. Если вебхук указан верно, через несколько секунд появится сообщение «Соединение установлено».
8. Нажмите Добавить интеграцию.

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

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

Важно

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

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

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

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

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

3. Перейдите на вкладку Проекты и убедитесь, что интеграция не используется в проектах ТестОпс.

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

4. Перейдите на вкладку Конфигурация.

5. Нажмите Удалить интеграцию.

6. Нажмите Удалить.