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

Плагин импортеров JIRA, который поставляется вместе с JIRA, позволяет импортировать данные из Trac из сжатой среды Trac.

Наш главный сайт освещает некоторые основные причины, по которым пользователи переходят из Trac в JIRA.

Версия 2.6.1 или более поздняя версия плагина импортеров JIRA совместима с версией Trac версии 0.12.2.

Подготовка данных Trac для импорта в JIRA

Сожмите свою среду Trac:

  1. Обратитесь к своей среде Trac.
  2. Если вы используете SQLite (по умолчанию Trac), PostgreSQL или MySQL для вашей базы данных Trac, убедитесь, что ваш URL базы данных (определенный в файле conf / trac.ini Trac) также доступен с сервера JIRA (с использованием «localhost» или UNIX-сокета не будет работать).
  3. Архивируйте содержимое среды Trac без каких-либо ведущих каталогов.

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

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

  1. Войдите в JIRA как пользователь с глобальными правами администратора JIRA.
  2. Выберите «Администрирование» (Administration)> «Система» (System)> «Импорт и экспорт» (Import & Export)> «Импорт внешней системы» (External System Import)> «Импортировать» (Import), связанную с опцией Trac , чтобы открыть мастер импорта Trac: страница «Настройка» (Trac Import Wizard: Setup).

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

  1. На странице «Мастер импорта Trac: Setup» (Trac Import Wizard: Setup) выберите сжатый файл среды Trac, который вы подготовили выше.
  2. Оставьте флажок «Использовать существующий файл конфигурации» (Use an existing configuration file) очищенным, если у вас нет файла конфигурации или вы хотите создать новый файл конфигурации. Файлы конфигурации определяют сопоставление между полями в Trac и в JIRA.
  • Если вы выберете эту опцию, вам будет предложено указать существующий файл конфигурации (Existing Configuration File).
  • Если вы не выберете эту опцию, то в конце мастера импорта Trac JIRA создаст файл конфигурации, который вы можете использовать для последующего импорта Trac (для повторного использования на этом этапе мастера импорта Trac).
  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу сопоставления проектов проекта мастера импорта Trac.
  2. На странице сопоставлений проекта Setup (Setup project mappings) выберите, какие проекты Trac вы хотите импортировать в JIRA.
  • Начните вводить имя (или ключ) проекта, который уже существует в JIRA, или используйте раскрывающееся меню, чтобы выбрать существующий проект JIRA.
  • В раскрывающемся меню выберите «Создать новое» (Create New) и в появившемся диалоговом окне «Добавить новый проект» (Add A New Project) введите следующее:
  • Новое название проекта (Name).
  • Новый проект (Key).

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

  • Руководитель проекта (Project Lead).
  1. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки пользовательских полей (Setup custom fields) мастера импорта Trac.

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

  1. Пользовательские поля (Custom Fields): Если ваша система Trac содержит какие-либо пользовательские поля, вы можете либо импортировать их в существующее пользовательское поле JIRA, либо импортер автоматически создает новое пользовательское поле в JIRA.
  2. Независимо от того, задаете ли вы сопоставление, импортер автоматически создаст пользовательское поле JIRA для каждого дополнительного поля Trac, если вы не удалите опцию «Создать новые настраиваемые поля» (Create new custom fields) на последнем экране «Импортировать данные» (Import Data) (см. скриншот 2 ниже).
  3. Сопоставление значений полей (Field Value Mappings):
  • Поле «Приоритет» (Priority): Если вы не укажете сопоставления, импортер автоматически создаст отсутствующие значения в JIRA и обеспечит миграцию задач с правильным приоритетом.
  • Имена пользователей (Usernames): Если вы не укажете сопоставление, импортер автоматически сопоставляет имена пользователей Trac с именами JIRA (строчными буквами).

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

  • Поле «Статус» (Status): Обязательное сопоставление поля «Статус» Trac с определенными значениями поля «Статус»  JIRA, поскольку поле «Статус» JIRA является неотъемлемой частью рабочего процесса JIRA (чтобы узнать больше, см. раздел «Что такое рабочий процесс и Настройка рабочего процесса»).
  • Поле «Разрешение» (Resolution): Если вы не укажете сопоставление, импортер создаст соответствующие Разрешения в JIRA вместо использования существующих.
  • «Максимум задач и сбоев» (Maximum issues and failures): Если хотите, укажите максимальное количество неудавшихся задач, после которых импортер остановится. Если вы хотите, чтобы импорт продолжался независимо от каких-либо сбоев, оставьте это поле пустым. Если ваш экземпляр Trac имеет большое количество задач, обычно рекомендуется запустить сначала импортера по ограниченному числу задач (например, 100), а затем вручную проверить импортированные задачи, чтобы убедиться, что ваш файл конфигурации указан правильно. Когда результаты будут удовлетворительными, вы можете запустить импорт без ограничений.
  1. Импортёр будет отображать обновления по мере продвижения импорта, а затем покажет сообщение об успешном завершении, когда импорт будет завершен. Вы можете загрузить журнал импорта, если хотите.

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

В Trac

В JIRA

Примечания об импорте

Проектная среда

Проект

Каждая среда Trac импортируется как проект JIRA. Вы можете указать существующий проект JIRA в качестве цели, или импортер автоматически создаст проект для вас во время импорта.

Тип билета

Тип задачи

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

Билет #

Внешний идентификатор задачи

Номер Tick Trac записывается в пользовательском поле JIRA. Импорт не предназначен для того, чтобы номер задачи JIRA соответствовал номеру билета  Trac.

Статус

Статус

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

Резюме

Резюме

 

Описание

Описание

 

Версии

Версии

Версии импортируются из Trac (если вы выберете) и устанавливаются в «не выпущенное и разархивированное» состояние.

Компонент

Компонент

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

Комментарии

Комментарии

 

Приоритет

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

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

Severity (важность)

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

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

Этап

 Этап

JIRA создаст это как пользовательское поле.

Вложения

Вложения

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

Разрешение

Разрешение

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

CC

Наблюдатель

 

Ключевые слова

Метки

 

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

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

Импортер автоматически создаст JIRA-пользователей для любых пользователей Trac, которых нет в JIRA.

 

  • Пароли из Trac не импортируются. Пользователи из Trac должны будут отправлять свои пароли по электронной почте.
  • Если вы используете внешнее управление пользователями, процесс импорта не сможет создавать пользователей JIRA; вместо этого импортер предоставит вам список новых пользователей, которые должны быть созданы. Перед началом импорта вам нужно будет создать пользователей во внешнем пользовательском репозитории.

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

Другие поля

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

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

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