Общие настройки

Интеграция с трекерами может быть полезна при внедрении Devprom ALM в организацию, где уже используется какой-то трекер. Например, разработку требований можно вести в Devprom ALM, а разработкой кода управлять в уже используемом трекере.


Разные организации, использующие Devprom ALM, могут организовать обмен данными по общему проекту, сохраняя при этом работу в своих системах.


Devprom предоставляет очень гибкий механизм настройки для обмена данными с внешними трекерами, основанный на мэппинге между Devprom REST API и REST API трекера. Вы можете сопоставить модель данных Devprom модели данных трекера удобным для вас образом, то есть выбрать сущности и атрибуты, которые необходимо синхронизировать. По умолчанию мэппинг позволяет синхронизировать следующие данные (однако, объем функциональности зависит от конкретного трекера):

  • Релизы и версии
  • Пожелания и задачи, включая их состояния
  • Связи между пожеланиями
  • Приложения (атачменты), комментарии
  • Списанные часы

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


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

JIRA

URL, например, https://jira.atlassian.com

Проект - уникальный идентификатор проекта, например, JRASERVER

Имя пользователя и пароль для аутентификации.


В некоторых версия JIRA не поддерживается аутентификация пользователя в REST API по паре имя пользователя/пароль. В этом случае необходимо сгенерировать API Token и в поле "Имя пользователя" указать Email пользователя, а в поле "Пароль" указать API Token

Devprom ALM

URL, например, https://demo.myalm.ru

Проект - кодовое название проекта, которое можно взять из URL ссылок на страницы данных проекта, либо в модуле Настройки - Общие настройки.

Ключ API для аутентификации в REST API, можно получить на странице Ключи в профиле пользователя, под которым будет осуществляться обмен данными.

Redmine

URL, например, https://redmine.openpne.jp

Проект - уникальный идентификатор проекта, например, op3

HTTP-заголовки, необходимо скопировать ключ API в Redmine (свой для каждого пользователя) и указать его после X-Redmine-API-Key:

YouTrack

URL, например, https://youtrack.jetbrains.com

Проект - уникальный идентификатор проекта, например, JT

Имя пользователя и пароль для аутентификации.

Gitlab

URL, например, https://gitlab.com

ИД Проекта - уникальный идентификатор проекта, который указан под названием, на странице проекта:


Токен для аутентификации можно сформировать в разделе Настройки пользователя, в меню Токены доступы (Access Tokens).


Для синхронизации статусов и приоритетов необходимо настроить соответствие:

  • ссылочных имен состояний меткам, отвечающим за состояния в Gitlab;
  • ссылочных имен приоритетов (Администрирование - Настройки - Справочники - Приоритет) меткам, отвечающим за приоритеты в Gitlab.

Поскольку приоритеты и статусы задач в Gitlab определяются при помощи меток, необходимо дополнительно обеспечить хранение перечня меток, путем создания пользовательского атрибута с ссылочным именем GitlabLabels

TFS

URL, например https://instancename.visualstudio.com

Проект - название проекта или коллекции TFS

Персональный токен - может быть сгенерирован в настройках профиля пользователя TFS


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

Чтобы данные синхронизировались корректно, необходимо настроить мэппинг. На соответствующей вкладке отображается настройка мэппинга между Devprom ALM REST API и REST API целевой системы. Таким образом, для настройки мэппинга вам необходимо знать возможности этих API.