Применимость: Cloud. Названия пунктов и доступность функций зависят от версии, плана и типа проекта. Проверяйте изменения на тестовом окружении. Описанные рабочие процедуры — предлагаемый подход, а не гарантии поставщика.
Сценарий и границы задачи
Поддержка переезжает из общей таблицы в Jira. В ней есть многословные описания, исполнители, нестандартные статусы и ссылки на документы. Задача — перенести факты, сохранив возможность доказать, что каждая исходная строка обработана ровно один раз и история не исчезла молча.
Оцените, какие данные действительно нужны в новом процессе, и не переносите чувствительные колонки автоматически. Исходная таблица может содержать комментарии, которые никогда не предназначались всем участникам проекта. Подготовка импорта включает согласование доступа и состава данных, а не только настройку технического соответствия полей.
Модель и договорённости
Добавьте стабильный внешний идентификатор строки, который не зависит от позиции в файле. Подготовьте справочники статусов, типов и пользователей. Отдельно решите, какие данные становятся полями, а какие — текстом описания. Нельзя считать фамилию уникальным идентификатором человека или автоматически превращать любой текст в новое значение справочника.
Внешний идентификатор должен оставаться одинаковым при исправлении строки и сортировке таблицы. Добавьте номер партии отдельно: он помогает операционному контролю, но не заменяет идентичность записи. Для спорных соответствий сохраняйте исходный текст, чтобы после переноса можно было восстановить смысл решения без поиска старого файла.
Порядок внедрения
Очистите кодировку и проверьте кавычки, переводы строк и формат дат. Соберите пилот из обычных и наиболее сложных записей. Сохраните настройки сопоставления вместе с номером партии. После импорта выгрузите созданные ключи и свяжите их с внешними идентификаторами. Следующую партию запускайте только после сверки предыдущей.
До импорта сохраните неизменяемую исходную выгрузку и создайте отдельный рабочий файл очищенных данных. В отчёте партии укажите диапазон внешних идентификаторов, настройки сопоставления и ожидаемое количество записей. Ошибочные строки складывайте отдельно с причиной отклонения. Так повторная загрузка не требует заново угадывать, какие данные уже успешно появились в Jira.
Проверки на реальных сценариях
Сравните число исходных строк, созданных задач и отклонённых записей. Дополнительно проверьте даты, исполнителя, многострочный текст и доступность вложений. Для большого файла выберите записи не только из начала, но и из середины и конца. Проверка нескольких успешных задач не подтверждает полноту переноса всех строк.
В тестовую партию добавьте запятую и перевод строки внутри описания, дату на границе месяца и отсутствующего исполнителя. Для вложений проверяйте содержимое, а не только наличие названия. Сверку ведите по внешнему идентификатору: одинаковые заголовки задач встречаются и не подходят для надёжного сопоставления.
Ошибки и диагностика
При частичном импорте повторная загрузка всего файла может создать дубли. Сначала разберите журнал и сопоставьте уже созданные задачи. Недоступные ссылки на документы не исправляют публикацией секретного токена в CSV. Для неизвестных пользователей и статусов заведите явный список исключений и согласуйте судьбу каждой записи.
При повторном импорте начинайте со списка исключений и уже созданных ключей. Сообщение об ошибке файла не означает, что весь пакет был отклонён без появления каких-либо задач.
Возврат и восстановление
Держите исходную таблицу неизменной, пока пользователи не приняли результат. Пилотные задачи маркируйте отдельной партией. Если требуется очистка, удаляйте только подтверждённые записи этой партии после сохранения их связей и созданных пользователями изменений. Откат импорта не должен затрагивать задачи, заведённые вручную в то же время.
Если пользователь начал работу в ошибочно созданной задаче, сначала сохраните новые комментарии и связи, затем решайте судьбу записи. Массовая очистка партии по времени создания опасна: в этот интервал могли попасть независимые задачи. Обратные действия выбирайте по подтверждённому списку ключей импорта, сверяя их внешний идентификатор и номер партии.
Приёмка и дальнейший контроль
В отчёте миграции покажите долю сопоставленных идентификаторов, число исключений и причины отклонения. Отдельно отметьте, какие вложения перенесены, а какие представлены ссылками. Приёмка заканчивается не сообщением интерфейса об успехе, а подписанной сверкой данных и понятным маршрутом исправления оставшихся проблем.
Отчёт должен разделять успешно созданные задачи, пропущенные строки и данные, намеренно оставленные вне миграции. Назначьте срок исправления исключений и владельца исходной таблицы. Пока этот список не закрыт, нельзя заявлять о полном переносе только на основании общего количества появившихся задач.
Механизм продукта и применимость
При CSV-импорте проверка предварительных строк не гарантирует отсутствие ошибок во всём файле. Atlassian описывает журнал ошибок для неудачного или частичного импорта и рекомендует не помещать токены в ссылки вложений.
CSV-импорт требует проверки возможностей текущего импортера и прав запуска. Описанные сверка и обработка исключений не зависят от красивого сообщения об успехе. Конкретное отображение полей, пользователей и вложений проверяйте по актуальной документации и тестовой партии именно для своего сайта Jira Cloud.
Официальная документация
Применить это к вашей системе
Обсудим контекст, ограничения и безопасный порядок изменений.
Обсудить задачу