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

Плагин импортеров JIRA, который поставляется вместе с JIRA, позволяет импортировать ваши данные из файла с разделителями-запятыми (CSV). CSV-файлы представляют собой текстовые файлы, представляющие табличные данные и поддерживаемые большинством приложений, которые обрабатывают табличные данные (например, Microsoft Excel, базы данных и т. д.).

Функция импорта CSV позволяет импортировать задачи из внешней системы (системы отслеживания задач), которая:

JIRA не предоставляет специализированный инструмент импорта и

Может экспортировать свои данные в структурированный / табличный формат (предпочтительно CSV).

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

Процесс импорта CSV состоит из выполнения предварительных шагов:

1. Подготовка файла CSV (см. ниже).
2. Запуск мастера импорта файлов CSV (ниже).

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

Обратите внимание:

• Для импорта данных из других систем отслеживания задач в JIRA доступны несколько методов. В зависимости от вашей другой системы отслеживания задач может быть более целесообразным использовать один из этих других методов, чем сначала экспортировать данные из этой системы в файл CSV, а затем импортировать этот CSV-файл в JIRA. Если ваша другая система отслеживания задач указана на странице «Миграция с другого трекера задач», попробуйте использовать соответствующий метод для этого трекера задач (который доступен с этой страницы) для импорта данных в JIRA.
• Если вы хотите поднять отчет об ошибке (баге) или предложение по улучшению этой функции, сделайте это в проекте плагина импортеров JIRA.

Подготовка файла CSV

Плагин импортеров JIRA  предполагает, что ваш CSV-файл основан на стандартном CSV-файле Microsoft Excel. Поля разделяются запятыми, и любое содержимое, которое должно обрабатываться буквально, например запятые и новые строки / «возврат каретки», заключены в кавычки.

Для Microsoft Excel и OpenOffice нет необходимости указывать значения в ячейках, так как эти приложения обрабатывают это автоматически.

Требования к файлам CSV

В дополнение к «хорошо сформированным» файлам, к  файлам CSV предъявляются  следующие дополнительные требования:

Каждый файл CSV должен иметь строку заголовка с  столбцом резюме.

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

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

Строка заголовка должна содержать столбец для данных «Резюме» (Summary).

Запятые (как разделители столбцов / полей) не могут быть опущены.

Например, это действительно:

Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", admin, admin, 1, ,

а это недействительно:

Summary, Assignee, Reporter, Issue Type, Description, Priority
"Test issue", admin, admin, 1

Инкапсулирование структуры данных JIRA в файл CSV

Захват данных, охватывающих несколько строк

Используйте двойные кавычки (") в файле CSV для захвата данных, которые охватывают несколько строк. Например, при импорте JIRA будет рассматривать следующее как действительный файл CSV с недостатком

Summary, Description, Status
"Login fails", "This is on
a new line", Open

Обработка специальных символов буквально

Используйте двойные кавычки (") вокруг раздела текста, чтобы обрабатывать любые специальные символы в этом разделе буквально. После того, как эти данные будут импортированы в JIRA, эти специальные символы будут сохранены как часть данных поля JIRA. Примеры специальных символов включают в себя  возврат каретки / введение символов (как показано в примере выше), запятые и т. д.

Чтобы обрабатывать знак двойной кавычки буквально, вы можете «избежать» с помощью другого символа метки двойной кавычки. Следовательно, значение CSV:

• «Нажатие кнопки « Добавить» (Add) приводит к странице не найденной ошибки», после импорта, которая будет храниться в JIRA как:
• «Нажатие кнопки «Добавить» (Add) приводит к странице не найденной ошибки»

Объединение нескольких значений в отдельные поля JIRA

Вы можете импортировать несколько значений в поле JIRA, которое принимает несколько значений (например, Исправленная версия (Fix (for) Version), Влияние на версию (Affects Version), Компонент (Component), Метки (Labels)). Для этого файл CSV должен указывать одно и то же имя столбца для каждого значения, которое вы хотите объединить, в сопоставляемое поле JIRA. Количество указанных имен столбцов должно соответствовать максимальному количеству значений для объединения в сопоставляемое  поле. Например:

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component
bug, "First issue", v1, , , Component1,
bug, "Second issue", v2, , , Component1, Component2
bug, "Third issue", v1, v2, v3, Component1,

В приведенном выше примере поле Component второго выпуска и поле Fix Version третьей задачи генерируют несколько значений в соответствующих полях JIRA при импорте.

Помните, что только ограниченное число полей JIRA поддерживает несколько значений. Импортер CSV не позволит вам импортировать объединенные данные в поля JIRA, которые поддерживают только одно значение.

Импорт вложений

Вы можете прикреплять файлы к задачам, созданным из файла CSV. Для этого укажите URL-адрес вашего вложения в столбце «Вложения» в файле CSV.

Assignee, Summary, Description, Attachment, Comment
Admin, «Задача демонстрирующая импорт вложения CSV», «Пожалуйста, проверьте прилагаемый образ ниже». «Https: // jira-server: 8080 / secure / attachment / image-name.png», «01/01/2012 10 : 10; Admin; Этот комментарий работает 
Admin, «Импорт вложения CSV с меткой времени, автором и именем файла», «Пожалуйста, ознакомьтесь с прилагаемым изображением ниже», «01/01/2012  13: 10; Admin; image.png; file: //image-name.png» ,  "01/01/2012 10: 10; Admin, Этот комментарий работает"

URL-адреса для вложений поддерживают протоколы HTTP и HTTPS и могут быть любым местом, к которому должен иметь доступ JIRA-сервер. Вы также можете использовать протокол FILE для доступа к файлам в подкаталоге импорт / вложения вашего домашнего каталога JIRA.

Создание подзадач

Вы можете создавать подзадачи задач через импорт файла CSV, инкапсулируя эту структуру в свой CSV-файл.

Чтобы сделать это:

• Для вашего CSV-файла требуются два дополнительных столбца, заголовки которых должны быть названы аналогично идентификатору задачи (Issue Id) и идентификатору родителя (Parent Id).
• Убедитесь, что каждой стандартной (не подзадаче) задаче присваивается уникальный (последовательный) номер в столбце «Идентификатор задачи» (Issue Id). Не добавляйте значения в поля родительского идентификатора (Parent Id) для стандартных задач.
• Чтобы создать подзадачу стандартной задачи в вашем CSV-файле, обратитесь к уникальному номеру индентификатора задачи (Issue Id) стандартной задачи в столбце  (Parent Id) «идентификатор родителя». Не включайте значения в поля «Идентификатор задачи для подзадач (Issue Id).

ПРИМЕР:

IssueType, Summary, FixVersion, FixVersion, FixVersion, Component, Component, Issue ID, Parent ID, Reporter
Bug, "First issue", v1, , , Component1, , 1, , jbloggs
Bug, "Second issue", v2, , , Component1, Component2, 2, , fferdinando
Bug, "Third issue", v1, v2, v3, Component1, , 3, , fferdinando
Sub-task, "Fourth issue", v1, v2, , Component2, , , 2, jbloggs

В приведенном выше примере четвертая задача будет подзадачей второй задачи при импорте, предполагая, что вы сопоставляете поля «Идентификатор задачи» (Issue Id) и «Идентификатор родителя» (Parent Id) в файле CSV с полями «Идентификатор задачи» и  «Идентификатор родителя» JIRA, соответственно, во время выполнения мастера импорта файлов CSV.

 

Импорт задач в несколько проектов JIRA

Вы можете импортировать задачи из своего CSV-файла в разные проекты JIRA через импорт файла CSV. Чтобы сделать это:

• Для вашего CSV-файла требуются два дополнительных столбца, заголовки которых должны быть названы аналогично имени проекта (Project Name) и его ключевому слову (Project Key) .
• Убедитесь, что каждая задача, представленная в вашем файле CSV, содержит соответствующее имя и ключ в этих столбцах для проектов JIRA, для которых они будут импортированы.

Название проекта и ключевые данные - это минимальные данные проекта JIRA, необходимые для импорта задач из файла CSV в конкретные проекты JIRA.

IssueType, Summary, Project Name, Project Key
bug, "First issue", Sample, SAMP
bug, "Second issue", Sample, SAMP
task, "Third issue", Example, EXAM

В приведенном выше примере первая и вторая задачи будут импортированы в проект «Пример» (с ключом проекта «SAMP»), а третья задача будет импортирована в проект «Пример» (с ключом проекта «EXAM»), предполагая вы сопоставляете поля «Имя проекта» (Project Name) и «Ключ проекта» (Project Key) в CSV-файле с полями «Имя проекта» и  «Ключ проекта» в JIRA, соответственно, во время выполнения мастера импорта файлов CSV.

Как решать неразрешенные задачи

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

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

Для этих четырех полей в списке выбора есть две специальные опции в дополнение к доступным значениям JIRA:

• «Импорт как пустой» (Import as blank) - это приводит к тому, что значение JIRA будет пустым для этого поля. Обратите внимание, что если вы импортируете нерешенные задачи, вы должны создать сопоставление полей для поля «Разрешение» (Resolution) и установить для параметра «Неразрешенный» (Unresolved) значение «Импортировать как пустое» (Import as blank).
• «Нет сопоставления» (No mapping) - это попытка импортировать значение в CSV-файл как есть. Обратите внимание, что использование «Нет сопоставления» для значения поля приведет к неудачному импорту, если значение недействительно для этого поля JIRA. Для сопоставления полей по статусу и типу задачи значения по умолчанию используются, когда выбрана опция «Импортировать как пустое» (Import as blank).

Импорт  журнальных записей

Ваш CSV-файл может содержать записи в журнале. Например:

Резюме, Журнал событий
Только потраченное время (один час), 3600 С датой и автором, 2012-02-10 12: 30: 10; wseliga; 120 С дополнительным комментарием, Тестирование заняло у меня 3 дня, 2012-02-10 12: 30: 10; wseliga; 259200 

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

Импортирование в несколько избранных пользовательских полей

Ваш CSV-файл может содержать несколько записей для одного из некольких избранных пользовательских полей. Например:

Сводка, Multi Select, Multi Select, Multi Select
Образец задачи, значение 1, значение 2, значение 3

Это заполнит множество выбранных пользовательских полей несколькими значениями.

Импорт пользовательских полей каскадного выбора

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

Резюме, мое каскадное пользовательское поле
Пример Резюме, Родительское значение -> дочернее значение

Разделитель '->' позволяет вам импортировать иерархию.

ПРИМЕЧАНИЕ. В настоящее время JIRA не поддерживает импорт многоуровневых каскадных полей выбора через CSV (JRASERVER-34202 - разрешить импорт CSV для поддержки полей плагина многоуровневого каскадного выбора OPEN).

Обновление существующих задач

Начиная с версии 4.3 плагина импортеров JIRA  вы можете обновлять существующие задачи. В файле CSV должен содержаться столбец, который во время выполнения мастера импорта сопоставляется с ключом задачи. Если задача существует для данного ключа, она будет обновлена. Например:

ключ задачи, резюме, голоса, метки, метки
TT1, Оригинальное резюме, 1, label1, label2
TT 1, 7, метка 1, метка 2
TT 1, Измененное резюме,
TT 2, Оригинальное резюме 2,1, метка 1, метка 2
TT-2,,<<!clear!>>, <<!clear!>>,

Первая строка создаст задачу, вторая строка установит голоса до 7 и добавит две метки. Следующая строка изменит резюме. Проблема TT-2 будет создана с двумя метками, вторая строка удалит эти метки специальным маркером <<! Clear! >>.

Импорт CSV для обновления существующих задач приведет к сбросу столбцов к значениям по умолчанию, если они не указаны в CSV.

Запуск мастера импорта файлов CSV

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

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

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

3. На странице импорта файлов CSV (CSV File import) выберите свой CSV-файл (CSV Source File). Если вы хотите изменить кодировку файла и формат разделителя CSV, нажмите кнопку «Дополнительно» ( Advanced), чтобы открыть эту опцию (как показано на скриншоте выше).

Примечание:

• Файл будет импортирован с использованием кодировки файла (File encoding), указанной здесь (по умолчанию это UTF-8).
• Если ваш CSV-файл использует другой разделительный символ, отличный от запятой, укажите этот символ в поле разделителя CSV ( CSV Delimiter).

4. Оставьте флажок Использовать существующий файл конфигурации очищенным (Use an existing configuration file), если у вас нет файла конфигурации или вы хотите создать новый файл конфигурации. Файлы конфигурации определяют сопоставление между именами столбцов в строке заголовка файла CSV и полях в вашей установке JIRA.

Заметка:

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

5. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки сопоставления проектов мастера импорта файлов CSV.
6. На странице настройки сопоставлений проектов (Setup project mappings) вы можете либо импортировать все свои задачи в один проект JIRA (новый или существующий), либо несколько проектов JIRA (гарантируя, что ваш файл CSV содержит минимальные требуемые данные проекта JIRA - то есть название проекта JIRA и ключ).

Заполните следующие поля / параметры:

 

7. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки сопоставления полей (Setup field mappings) мастера импорта файлов CSV.
8. На странице настройки сопоставлений полей (Setup field mappings) укажите каждое поле CSV (CSV Field) (определяемое строкой заголовка файла CSV), которое вы хотите импортировать в выбранный проект JIRA, установив флажки слева в столбце «Импорт» (Import).

Обращаем ваше внимание,

• По крайней мере одно из этих полей должно содержать данные для поля «Резюме» (Summary) JIRA.
• Если в файле CSV содержится более одного и того имени поля, указанного в его строке заголовка, мастер импорта файлов CSV объединяет их в одно поле, которое на этом шаге мастера будет помечено символом (предупреждением).

9. В столбце поля JIRA (JIRA field) выберите поля JIRA, которые вы хотите сопоставить с полями, определенными в вашем файле CSV (т. е. каждое поле CSV ( CSV Field), выбранное на предыдущем шаге). Дополнительные сведения о сопоставлении полей CSV с полями JIRA см. в разделе «Советы по импорту данных CSV в поля JIRA ниже».

 

Пожалуйста, обратите внимание:

• Поле «Резюме» (Summary) должно быть указано для одного из ваших полей JIRA, и кнопка «Далее» (Next) останется недоступной, пока вы это не сделаете.

• Для полей CSV, которые были агрегированы с помощью мастера импорта файлов CSV, вы сможете выбирать только поля JIRA, которые поддерживают несколько значений.
• Если вы импортируете подзадачи, не забудьте сопоставить поля идентификатора задачи (Issue ID) и родительского идентификатора (Parent ID) в JIRA с данными в вашем CSV-файле.
• Если вы импортируете задачи в несколько проектов, убедитесь, что вы выбрали «Определено в CSV» (Defined in CSV) во время вышеперечисленного шага настройки сопоставлений проектов (Setup project mappings) и не забудьте сопоставить поля «Имя проекта» (Project Name) и «Ключ проекта» (Project Key) в JIRA с данными в вашем CSV-файле.

10. Чтобы изменить значения данных любых полей в CSV-файле до их импорта в JIRA, установите флажок «Значение поля сопоставления» (Map field value) рядом с соответствующими полями.
11. Нажмите кнопку «Далее» (Next), чтобы перейти к шагу настройки сопоставления значений (Setup value mappings) мастера импорта файлов CSV.
12. На странице сопоставлений значений (Setup value mappings) установки укажите значения полей JIRA для каждого значения поля файла CSV (которое было обнаружено мастером импорта файлов CSV).

Обращаем ваше внимание,

• Любые поля, на которых были выбраны флажки сопоставление значений полей (Map field value) на предыдущем шаге мастера импорта файлов CSV будут отображены на этой странице.
• Оставьте поле очищенным или очистите любой контент внутри него, если вы хотите импортировать значение «как есть».

Независимо от того, установлен ли флажок «сопоставление значений полей», JIRA автоматически создаст имена пользователей на основе данных в вашем CSV-файле, если они еще не определены в JIRA.

• Вы можете создать новые значения приоритета (Priority), разрешения (Resolution) и типа задачи (Issue Type) в JIRA (т. е. на основе данных в вашем CSV-файле), щелкнув ссылку «Добавить новый ...» (Add new ... )(например, добавить новую задачу типа «подзадача» (Add new issue type 'subtask'), показанная на скриншоте выше) рядом с соответствующим полем.
• Если вы импортируете CSV-поле на основе имени пользователя (например, (Исполнитель или Представитель), и вы не выбираете флажок сопоставления значений полей (Map field value) для этого поля на предыдущем шаге мастера импорта файлов CSV, тогда импортер автоматически сопоставляет импортированные имена пользователей из CSV-файла с (нижнем регистре) именами JIRA.

13. Нажмите кнопку «Начать импорт» (Begin Import), когда вы будете готовы начать импортировать данные CSV в JIRA. Импортёр будет отображать обновления по мере продвижения импорта, а затем выдаст сообщение об успешном завершении, когда импорт будет завершен.

Примечание:

• Если у вас возникли проблемы с импортом (или вам интересно), нажмите кнопку «Загрузить подробную ссылку на журнал», (Download a detailed log) чтобы просмотреть подробную информацию о процессе импорта файлов CSV.
• Если вам нужно импортировать другой CSV-файл с теми же (или похожим) настройками, которые вы использовали в этой процедуре, щелкните ссылку сохранения конфигурации (Save the configuration) для загрузки файла конфигурации CSV, который вы можете использовать на первом шаге мастера импорта файла CSV .

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

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

Ниже приведены некоторые полезные советы при импорте данных из файла CSV в определенные поля JIRA:

 

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