# Интеграция с трекерами задач разработки
# Возможности интеграции
К Swarmica можно подключить трекер задач для связывания задач с заявками. На данный момент доступны к подключению следующие трекеры:
* [Yandex Tracker](https://support.swarmica.com/article/ru/219-integraciya-s-trekerami-zadach-razrabotki.html#podklyuchenie-yandex-tracker)
* [Jira](https://support.swarmica.com/article/ru/219-integraciya-s-trekerami-zadach-razrabotki.html#podklyuchenie-jira)
* [Gitlab](https://support.swarmica.com/article/ru/219-integraciya-s-trekerami-zadach-razrabotki.html#podklyuchenie-gitlab)
* [Youtrack](https://support.swarmica.com/article/ru/219-integraciya-s-trekerami-zadach-razrabotki.html#podklyuchenie-youtrack)
По запросу подключается:
* Kaiten
При работающей интеграции на странице заявки можно осуществить поиск по задачам в трекере при помощи поля поиска в правом верхнем углу страницы заявки. По ключевым словам находится задача:
Если задача имеет ключевое отношение к заявке, сотрудник прикрепляет задачу к заявке опцией **Добавить в заявку**.
После прикрепления задача находится на странице заявки в правой её части. Прямо со страницы заявки без перехода в трекер можно увидеть заголовок, текст и все параметры заявки: тип, теги, статус. В нижней части блока можно увидеть имя сотрудника, добавившего задачу в заявку, и срок с момента добавления заявки.
Значком корзины  можно открепить задачу от заявки, если она была прикреплена по ошибке или потеряла актуальность. Значком обновления  можно обновить данные прикреплённой задачи.
Значок может в зависимости от типа трекера находиться в правом нижнем углу блока с задачей или рядом со статусом:
Когда задача будет закрыта, в заявку, связанную с этой задачей, добавится событие, а ответственному придёт уведомление на email.
# Интеграция с трекерами
Для интеграции с вашим трекером перейдите в **Настройки - Трекеры задач**:
На открывшейся странице нажмите на название вашего трекера.
### Подключение Gitlab
1. **Трекер URL** - адрес gitlab из адресной строки браузера.
2. **Дополнительные поля** - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
3. API **Токен** - создаётся в Gitlab в **User Settings - Access tokens**, обязательно отметить read\_api! Чтобы создавать задачи из Свормики, так же требуется отметить api и роль Reporter.
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** - идентификатор организации, который можно найти в разделе [Настройки > Организации](https://tracker.yandex.com/admin/orgs), если используется платформа Yandex Cloud
2. **Organization ID** - в некоторых случаях используется вместо Сloud Organization ID, если используется платформа Яндекс 360 для бизнеса. В большинстве случаев поле остаётся пустым.
3. **Трекер URL** - обычно [https://tracker.yandex.com](https://tracker.yandex.com/)
4. **Дополнительные поля** - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
5. **Токен** авторизации приложения. (См. [инструкцию по получению токена](https://yandex.cloud/ru/docs/tracker/concepts/access#section_about_OAuth))
6. **Таймаут** - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
7. **Активен** - включите бегунок для активации интеграции.
Не забудьте сохранить настройки!
Блок Yandex в заявке:
### Подключение Youtrack
1. **Трекер URL** - адрес Youtrack из адресной строки браузера.
2. **Дополнительные поля** - опциональные поля из трекера, которые должны содержаться в задаче для её передачи в Swarmica.
3. API **Токен** - [инструкции как создать](https://www.jetbrains.com/help/youtrack/server/manage-authentication-tokens.html#generate-token-other-user).
4. **Таймаут** - временной промежуток в секундах, в течение которого Swarmica будет обращаться к трекеру при отсутствии моментального ответа. По умолчанию 30 секунд, менять этот параметр не рекомендуется, за исключением особых требований вашего девопса или сетевого администратора.
5. **Активен** - включите бегунок для активации интеграции.
Не забудьте сохранить настройки!
Блок Youtrack в заявке:
