Поделиться через

Импорт, обновление и экспорт массовых рабочих элементов с CSV-файлами в Azure Boards

  • Статья

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Импорт и экспорт рабочих элементов в массовом режиме с помощью форматированных ФАЙЛОВ CSV в Azure Boards. Кроме Excel, для группового импорта и обновлений можно использовать встроенную функцию импорта/экспорта. Дополнительные сведения см. в статье о массовом добавлении или изменении рабочих элементов в Excel.

Рабочие элементы можно экспортировать в массовом режиме с помощью CSV-файла. Пока вы продолжаете использовать Excel для массового импорта и обновления, вы можете использовать собственную функцию экспорта из запросов, для которых не требуется Excel. Дополнительные сведения см. в статье о массовом добавлении или изменении рабочих элементов в Excel.

Импорт новых рабочих элементов

Для массового импорта рабочих элементов CSV-файл должен содержать поля "Тип рабочего элемента" и "Заголовок ". При необходимости можно включить другие поля. Импорт CSV-файла:

  • Не включайте поле идентификатора.
  • Если CSV-файл экспортирован из другого проекта, удалите поля, содержащие значение, относящееся к исходному проекту. Например, вы можете удалить путь к области, теги для списка полей по умолчанию, см . индекс поля рабочего элемента.
  • При импорте тестовых случаев необходимо включить поле "Шаги тестирования". Дополнительные сведения см. в разделе "Массовый импорт или экспорт тестовых случаев". Не включать поля "Назначенная", "Измененная дата", "Создано" или "Состояние".
  • Убедитесь, что поля типа рабочего элемента и заголовка включены в CSV-файл.
  • Убедитесь, что тип рабочего элемента является допустимым типом в целевом проекте.
  • Убедитесь, что поля в CSV-файле соответствуют полям fi=или тип рабочего элемента в целевом проекте.
  • При импорте CSV-файла, содержащего рабочие элементы с недопустимыми значениями, после импорта файла необходимо изменить рабочие элементы, чтобы исправить недопустимые значения, прежде чем сохранить рабочие элементы.

Выполните следующие действия, чтобы импортировать новые рабочие элементы.

Примечание.

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

  1. Создайте локальный файл import.csv и откройте его в Visual Studio Code или Excel.

  2. Файл должен содержать тип рабочего элемента и поля "Заголовок". При необходимости можно включить другие поля. Список полей по умолчанию см. в разделе "Индекс поля рабочего элемента".

    В следующем примере содержится поле Priority .

    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

  3. На веб-портале проекта откройте запросы Boards>и выберите "Импорт рабочих элементов".

    Снимок экрана: страница

  4. Выберите "Выбрать файл", выберите файл и нажмите кнопку "Импорт".

    Снимок экрана: диалоговое окно

    Процесс импорта загружает импортированные рабочие элементы в представление запросов в несохраняемом состоянии. Идентификаторы не назначаются.

  5. Проверьте результаты и нажмите кнопку "Сохранить элементы ", чтобы сохранить рабочие элементы.

    Снимок экрана: сохранение элементов для импортированных рабочих элементов.

    Совет

    Не назначайте идентификаторы новым рабочим элементам, которые вы добавили. Назначение идентификаторов приводит к возникновению сообщения об ошибке.

  6. Система выделяет эти рабочие элементы с проблемами с данными. Устраните проблемы с данными перед сохранением рабочих элементов. В этом примере недопустимое значение находится в поле "Приоритет". Исправьте данные, открыв рабочий элемент напрямую. Вместо этого используйте массовое изменение для устранения нескольких рабочих элементов с одной и той же проблемой.

    Снимок экрана: рабочие элементы с проблемами с данными, которые необходимо устранить.

Следующие советы могут быть полезны.

  • Ссылки "Родительский-дочерний": можно добавлять ссылки между рабочими элементами, импортируемыми путем отступа столбцов заголовка, как показано в csv-файле с родительскими дочерними ссылками?. Однако при импорте или обновлении рабочих элементов нельзя указать другие типы ссылок.

  • Поле состояния по умолчанию: при импорте новых рабочих элементов для поля "Состояние " задано значение New по умолчанию. Невозможно указать другое состояние во время импорта. Если необходимо изменить состояние импортированных рабочих элементов, используйте следующее решение:

    1. Импорт рабочих элементов с новым состоянием по умолчанию.
    2. Экспорт импортированных рабочих элементов в CSV-файл.
    3. Обновите значения полей состояния в экспортируемом CSV-файле.
    4. Повторно присвойте обновленному CSV-файлу, чтобы задать нужные состояния.

  • Поля области и итерации по умолчанию: поля области и итерации по умолчанию для узла верхнего уровня. Это происходит, так как процесс импорта не имеет контекста для этих полей, если в CSV-файле явно не указано. Чтобы задать определенные пути к области и итерации во время импорта, убедитесь, что эти поля включены в CSV-файл с правильными значениями. Например:

    Title,Description,Area Path,Iteration Path
"Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"

Обновление существующих рабочих элементов

  1. Чтобы обновить рабочие элементы, создайте запрос, содержащий все столбцы, которые необходимо экспортировать и, возможно, изменить. Сохраните запрос и выберите "Экспорт в CSV", чтобы сохранить файл data.csv на локальном компьютере.

    Снимок экрана: рабочие элементы в запросе с выбранным параметром

    Экспортируемый файл должен выглядеть примерно так:

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Active","",
"273","Issue","Merge testing modules","Active","",
"274","Issue","Open private preview for select customers","Active","",
"275","Issue","Enable feature for customer champs","Active","",
"276","Issue","Remove old test code","Active","",

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

    Примечание.

    При импорте полей удостоверений введите имя и электронную почту в следующем формате "Display Name <email>". Например, чтобы назначить работу Jamal Hartnett, укажите "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Если указать значение, которое не распознается как допустимый пользователь в системе, могут возникнуть проблемы с импортом.

    В следующем примере мы изменяем значения существующих рабочих элементов.

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"273","Issue","Merge testing modules","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"274","Issue","Open private preview for select customers","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"275","Issue","Enable feature for customer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",

  3. Сохраните файл и импорт, как описано в предыдущем разделе.

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

    Снимок экрана: импорт рабочих элементов с параметром

  5. Рабочие элементы с проблемами с данными выделяются красным цветом и должны быть устранены перед их сохранением. В этом примере в поле "Назначенный кому" отображается недопустимое значение. Исправьте данные, открыв рабочий элемент напрямую. При наличии нескольких рабочих элементов с одной и той же проблемой можно использовать массовое редактирование.

    Снимок экрана: недопустимое значение, отображаемое в поле

Экспорт списка в виде CSV-файла

Из любого запроса можно экспортировать список рабочих элементов в виде списка с разделителями-запятыми. Откройте запрос, выберите значок действий, а затем выберите "Экспорт в CSV".

Примечание.

Требуется Azure DevOps Server 2019 с обновлением 1 или более поздней версии.

Снимок экрана: экспорт запроса в формате CSV.

Экспорт и импорт рабочих элементов в другой проект

Эту функцию можно использовать для экспорта рабочих элементов из одного проекта и их импорта в другой проект. Однако перед импортом их в другой проект необходимо удалить идентификатор рабочего элемента. При попытке импорта новых рабочих элементов в проект с указанным идентификатором возникает ошибка.

Импорт полей HTML

Поля HTML, такие как описания и критерии принятия, включают форматирование форматированного текста. Чтобы обеспечить сохранение этого форматирования, выполните следующие задачи:

  1. Убедитесь, что CSV-файл содержит HTML-теги в соответствующих полях.
  2. Импорт CSV-файла в Excel.

Excel может обрабатывать многострочный текстовые поля по-разному, поэтому важно проверить форматирование после импорта. Замените строки, заканчивающиеся CRLF окружающими предложениями <p>... </p>.

Например, можно импортировать следующий рабочий элемент, включающий три строки текста в поле описания .

Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong>&nbsp;You can include bold text</strong></p><p><em>&nbsp;And italic text</em></p><p><u>&nbsp;Underline text</u></p>"

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

Чтобы отключить HTML в многостроковых полях, чтобы убедиться, что они обычные witadmin changefield , можно использовать команду. Дополнительные сведения см. в разделе "Управление полями рабочих элементов".

Пример команды:

witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText

Обработка несоответствий форматирования

При работе с полями HTML в разных продуктах Майкрософт могут возникнуть несоответствия форматирования. Ниже приведены некоторые советы по устранению этих проблем:

  • Просмотрите форматирование после импорта, чтобы убедиться, что он соответствует вашим требованиям.
  • Используйте соответствующие html-теги и структуры, чтобы свести к минимуму несоответствия. Можно добавить несколько тегов, разделенных точкой с запятой. Дополнительные сведения см. в разделе "Задачи" и "Не удается выполнить в Excel".

Дополнительные сведения об управлении содержимым HTML и обеспечении совместимости см. в статье "Предоставление текста справки, гиперссылок или веб-содержимого в форме рабочего элемента".

Вопросы и ответы

Вопрос. Можно ли импортировать новые элементы и обновить существующие элементы в одном 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",

Ответ. Да, можно добавить дочерние рабочие элементы, отступив столбцы заголовка. В следующем примере добавляются три дочерних проблемы в уже определенный Эпик.

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",

Снимок экрана: представление Excel.

Вопрос: Разделы справки знать, имеет ли импортированный файл ошибки?

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

Снимок экрана: ошибка CSV на странице импорта рабочих элементов.

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

Вопрос. Почему я получаю ошибки для некоторых значений удостоверений?

Ответ. При использовании веб-интерфейса средство выбора удостоверений выполняет дополнительные действия для проверки пользователя. Сначала он проверяет, является ли пользователь допустимым пользователем в организации. Если нет, он ищет удостоверение в идентификаторе Microsoft Entra ID. Если пользователь находится в идентификаторе Microsoft Entra, но не в организации, этот пользователь добавляется в допустимые удостоверения.

При импорте из CSV по соображениям производительности средство выбора удостоверений не выполняет эти дополнительные действия. Он проверяет только наличие соответствующего имени участника-пользователя (UPN) в организации. Если он не находит соответствующее имя участника-пользователя, он сообщает, что удостоверение неизвестно.

Вопрос. Поддерживает ли импорт CSV всех типов рабочих элементов?

Ответ. Нет, импорт CSV не поддерживает следующие типы рабочих элементов:

  • Запрос на проверку кода
  • Ответ на проверку кода
  • Запрос отзыва
  • Ответ на отзыв
  • Тестовый случай
  • План тестирования
  • Набор тестов
  • Общий параметр

Дополнительные сведения см. в разделе "Массовый импорт или экспорт тестовых случаев".