Возможности интеграции

К Swarmica можно подключить трекер задач для связывания задач с заявками. На данный момент доступны к подключению следующие трекеры:

• Yandex Tracker
• Jira
• Gitlab
• Youtrack

По запросу подключается:

• Kaiten

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

Если задача имеет ключевое отношение к заявке, сотрудник прикрепляет задачу к заявке опцией Добавить в заявку.

После прикрепления задача находится на странице заявки в правой её части. Прямо со страницы заявки без перехода в трекер можно увидеть заголовок, текст и все параметры заявки: тип, теги, статус. В нижней части блока можно увидеть имя сотрудника, добавившего задачу в заявку, и срок с момента добавления заявки.

Значком корзины можно открепить задачу от заявки, если она была прикреплена по ошибке или потеряла актуальность. Значком обновления можно обновить данные прикреплённой задачи.

Значок может в зависимости от типа трекера находиться в правом нижнем углу блока с задачей или рядом со статусом:

Когда задача будет закрыта, в заявку, связанную с этой задачей, добавится событие, а ответственному придёт уведомление на email.

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

Для интеграции с вашим трекером перейдите в настройки системы в боковом меню и выберите Трекеры задач:

На открывшейся странице нажмите на название вашего трекера.

Подключение Gitlab

1. Трекер URL - адрес gitlab из адресной строки браузера.
2. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
3. API Токен - создаётся в Gitlab в User Settings - Access tokens, обязательно отметить read_api!
4. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
5. Активен - включите бегунок для активации интеграции.

Не забудьте сохранить настройки!

Блок Gitlab в заявке:

Подключение Jira

1. Тип авторизации: токен или базовый. Для базового типа требуется авторизация по имени пользователя и паролю, в отличие от авторизации по токену.
2. Пользователь - имя пользователя Jira, через которого будут осуществляться запросы. Не требуется для заполнения при типе авторизации по токену.
3. Трекер URL - адрес Jira из адресной строки браузера.
4. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
5. Токен - для авторизации по токену его нужно создать в вашем аккаунте Jira в настройках безопасности. Для базового типа авторизации в это поле нужно вписать пароль пользователя, которого указали в п.2.
6. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
7. Активен - включите бегунок для активации интеграции.

Не забудьте сохранить настройки!

Блок Jira в заявке:

Подключение Yandex Tracker

1. Сloud Organization ID - идентификатор организации, который можно найти в разделе Настройки > Организации, если используется платформа Yandex Cloud
2. Organization ID - в некоторых случаях используется вместо Сloud Organization ID, если используется платформа Яндекс 360 для бизнеса. В большинстве случаев поле остаётся пустым.
3. Трекер URL - обычно https://tracker.yandex.com
4. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
5. Токен авторизации приложения. (См. инструкцию по получению токена)
6. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
7. Активен - включите бегунок для активации интеграции.

Не забудьте сохранить настройки!

Блок Yandex в заявке:

Подключение Youtrack

1. Трекер URL - адрес Youtrack из адресной строки браузера.
2. Дополнительные поля - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
3. API Токен - инструкции как создать.
4. Таймаут - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
5. Активен - включите бегунок для активации интеграции.

Не забудьте сохранить настройки!

Блок Youtrack в заявке: