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

Импорт из файла CSV состоит из трех этапов. Во-первых, необходимо подготовить и проверить CSV файл. Затем создайте файл отображения, запустив мастер импорта CSV. Файл отображения - простой файл со свойствами текста, который Вы можете также вручную отредактировать. Он даст соответствие полей Вашего CSV к полям в JIRA. Наконец, для выполнения импорта, просто введите местоположение файла импорта и файл конфигурации.

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

Первое, что нужно сделать, это убедиться, что ваш CSV соответствует формату CSV. Хороший способ проверить это, чтобы импортировать файл в электронную таблицу (например, Microsoft Excel, Open Office).

Если у вас есть пустые значения, то лучше, если вы просто удалите их на этом этапе.

Для встроенных полей JIRA (например Fix-for version, Affects version, Component), если вы хотите выбрать более одного значения для запроса, вы должны будете иметь значение для каждого столбца в CSV файле, каждой колонке должно быть дано уникальное имя. Например:

IssueType,Summary,FixVersion_1,FixVersion_2
bug,"First issue",v1,
bug,"Second issue",v2,
bug,"third issue",v1,v2

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

Формат файла

Значения отдельных колонок разделяются разделительным символом — запятая (,) или точка с запятой (;). В США это запятая, а в России — точка с запятой, так как запятая используется для дробных чисел (в отличие от США, где это точка). Значения, содержащие зарезервированные символы, такие как: запятая, точка с запятой или новая строка обрамляются символом двойные кавычки ("); если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд.

Есть два требования к CSV:

• CSV файл должен содержать строку заголовка. Заголовки значений не должны содержать знаки препинания (кроме разделяющих запятых)к.
• Как минимум, файл CSV должен содержать Summary столбец.

Вы также можете иметь много строковые CSV. Например, это файл с одной записью:

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

Запятые не могут быть опущены. Например, это правильно:

Summary,Assignee, Reporter, Issue Type, Description, Priority
test, admin, admin, 1, ,

... это неправильно:

Summary, Assignee, Reporter, Issue Type, Description, Priority
test, admin, admin, 1

Проблема с кодировкой

Если при работе у Вас возникла необходимость импортировать в JIRA информацию из CSV-файла, который создан на русском языке, и если не удалось заставить JIRA правильно читать русскоязычные файлы, то писать файлы на английском или вариант с переводом в транслит не может быть решением проблемы.
Следует в настройках Tomcat (или другого сервера приложений) прописать следующее:java -Dfile.encoding=utf-8
После надо перезапустить сервер.

Импорт комментариев из CSV

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

2. Запуск конфигурации CSV Import Wizard

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

1. Войти как пользователь с "JIRA System Administrators".
2. Нажать ссылку "Администрирование" на верхней панели.
3. На панели слева, под названием "Импорт/Экспорт данных", нажмите кнопку "Импорт данных"
4. На странице "Импорт данных" выберите "Значения разделенные запятыми (CSV)".
5. На странице "Импорт запросов из CSV файла" нажмите ссылку "CSV Import Wizard".
6. На странице "CSV мастера импорта: Установка":

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

Нажмите на ссылку "Запустить мастер импорта".

Unable to render embedded object: File (clip.jpg) not found.

2.1 Конфигурации проекта

Первым шагом является выбор проекта в который файл будет импортирован. Вы можете импортировать в новый проект или существующий проект. Если некоторые детали проекта (например, name и key) соответствуют существующему проекту, то запросы будут импортированы в существующий проект. Заметим, что если вы создаете новый проект, проверка не проводится в это время - если данные неверны, то это отобразится позже во время импорта.

Если вы хотите импортировать данные в несколько проектов, необходимо сопоставить информацию о проекте из CSV файла. Это значит, что все строки должны иметь информацию о проекте в них.

Рекомендованный метод импорта - в существующий проект.

Unable to render embedded object: File (clip1.jpg) not found.

2.2 Отображение полей запроса

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

Unable to render embedded object: File (Clip_2.jpg) not found.

2.3 Разнообразная информация

Вам будет предложено ввести некоторую дополнительную информацию на этом экране:

1. Доменное имя пользователя, который будет создан в системе.
2. При импорте поля даты, вам также будет предложено поставить формат даты, который используется в файле CSV. Заметим, что этот формат может отличаться от формата даты, который используется в JIRA. Все поля даты будет интерпретироваться в Вашем формате.

Unable to render embedded object: File (Clip_5.jpg) not found.

2.4 Сохранение файла конфигурации

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

Вы также можете увидеть предварительное отображения файла, который будет сохранен:

Unable to render embedded object: File (Clip_3.jpg) not found.

3. Импорт файла CSV

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

Проблемы

• Этот модуль импортирует в JIRA не все объекты на данный момент. Вы можете ознакомиться с ограничениями JRA-5774.
• Существует проблема, которая мешает импортировать CSV в JIRA в случаях работы с JBoss 4.x. Это связано с проблемой совместимости между JBoss 4.x Commons-collections.jar и JIRA Commons-collections.jar. Чтобы устранить проблему, надо заменить Commons-collections.jar в JBoss 4.x на более новую версию JIRA. См. JRA-6473 для подробной информации.