Импорт и обновление массовых рабочих элементов с помощью CSV-файлов
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Импорт и экспорт рабочих элементов в массовом режиме с помощью CSV-файла в Azure DevOps. Кроме Excel, для группового импорта и обновлений можно использовать встроенную функцию импорта/экспорта. Дополнительные сведения см. в статье о массовом добавлении или изменении рабочих элементов в Excel.
Рабочие элементы можно экспортировать в массовом режиме с помощью CSV-файла. Пока вы продолжаете использовать Excel для массового импорта и обновления, вы можете использовать собственную функцию экспорта из запросов, для которых не требуется Excel. Дополнительные сведения см. в статье о массовом добавлении или изменении рабочих элементов в Excel.
Примечание.
Функция экспорта доступна в Azure DevOps Server 2019 с обновлением 1 и более поздними версиями. Функция импорта доступна в Azure DevOps Server 2020 и Azure DevOps Services.
Импорт новых рабочих элементов
Выполните следующие действия, чтобы импортировать новые рабочие элементы.
Примечание.
Вы можете импортировать до 1000 рабочих элементов за раз. Если у вас более 1000 рабочих элементов для импорта, разорвать их в несколько файлов и импортировать их отдельно.
Создайте локальный файл import.csv и откройте его в Visual Studio Code или Excel.
Файл должен содержать тип рабочего элемента и поля "Заголовок". При необходимости можно включить другие поля. Список полей по умолчанию см. в разделе "Индекс поля рабочего элемента".
В следующем примере мы включаем поле "Приоритет ".
Work Item Type,Title,Priority Issue,Fix issues with code,1 Issue,Merge testing modules,3 Issue,Open private preview for select customers,2 Issue,Enable feature for customer champs,2 Issue,Remove old test code,2На веб-портале проекта откройте запросы Boards>и выберите "Импорт рабочих элементов".
Выберите "Выбрать файл", выберите файл и нажмите кнопку "Импорт".
Процесс импорта загружает импортированные рабочие элементы в представление запросов в несохраняемом состоянии. Идентификаторы не назначаются.
Проверьте результаты и нажмите кнопку "Сохранить элементы ", чтобы сохранить рабочие элементы.
Совет
Избегайте назначения идентификаторов новым рабочим элементам, которые вы добавляете; это приводит к возникновению сообщения об ошибке.
Система выделяет эти рабочие элементы с проблемами с данными. Устраните проблемы с данными перед сохранением рабочих элементов. В этом примере недопустимое значение находится в поле "Приоритет". Исправьте данные, открыв рабочий элемент напрямую. Вместо этого используйте массовое изменение для устранения нескольких рабочих элементов с одной и той же проблемой.
Советы
- Ссылки "Родительский-дочерний": можно добавлять ссылки между рабочими элементами, импортируемыми путем отступа столбцов заголовка, как показано в csv-файле с родительскими дочерними ссылками?. Однако при импорте или обновлении рабочих элементов невозможно указать другие типы ссылок.
- Поле состояния по умолчанию: при импорте новых рабочих элементов поле "Состояние" всегда имеет значение "Создать" по умолчанию. Невозможно указать другое состояние во время импорта. Если необходимо изменить состояние импортированных рабочих элементов, можно использовать следующее решение:
- Импортируйте рабочие элементы с состоянием "Создать" по умолчанию.
- Экспорт импортированных рабочих элементов в CSV-файл.
- Обновите значения полей State в экспортируемом CSV-файле.
- Повторно присвойте обновленному CSV-файлу, чтобы задать нужные состояния.
- Поля области и итерации по умолчанию: поля "Область" и "Итерация" по умолчанию для узла верхнего уровня. Это происходит, так как процесс импорта не имеет контекста для этих полей, если в CSV-файле явно не указано. Чтобы задать определенные пути "Область" и "Итерация" во время импорта, убедитесь, что эти поля включены в CSV-файл с правильными значениями. Например:
Title,Description,Area Path,Iteration Path "Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"
Обновление существующих рабочих элементов
Чтобы обновить рабочие элементы, создайте запрос, содержащий все столбцы, которые необходимо экспортировать и, возможно, изменить. Сохраните запрос и выберите "Экспорт в CSV ", чтобы сохранить файл data.csv на локальном компьютере.
Экспортируемый файл должен выглядеть примерно так:
ID,Work Item Type,State,Assigned To,Title,Tags "1043","Issue","To Do",,"Fix issues with code", "1044","Issue","To Do",,"Merge testing modules", "1045","Issue","To Do",,"Open private preview for select customers", "1046","Issue","To Do",,"Enable feature for customer champs", "1047","Issue","To Do",,"Remove old test code",Внесите изменения в рабочие элементы. CSV-файл должен содержать поля идентификатора, типа рабочего элемента и заголовка. Любые другие поля, которые необходимо включить, являются необязательными.
Примечание.
При импорте полей удостоверений введите имя и электронную почту в следующем формате
"Display Name <email>". Например, чтобы назначить работу Jamal Hartnett, укажите"Jamal Hartnett <fabrikamfiber4@hotmail.com>". Если указать значение, которое не распознается как допустимый пользователь в системе, могут возникнуть проблемы с импортом.В следующем примере мы изменим несколько значений существующих рабочих элементов.
"1043","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Fix issues with code",architecture "1044","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Merge testing modules",testing "1045","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Open private preview for select customers","customer focus" "1046","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Enable feature for customer champs","customer focus" "1047","Issue","To Do","Christie Church <fabrikamfiber1@hotmail.com>","Remove old test code",architecture```Сохраните файл и импорт (см. шаги 4-6 из предыдущего раздела импорта.)
Список результатов с рабочими элементами, содержащими изменения значений, выделены полужирным шрифтом. Выберите " Сохранить элементы" , чтобы применить изменения.
Рабочие элементы с проблемами с данными выделяются красным цветом и должны быть устранены перед их сохранением. В этом примере в поле "Назначенный кому" отображается недопустимое значение. Исправьте данные, открыв рабочий элемент напрямую. При наличии нескольких рабочих элементов с одной и той же проблемой можно использовать массовое редактирование.
Экспорт списка в виде CSV-файла
Из любого запроса можно экспортировать список рабочих элементов в виде списка с разделителями-запятыми. Откройте запрос, выберите
значок действий, а затем выберите "Экспорт в CSV".
Примечание.
Требуется Azure DevOps Server 2019 с обновлением 1 или более поздней версии.
Экспорт и импорт рабочих элементов в другой проект
Эту функцию можно использовать для экспорта рабочих элементов из одного проекта и их импорта в другой проект. Однако перед импортом их в другой проект необходимо удалить идентификатор рабочего элемента. При попытке импорта новых рабочих элементов в проект с указанным идентификатором возникает ошибка.
Импорт полей HTML
Поля HTML, такие как описания и критерии принятия, включают форматирование форматированного текста. Чтобы обеспечить сохранение этого форматирования, выполните следующие задачи:
- Убедитесь, что CSV-файл содержит HTML-теги в соответствующих полях.
- Импорт CSV-файла в Excel.
Excel может обрабатывать многострочный текстовые поля по-разному, поэтому важно проверить форматирование после импорта. Замените строки, заканчивающиеся CRLF окружающими предложениями <p>... </p>.
Например, можно импортировать следующий рабочий элемент, включающий три строки текста в поле описания.
Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong> You can include bold text</strong></p><p><em> And italic text</em></p><p><u> Underline text</u></p>"
Преобразование многостроковых полей в открытый текст
Чтобы отключить HTML в многостроковых полях, чтобы убедиться, что они обычные witadmin changefield , можно использовать команду. Подробные инструкции см. в разделе "Управление полями рабочих элементов".
Пример команды:
witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText
Обработка несоответствий форматирования
При работе с полями HTML в разных продуктах Майкрософт могут возникнуть несоответствия форматирования. Ниже приведены некоторые советы по устранению этих проблем:
- Просмотрите форматирование после импорта, чтобы убедиться, что он соответствует вашим требованиям.
- Используйте соответствующие html-теги и структуры, чтобы свести к минимуму несоответствия. Можно добавить несколько тегов, разделенных точкой с запятой. Дополнительные сведения см. в разделе "Задачи" и "Не удается выполнить в Excel".
Дополнительные сведения об управлении содержимым HTML и обеспечении совместимости см . в официальной документации по HTML-содержимому в Azure DevOps.
Вопросы и ответы
Вопрос. Можно ли импортировать новые элементы и обновить существующие элементы в одном CSV-файле?
А: Абсолютно! Оставьте поле идентификатора пустым для любых новых рабочих элементов. В следующем примере последняя запись для Epic не указывает идентификатор.
ID,Work Item Type,Title,Assigned To,State,Priority,Tags
"16504","Issue","Fix issues with code",,"To Do","1",
"16505","Issue","Merge testing modules",,"To Do","3",
"16506","Issue","Open private preview for select customers",,"To Do","2",
"16507","Issue","Enable feature for customer champs",,"To Do","2",
"16508","Issue","Remove old test code",,"To Do","2",
,"Epic","Track Telemetry for data imports",,"To Do","2",
Вопрос. Можно ли импортировать CSV-файл с ссылками родительского-дочернего объекта?
Ответ. Да, можно добавить дочерние рабочие элементы, отступив столбцы заголовка. В следующем примере добавляются три дочерних проблемы в уже определенный Эпик.
ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telemetry for data imports",,,"To Do","2",
,"Issue",,"Fix issues with code",,"To Do","1",
,"Issue",,"Open private preview for select customers",,"To Do","2",
,"Issue",,"Enable feature for customer champs",,"To Do","2",
Вопрос: Разделы справки знать, имеет ли импортированный файл ошибки?
Ответ. Вы можете протестировать, добавив теги с пробелами и дефисами, например, и включив их в экспорт. Импорт должен совпадать с тем же форматом. Все проблемы с форматированием CSV-файла отображаются на странице результатов представления импорта. Не удается импортировать рабочие элементы, пока форматирование и синтаксис не будут правильными.
Результаты рабочего элемента всегда перечисляют ошибки данных, найденные для отдельных рабочих элементов. Исправьте каждую ошибку на веб-портале или в CSV-файле и снова импортируйте.
Вопрос. Почему я получаю ошибки для некоторых значений удостоверений?
Ответ. При использовании веб-интерфейса средство выбора удостоверений выполняет дополнительные действия для проверки пользователя. Сначала он проверяет, является ли пользователь допустимым пользователем в организации. Если нет, он ищет удостоверение в идентификаторе Microsoft Entra ID. Если пользователь находится в идентификаторе Microsoft Entra, но не в организации, этот пользователь добавляется в допустимые удостоверения. При импорте через CSV по соображениям производительности средство выбора удостоверений не выполняет эти дополнительные действия. Он проверяет только наличие соответствующего имени участника-участника-участника в организации. Если он не находит соответствующее имя участника-пользователя, он сообщает, что удостоверение неизвестно.
Вопрос. Поддерживает ли импорт CSV всех типов рабочих элементов?
Ответ. Нет, импорт CSV не поддерживает следующие типы рабочих элементов:
- Запрос на проверку кода
- Ответ на проверку кода
- Запрос отзыва
- Ответ на отзыв
- Тестовый случай
- План тестирования
- Набор тестов
- Общий параметр
Дополнительные сведения см. в разделе "Массовый импорт или экспорт тестовых случаев".