Импорт данных из Mantis

Плагин  импортеров JIRA, который поставляется вместе с JIRA, позволяет пользователю JIRA импортировать данные из Mantis, подключившись к базе данных Mantis в реальном времени.

Наш главный сайт освещает некоторые основные причины, по которым пользователи мигрируют из Mantis в JIRA.

Версия 4.2 или новее плагина JIRA Importers совместима с версиями Mantis с 1.1.8 по 1.2.8. Плагин  импортеров JIRA требует, чтобы ваша база данных Mantis была MySQL, PostgreSQL или Microsoft SQL Server. Мы также получили сообщения о том, что плагин JIRA Importers работает с базами данных Oracle и DB2. (Однако мы не тестировали этот плагин против этих баз данных.)

Процесс импорта Mantis состоит из простого запуска мастера импорта Mantis (см. ниже).

  • Вы можете выбрать отображение отдельных полей и значений полей в процессе импорта, некоторые из которых являются обязательными.
  • В конце мастера импорта Mantis вам будет предоставлена возможность создания файла конфигурации Mantis, который содержит настройки, выбранные вами при работе с мастером импорта Mantis. Это полезно тем, что перед выполнением импорта в производственной системе, у вас есть возможность  сначала протестировать импорт Mantis на тестовом JIRA-сервере 

Для того чтобы произвести запуск мастера импорта Mantis, необходимо выполнить следующие шаги:

  1. Прежде чем начать,сделайте резервное копирование данных JIRA.
  2. Войдите в JIRA как пользователь с глобальными правами администратора JIRA.
  3. Выберите > «Система» (System). Выберите «Импорт и экспорт» (Import & Export)> «Внешняя система импорта» (External System Import), чтобы открыть страницу «Импорт внешних проектов».

Комбинация клавиш: g + g + начало ввода внешнего импорта системы

  1. Выберите кнопку «Импорт» (Import), связанную с опцией «Мантис», чтобы открыть страницу «Мастер импорта Mantis»: «Настройка» (Mantis Import Wizard: Setup).
  2. На странице «Мастер импорта Mantis: Setup» (Mantis Import Wizard: Setup) заполните следующие поля / параметры:

URL-адрес Mantis

Укажите URL вашего сайта Mantis. Это URL, который вы обычно используете для доступа к Mantis через веб-браузер.

Укажите учетные данные

Установите этот флажок, если вы хотите импортировать задачи Mantis в JIRA, для чего вам нужны учетные данные пользователя на вашем сайте Mantis для доступа к ним.

При выборе этого флажка отображаются / скрываются поля Mantis Логин и Mantis Пароль (Mantis Login and Mantis Password), в которых вы должны указать эти учетные данные пользователя.

Тип базы данных

Выберите тип базы данных, который использует ваша установка Mantis:

  •          PostgreSQL
  •          Microsoft SQL Server
  •          MySQL

Имя хоста

Укажите имя хоста или IP-адрес сервера, на котором запущен сервер базы данных сайта Mantis.

Порт

Укажите порт TCP / IP, который прослушивает сервер базы данных сайта Mantis.

Это поле автоматически заполняется значением порта по умолчанию на основе выбранного вами типа базы данных (Database Type).

База данных

Укажите имя вашей базы данных Mantis (в которой Mantis сохраняет свои данные).

Имя базы данных, имя пользователя и пароль пользователя обычно можно найти в файле Mantis config_inc.php. (Как правило, имя пользователя по умолчанию - «root», а пароль по умолчанию пуст). См. также http://www.mantisbt.org/manual/manual.configuration.database.php

Имя пользователя

Укажите пользователя базы данных, который Mantis использует для подключения к своей базе данных.

Пароль

Укажите пароль пользователя базы данных (выше), который Mantis использует для подключения к своей базе данных.

Использовать существующий файл конфигурации

Оставьте этот флажок очищенным, если у вас нет файла конфигурации или вы хотите создать новый файл конфигурации. Файлы конфигурации определяют сопоставление полей в Mantis и JIRA.

Примечание:

  • Если вы выберете эту опцию, вам будет предложено указать существующий файл конфигурации (Configuration File).
  • Если эта опция не выбрана, то в конце мастера импорта Mantis JIRA создаст файл конфигурации, который вы можете использовать для последующих импортных поставок Mantis (для повторного использования на этом этапе мастера импорта Mantis).

Параметры соединения JDBC

(в расширенной вкладке «Дополнительно»)

Мастер импорта Mantis будет создавать URL-адрес базы данных JDBC из данных сервера базы данных Mantis, указанных выше. JIRA использует этот URL для подключения и импорта задач от Mantis. Если вам нужно указать какие-либо дополнительные параметры подключения к вашей базе данных Mantis, укажите их здесь.

Если вы выбрали MySQL (см. выше), Mantis Import Wizard по умолчанию добавит несколько дополнительных параметров подключения.

 

  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу «Настроить сопоставления проекта» (Set up project mappings) мастера импорта Mantis.
  2. На странице «Настроить сопоставления проекта» (Set up project mappings) выберите, какие проекты Mantis вы хотите импортировать в JIRA.

Все проекты Mantis выбраны по умолчанию, поэтому снимите флажки в разделе «Импорт проектов Mantis», которые вы не хотите импортировать в JIRA.

Для проектов Mantis, которые вы хотите импортировать в JIRA, нажмите «Выбрать проект» (Select a project), а затем выполните одно из следующих действий:

  • Начните вводить имя  (или ключ) проекта, который уже существует в JIRA, или используйте раскрывающееся меню, чтобы выбрать существующий проект JIRA.
  • В раскрывающемся меню выберите «Создать новое» (Create New) и в появившемся диалоговом окне «Добавить новый проект» (Add A New Project) введите следующее:
    • Новое название проекта (Name)
    • Новый ключ проекта (Key)

Это будет использоваться как префикс для всех идентификаторов задач в вашем проекте JIRA.

  • Руководитель проекта (Project Lead).

 

        8. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу «Настройка пользовательских полей» (Set up custom fields) мастера импорта Mantis.

Этот шаг будет почти всегда появляться, потому что хотя бы одно поле Mantis вряд ли соответствует существующему полю JIRA.

  1. На странице «Настроить пользовательские поля» (Set up custom fields) для каждого внешнего поля (External field) в Mantis, которое мастер импорта Mantis не может сопоставить с существующим полем JIRA, вы можете выбрать:
  • мастер импорта Mantis автоматически создает новые пользовательские поля в JIRA на основе имен полей Mantis. Это опция по умолчанию - при этом имена пользовательских полей JIRA, которые будут автоматически созданы, отображаются в раскрывающихся списках полей JIRA.
  • создайте свои собственные пользовательские поля в JIRA для отображения данных из полей Mantis. Чтобы сделать это, выберите «Другое» (Other) в раскрывающемся списке полей JIRA и укажите имя своего пользовательского поля в новом поле, появляющемся непосредственно ниже «Другое» (Other).
  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки сопоставления полей мастера импорта Mantis.
  2. На странице настройки сопоставления полей (Set up field mappings) , если есть внешние поля (External fields) в Mantis, значения которых вы хотите изменить до их импорта в JIRA, установите флажки «Значение поля сопоставления» (Map field value) рядом с соответствующими полями.

Обратите внимание, что необходимо обязательно указать поле статуса Mantis (т. е.Status) для определенных значений поля JIRA Status, поскольку поле JIRA Status является неотъемлемой частью рабочих процессов JIRA.

Другие внешние поля в Mantis, которые, вероятно, появятся на странице настройки сопоставления полей, следующие:

Внешнее поле в Mantis

Не выбрав флажок «Значение поля сопоставления»

Имя пользователя

Мастер импорта Mantis автоматически сопоставляет имена пользователей Mantis с именами JIRA (строчными буквами).

Приоритет

Мастер импорта Mantis автоматически создаст отсутствующие значения в JIRA и обеспечит, чтобы задачи были перенесены с правильным приоритетом (например, «Нормальный» (Normal) в Mantis на вновь созданный «Нормальный» (Normal) в JIRA).

Точность

Мастер импорта Mantis не будет отображать значения для этого поля.

Разрешение

Импортер создаст соответствующие Разрешения в JIRA вместо использования существующих.

 

Выберите подходящую схему рабочего процесса (Workflow Scheme) JIRA, в которой будут использоваться задачи Mantis, которые вы импортируете в ваш проект JIRA.

Если вы импортируете свои задачи Mantis в существующий проект JIRA, убедитесь, что вы выбрали схему рабочего процесса JIRA, используемую этим существующим проектом JIRA.

  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки сопоставления значений мастера импорта Mantis.
  2. На странице настройки сопоставления значений укажите значения полей JIRA для каждого значения поля Mantis (как обнаружено мастером импорта Mantis).

На этой странице будут представлены любые поля (Map field value), чьи опции значения поля сопоставления были выбраны на предыдущем шаге мастера импорта Mantis, включая обязательное поле Mantis статуса.

  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу «Настройка ссылок» (Set up links) мастера импорта Mantis.
  2. На странице «Настройка ссылок» (Set up links) укажите тип ссылки JIRA для каждого типа ссылки Mantis (как обнаружено мастером импорта Mantis). Подробнее о типах ссылок JIRA см. в разделе «Настройка связывания задач».
  3. Нажмите кнопку «Начать импорт» (Begin Import), когда вы будете готовы начать импорт ваших данных Mantis в JIRA. Импортёр будет отображать обновления по мере продвижения импорта, а затем выдаст сообщение об успешном завершении, когда импорт будет завершен.

Примечание:

  • Если у вас возникли проблемы с импортом (или вам интересно), нажмите кнопку загрузки подробной ссылки на журнал, чтобы просмотреть подробную информацию о процессе импорта Mantis мастером.
  • Если вам нужно импортировать данные из другого продукта / проекта Mantis или сайта с теми же (или аналогичными) параметрами, которые вы использовали в этой процедуре, щелкните сохранение ссылки конфигурации для загрузки файла конфигурации Mantis, который вы можете использовать на первом шаге мастера импорта Mantis.

Поздравляем, вы успешно импортировали свои проекты Mantis в JIRA! Если у вас есть какие-либо вопросы или возникают какие-либо проблемы, обратитесь в службу поддержки Atlassian.

Советы по импорту данных Mantis в поля JIRA

Во время процесса импорта следующие данные копируются из базы данных Mantis в JIRA:

В Mantis

В JIRA

Заметки об импорте

Проект

Подпроект

Проект

Данные Mantis импортируются по каждому проекту. Вы можете либо указать существующий проект JIRA в качестве цели, либо импортер автоматически создаст для вас проект (ы) во время импорта. (Дополнительную информацию о проектах JIRA см. в  разделе «Определение проекта»).

Категория

Компонент

Вы можете выбрать, чтобы импортер автоматически создавал ваши компоненты Mantis в JIRA или выбирал, чтобы ошибки (баги) были импортированы без компонента в JIRA.

Версия

Исправленная версия

Версии импортируются из Mantis (если вы выберете). После импорта вы можете вручную установить соответствующие версии в состояние «Выпущено» в JIRA, если хотите.

Баг

Задача

Каждая ошибка (баг) Mantis становится задачей JIRA типа «Ошибка (Баг)».

Индентификатор

Индентификатор импорта ошибки (бага)

Каждой импортируемой задаче будет присвоен новый идентификатор JIRA, а старый идентификатор Mantis будет сохранен в пользовательском поле JIRA с именем «Идентификатор импорта ошибок». Это настраиваемое поле доступно для поиска, поэтому вы можете искать проблемы JIRA по своему старому идентификатору Mantis. Если вам не нужно это пользовательское поле, удалите его или «спрячьте» его (как описано в разделе «Указание поведения поля»).

Резюме

Резюме

 

Описание

Описание

В тексте ссылки Mantis (например, # 1234) преобразуются в ссылки JIRA (например, TST-123).

Комментарии

Комментарии

В тексте ссылки Mantis (например, # 1234) преобразуются в ссылки JIRA (например, TST-123).

Вложения

Вложения

Вложения извлекаются из базы данных Mantis и сохраняются на диске. Чтобы указать местоположение на диске, см. раздел «Настройка  вложений файлов».

Приоритет

Приоритет (или пользовательское поле)

Вы можете выбрать отображение  одного из полей приоритета Mantis  или поле точности Mantis (см. ниже) во встроенное поле приоритета JIRA, а другое - в пользовательское поле.

(В качестве альтернативы вы можете выбрать как поле приоритета Mantis, так и поле точности для настраиваемых полей JIRA.) При импорте в поле приоритета JIRA вы можете настроить отображение конкретных значений Mantis на определенные значения JIRA.

Точность

Приоритет (или пользовательское поле)

Вы можете выбрать отображение одного из полей приоритета Mantis  (см. выше) или поле точности Mantis во встроенное поле приоритета JIRA, а другое - в пользовательское поле. (В качестве альтернативы вы можете выбрать как поле приоритета Mantis, так и поле точность (Severity) для пользовательских полей JIRA.) При импорте в поле приоритета JIRA вы можете настроить отображение конкретных значений Mantis на определенные значения JIRA

Статус

Статус

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

Разрешение

Разрешение

Вы можете настроить сопоставление конкретных значений Mantis для определенных значений JIRA.

Отношения

Ссылки

Вы можете настроить сопоставление типов отношений Mantis с типами ссылок JIRA.

Список СС

Наблюдатели

 

Пользователь

Пользователь

Вы можете выбрать, чтобы импортер автоматически создавал пользователей JIRA для любых пользователей Mantis, которые еще не существуют в JIRA.

  • Пользователи, которые взаимодействуют с системой Mantis, будут созданы как активные учетные записи в JIRA. Другие пользователи будут импортированы в специальную группу под названием «mantis-import-unused-users» и будут деактивированы.
  • Пароли из Mantis не импортируются (поскольку они хэшируются в базе данных). Пользователи из Mantis должны будут получить свои пароли, отправленные им по электронной почте, при первом входе в JIRA.
  • Пользователи, не имеющие реального имени, хранящиеся в Mantis, получат часть своего адреса электронной почты (имя пользователя) до символа «@» в качестве полного имени в JIRA.
  • Если вы используете внешнее управление пользователями, процесс импорта не сможет создавать пользователей JIRA; вместо этого импортер предоставит вам список новых пользователей, которые должны быть созданы. Перед началом импорта вам нужно будет создать пользователей во внешнем пользовательском репозитории.
  • Если у вас есть ограниченная пользователем лицензия (например, личная лицензия), а количество требуемых пользователей превышает лимит, то импорт будет остановлен. Отобразится страница с указанием списка пользователей, которые не могут быть созданы.

Другие поля

 

Пользовательские поля

Если ваша система Mantis содержит какие-либо пользовательские поля, вы можете выбрать их сопоставление с определенными пользовательскими  полями JIRA. Если ваши пользовательские поля еще не существуют в JIRA, импортер может автоматически создать их для вас.

 

По материалам Atlassian JIRA Administrator's Guide: Importing Data from Mantis