使用 Azure Boards 中的 CSV 文件批量导入或更新工作项

  • 项目

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019

可以使用 CSV 格式化文件批量导入和导出工作项。 虽然可以继续使用Excel进行批量导入和更新，但可以使用不需要Excel的本机导入/导出功能。 若要了解有关使用Excel的详细信息，请参阅使用Excel批量添加或修改工作项。

可以使用 CSV 格式化的文件批量导出工作项。 虽然继续使用Excel进行批量导入和更新，但可以使用不需要Excel的查询中的本机导出功能。 若要了解有关使用Excel的详细信息，请参阅使用Excel批量添加或修改工作项。

注意

导出功能适用于 Azure DevOps Server 2019 Update 1 及更高版本。 导入功能可用于 2020 Azure DevOps Server 和 Azure DevOps Services。

导入新工作项

导入的所有工作项都处于新状态。 此规则表示不能指定不符合新状态字段规则的字段值。 例如，使用敏捷流程创建新用户情景时，State=New 和 Reason=New。 无法指定其他值。

  1. 创建本地import.csv文件，并在Visual Studio Code或Excel中将其打开。

  2. 该文件必须包含 “工作项类型 ”和“ 标题” 字段。 可以根据需要包含其他字段。 有关默认字段的列表，请参阅 “工作项”字段索引。

    在以下示例中，我们包括 “优先级 ”字段。

    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. 在项目的 Web 门户中，打开Boards>查询并选择“导入工作项”选项。

    Boards>Queries, Import Work Items

  4. 选择 CSV 文件，然后选择 “导入”。

    Import Work Items Button Image

  5. 导入过程将导入的工作项加载到处于 未保存 状态的查询视图中。 未分配 ID。 验证结果是否是所需结果。 然后，选择“ 保存项目 ”以保存工作项。

    Save imported work items

    注意

    请确保未将 ID 分配给要添加的新工作项。 如果这样做，将收到类似于以下内容的错误消息。

    Error message of work item ID.

  6. 系统突出显示了具有数据问题的这些工作项。 在保存工作项之前解决数据问题。 在此示例中，已将无效值输入到“优先级”字段中。 通过直接打开工作项来修复数据。 请改用 批量编辑 来修复具有相同问题的多个工作项。

    Fix work items with data issues.

提示

可以通过缩进标题列来在导入的工作项之间添加父子链接，如本文后面的示例所示，是否可以导入具有父子链接的 CSV 文件？ 但是，导入或更新工作项时，不能指定任何其他链接类型。

更新现有工作项

  1. 若要更新工作项，请创建包含要导出和可能编辑的所有列的查询。 保存查询，然后选择 “导出到 CSV ”，将data.csv文件保存到本地计算机。

    Export work items, 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",

  2. 对工作项进行编辑。 CSV 文件必须包含 ID、 工作项类型、 标题和 状态 字段。 要包含的任何其他字段都是可选的。

    注意

    导入标识字段时，必须采用以下格式 "Display Name <email>"输入名称和电子邮件。 例如，若要将工作分配给 Jamal Hartnett，请指定 "Jamal Hartnett <fabrikamfiber4@hotmail.com>"。 如果指定了未识别为系统的有效用户的值，则可能会遇到导入问题。

    在以下示例中，我们对现有工作项更改多个值。

     ID,Work Item Type,State,Assigned To,Title,Tags
 "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

  3. 保存文件并导入 (请参阅上一导入节中的步骤 4-6。)

  4. 包含值更改的工作项的结果列表以粗体突出显示。 选择 “保存项目 ”以应用更改。

    Import Work Items Save Items.

  5. 数据问题的工作项以红色突出显示，需要先解决，然后才能保存它们。 在此示例中，“分配给”字段中显示无效值。 通过直接打开工作项来修复数据。 相反，如果你有许多具有相同问题的工作项，则可以使用批量编辑。

    Invalid value appears in the Assigned To field.

将列表导出为 CSV 文件

从任何查询中，可以将工作项列表导出为逗号分隔的列表。 打开查询，选择 操作图标，然后选择 “导出到 CSV”。

注意

需要 Azure DevOps Server 2019 Update 1 或更高版本。

Export a query as CSV

将工作项导出和导入到其他项目

可以使用此功能从一个项目导出工作项并将其导入到另一个项目。 但是，在将它们导入到另一个项目之前，必须删除工作项 ID。 如果尝试将新工作项导入到具有指定 ID 的项目，则会出现错误。

导入或更新格式文本字段

可以更新或导入格式文本字段，例如 “说明 ”或“ 接受条件 ”字段。 格式文本字段是 HTML 格式的字段。 用周围句子替换以 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>"

问题解答

是否可以导入新项并更新同一 CSV 文件中的现有项？

当然！ 为任何新工作项保留 ID 字段为空。 在以下示例中，Epic 的最后一个条目未指定 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 Telementry for data imports",,"To Do","2",

是的，可以通过缩进标题列来添加子工作项。 以下示例在已定义的 Epic 下添加了三个子问题。

ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telementry 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中更好的视觉对象。

Excel view image

如何实现知道导入的文件是否出错？

CSV 文件格式的任何问题都显示在导入视图的“结果”页中。 在格式和语法正确之前，无法导入工作项。

CSV Error image

工作项的结果始终列出针对单个工作项发现的数据错误。 从 Web 门户或 CSV 文件中修复每个错误，然后再次导入。