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

Статья
2025-04-14

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

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

Необходимые условия

Permissions:

Export work items: Member of the Project Administrators group or View project-level information permission set to Allow.
Import work items: Member of the Project Administrators or Team Foundation Administrators security group.

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

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

Exclude the ID field: Don't include the ID field in your CSV file.
Удалить поля, специфичные для проекта: Если CSV-файл был экспортирован из другого проекта, удалите поля, специфичные для исходного проекта, например, путь области и теги. Список полей по умолчанию можно найти в разделе Индекс полей рабочего элемента.
Include the Test Steps field: When importing test cases, include the Test Steps field. Для получения дополнительной информации см. раздел Массовый импорт или экспорт тестовых случаев.
Don't include Assigned To, Changed Date, Created By, or State fields.
Проверить обязательные поля:
- Убедитесь, что в CSV-файле присутствуют поля типа рабочего элемента и заголовка .
- Confirm that the Work Item Type corresponds to a valid type in the target project.
- Убедитесь, что все поля в CSV-файле соответствуют полям для типов рабочих элементов в целевом проекте.
Обрабатывать недопустимые значения: Если импортированный CSV-файл содержит рабочие элементы с недопустимыми значениями, необходимо изменить и исправить эти рабочие элементы после импорта, прежде чем их можно будет сохранить.

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

Примечание.

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

Создайте локальный файл import.csv и откройте его в Visual Studio Code или Excel.
Файл должен содержать тип рабочего элемента и поля "Заголовок". При необходимости можно включить другие поля. Список полей по умолчанию см. в разделе "Индекс поля рабочего элемента".

В следующем примере содержится поле 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
```
На веб-портале проекта выберите Boards>Запросы>Импорт рабочих элементов.
Выберите "Выбрать файл", выберите файл и нажмите кнопку "Импорт".

Процесс импорта загружает импортированные рабочие элементы в представление запросов в несохраненном состоянии. No IDs get assigned.
Проверьте результаты и нажмите кнопку "Сохранить элементы ", чтобы сохранить рабочие элементы.

Tip

Не назначайте идентификаторы новым рабочим элементам, которые вы добавили. Assigning IDs results in an error message.
Система выделяет эти рабочие элементы с проблемами с данными. Устраните проблемы с данными перед сохранением рабочих элементов. В этом примере недопустимое значение находится в поле "Приоритет". Исправьте данные, открыв рабочий элемент напрямую. Вместо этого используйте массовое изменение для устранения нескольких рабочих элементов с одной и той же проблемой.

Советы

Parent-child links: You can add parent-child links between work items you import by indenting the title columns, as shown in Can I import a CSV file that have parent-child links?. Однако при импорте или обновлении рабочих элементов нельзя указать другие типы ссылок.
Поле состояния по умолчанию: при импорте новых рабочих элементов для поля "Состояние " задано значение New по умолчанию. Невозможно указать другое состояние во время импорта. Если необходимо изменить состояние импортированных рабочих элементов, используйте следующее решение:
1. Импортировать рабочие элементы с состоянием по умолчанию Новое.
2. Экспорт импортированных рабочих элементов в CSV-файл.
3. Обновите значения полей состояния в экспортируемом CSV-файле.
4. Повторно импортируйте обновленный CSV-файл, чтобы задать нужные состояния.
Поля области и итерации по умолчанию: Поля области и итерации по умолчанию относятся к узлу верхнего уровня. Это происходит, так как процесс импорта не имеет контекста для этих полей, если в CSV-файле явно не указано. To set specific Area and Iteration paths during import, ensure these fields are included in your CSV file with the correct values. Например:
```
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,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","",
```
Внесите изменения в рабочие элементы. CSV-файл должен содержать поля идентификатора, типа рабочего элемента и заголовка. Любые другие поля, которые необходимо включить, являются необязательными.

Примечание.

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

В следующем примере мы изменяем значения существующих рабочих элементов.
```
ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Jamal Hartnett <[email protected]>","Active",
"273","Issue","Merge testing modules","Jamal Hartnett <[email protected]>","Active",
"274","Issue","Open private preview for select customers","Raisa Pokrovskaya <[email protected]>","Active",
"275","Issue","Enable feature for customer champs","Raisa Pokrovskaya <[email protected]>","Active",
"276","Issue","Remove old test code","Christie Church <[email protected]>","Active",
```
Сохраните файл и импорт, как описано в предыдущем разделе.
Список результатов, в котором рабочие элементы содержат изменения значений, выделен полужирным шрифтом. Выберите " Сохранить элементы" , чтобы применить изменения.
Рабочие элементы с проблемами с данными выделяются красным цветом и должны быть устранены перед их сохранением. В этом примере в поле "Назначено" отображается недопустимое значение. Исправьте данные, открыв рабочий элемент напрямую. При наличии нескольких рабочих элементов с одной и той же проблемой можно использовать массовое редактирование.

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

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

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

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

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

Импорт полей 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>&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

Handle formatting inconsistencies

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

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

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

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

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

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

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

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

Вопрос. Можно ли импортировать новые элементы и обновить существующие элементы в одном CSV-файле?

А: Абсолютно! Оставьте поле идентификатора пустым для любых новых рабочих элементов. In the following example, the last entry for an Epic doesn't specify an ID.

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-файл с родительско-дочерними связями?

A: Yes, you can add child work items by indenting title columns. The following example adds three child issues under the already defined Epic.

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. If the user's in Microsoft Entra ID but not in the org, that user gets added to the valid identities.

При импорте из CSV с целью повышения производительности инструмент выбора идентификаторов не выполняет эти дополнительные действия. It only checks to see if there's a matching User Principal Name (UPN) already in the org. If it doesn't find a matching UPN, it reports that the identity is unknown.