获取 Azure DevOps Office 集成插件的唯一方法是安装最新版本的 Visual Studio 或 Azure DevOps Office 集成安装程序之一。 插件支持从 Excel 连接到Azure Boards和Azure DevOps Server。

获取插件的唯一方法是安装 Visual Studio 的最新版本之一或 Azure DevOps 独立 Office 集成安装程序。 Azure DevOps Office Integration 2019 插件支持从 Excel、Project 和基于 PowerPoint 的情节提要工具连接到 Azure Boards 和 Azure DevOps。

• 无 ：指示它是 输入列表 。
• 查询标题 ：指示工作项列表与指定的 查询 相关联。
• 列表类型 ：
  • 平面列表 ：显示单个 Title 列的工作项的简单列表。 不支持链接管理。
  • 树列表 ：支持在工作项之间创建和更新树拓扑链接（如Parent-Child链接）的工作项的分层列表。 这些列表包括两个或多个 标题 列。

  可以使用任何查询类型和列表类型添加、修改、发布和刷新工作项。

  Azure Boards支持三种查询类型。 每个查询旁边的图标指示查询类型。 前两种查询类型（ 工作项的平面列表 和 工作项和直接链接 ）作为平面列表查询导入。

  只有 工作项的树 查询导入为树列表。 直接链接查询将作为简单列表导入到 Excel 中，因为修改多种类型的链接不是 Excel 中受支持的功能。

  可以批量添加工作项的嵌套列表，例如工作细分结构或分层的用户情景和客户体验集。 例如，可以添加任务、子任务和 bug 的嵌套列表，如下图所示，或将任务链接到产品积压工作项。

  下面是项的三级嵌套树在 Excel 中的显示方式。

  父子链接或其他树拓扑链接类型支持创建分层积压工作结构。 参与层次结构的工作项类型因进程而异，如下图所示。

  Scrum 流程 CMMI 流程

  若要导入分层列表，请参阅本文后面的 添加或导入工作项的分层列表 。

  我的查询与共享查询

  可以在 Excel 中打开在 Azure Boards 中定义的任何查询。 这包括“我的查询”和“共享查询”下定义的查询。 但是，如果计划与其他团队成员共享工作簿，则只应使用共享查询。 如果工作簿或工作表基于存储在“我的查询”文件夹下的个人查询，则其他团队成员无法使用该工作簿或工作表。

  使用列表和查询类型

  通常， 使用简单列表 可以一次性批量添加或修改多种类型的工作项，例如积压工作项、任务、bug 或问题。 使用树列表 批量添加或修改工作项及其树拓扑链接。

  下面是一些更多指南：

  • 使用 输入列表、平面列表 ：若要导入工作项列表或创建新工作项，无层次结构
  • 使用 输入列表、树列表 ：完成自上而下规划和导入分层链接的工作项
  • 使用 查询列表、树列表 ：查看和修改许多现有工作项的链接关系的层次结构。
  • 使用 查询列表、平面列表 ：若要批量更新工作项列表或创建新工作项，无层次结构
  • 使用输入列表、平面列表：若要导入工作项列表或创建新工作项，无层次结构
  • 使用输入列表、树列表：完成自上而下规划和发布父子链接工作项
  • 使用查询列表、平面列表：基于工作项的查询创建 Excel 报表

    若要创建 Excel 报表，必须将项目集合配置为支持分析报告。 有关详细信息，请参阅 从工作项查询创建 Excel 报表 。

  • 使用查询列表、树列表：查看和修改许多现有工作项的层次结构和父子链接关系。

  使用 Excel 功能

  处理工作项列表时，可以使用大多数 Excel 功能。 例如，可以使用以下功能：

  • 设置单元格格式或对单元格或列应用条件格式
  • 从一个单元格剪切并粘贴到其他单元格
  • 剪切并粘贴单行
  • 对列求和或添加其他公式
  • 向下填充单元格
  • 向工作簿添加多个工作表

  Excel 中的每个工作表可以包含不同的输入列表或查询。 但是，工作簿中的所有工作表都必须连接到组织或项目集合中的同一项目。

  使用连接到 Azure Boards 的工作表时，以下功能的工作方式略有不同。

  • 每个单元格或单元格列对应于一个工作项字段。 每个字段都与数据类型相关联。 Excel 不允许将数据输入到不满足该字段数据类型和要求的单元格中。
  • 在工作表中一次只能插入一行。
  • 可以在工作表中复制和粘贴多行。
  • 若要在层次结构中移动工作项，请剪切整行并将其粘贴到要作为父级的工作项下。
  • 使用 “缩进 ”和 “缩进 ”更改工作项在树中的位置。
  • 撤消 (Ctrl Z) 可能无法正常工作。 如果执行了要还原的内容，可以刷新工作表。

  建议经常发布和刷新工作表，以确保本地工作与Azure Boards数据存储保持同步。

  若要了解有关 Excel 的详细信息，请参阅 基本 Excel 任务 。

  对工作项进行排序

  可以使用 Excel 排序功能对工作项平面列表 进行排序 。

  但是，如果你正在从树列表工作，则不想执行任何类型的排序。 这样做会更改树结构，因此会更改工作项之间的链接。

  如果要使用 Excel 管理工作项在 团队积压工作 中出现的顺序，可以使用 “堆栈排名 ”或 “积压工作优先级 ”字段 (敏捷或 Scrum 流程) 。 可以在这些字段中设置值、发布工作表和刷新积压工作。 积压工作项应根据从低到高的数字重新排序。 但是，下次从积压工作重新排序时，输入的值可能会更改。

  如果要维护工作项的特定顺序，请考虑添加自定义字段来管理排序顺序，然后在 Excel 中使用该字段对工作项的简单列表进行排序。 但是，此选项不会更改积压工作中显示的顺序。

  可以使用 Excel 执行和不能执行的任务

  可以执行以下任务：

  • 添加标记并使用标记批量更新工作项，如 添加工作项标记以对列表和版块进行分类和筛选 中所述。 将 “标记” 字段添加到工作表。 添加多个用分号 (;) 分隔的标记。
  • 可以将简单文本添加到富文本字段，但如果要批量更新多个工作项，可能会丢失现有工作项的格式。
  • 可以脱机工作，然后重新连接并发布更改。 有关详细信息，请参阅 将Azure Boards连接到 Office 客户端、脱机工作和重新连接 。

  不能从 Excel 工作表中执行以下任务：

  • 无法删除工作项
  • 无法更改现有工作项的工作项类型
  • 不能将工作项移到另一个项目
  • 无法导入或更新测试用例步骤或其他测试项目
  • 不能在除新状态以外的任何其他州中添加工作项
  • 无法添加到工作项讨论线程
  • 无法链接到远程工作项。

  连接到云中的Azure Boards时，将自动选择 团队项目集合 ，因为只有一个集合与Azure DevOps Services组织相关联。 连接到本地服务器中的Azure Boards时，先选择 团队项目集合 ，然后再选择项目。

  • 在 Excel 中，首先创建一个空白工作表。 如果使用 Excel 2007) ，则看不到“ 团队 ”功能区 (或“ 团队 ”菜单，请参阅 Azure DevOps Office 集成问题 。

  • 从“团队”功能区中选择“ 新建列表 ”。

    如果要添加要在团队积压工作中显示的工作项，请确保添加并指定团队的区域路径和迭代路径。 如果需要添加区域路径或迭代路径，请选择 “编辑区域和迭代” 链接。 该链接将打开 Web 浏览器，转到“项目设置”页。 若要了解详细信息，请参阅 定义区域路径并分配给团队 和 定义迭代路径和配置团队迭代 。

  • 若要打开工作项以添加详细信息，请选择要打开的工作项，然后选择“ 在 Web 访问中打开 ”。 在执行此操作之前，请确保发布所做的任何更改。

    Web 浏览器将打开并显示工作项。

    如果对工作项进行更改，则应立即刷新工作表以捕获更改。

    将工作项导入为树列表

    可以使用父子链接或其他树拓扑链接类型添加链接的工作项层次结构。

    请不要对树列表进行排序。 对树列表进行排序可能更改分层链接关系。

  • 从上 一过程的步骤 5 开始，将平面列表、输入列表转换为树列表。 选择平面列表中的单元格，然后选择 “添加树级别 ”。

    如果“ 添加树级别 ”处于禁用状态，则表示你正在从查询列表中操作。 若要将列表转换为树列表，必须先 将列表重新配置为 输入列表。

  • 选择向层次结构添加工作项时要使用的链接类型，然后选择“ 转换 ”。 最常见的选择是 父子。 只能从树拓扑链接类型中进行选择。 若要了解详细信息，请参阅 链接类型拓扑和限制 。

    请注意，“列表”类型已更改为 “树 ”，并显示第二个 “标题” 列。

  • 若要向层次结构添加更多级别，请再次选择 “添加树级别 ”。 例如，如果要添加 Epics、Features 和 User Stories 的层次结构，则需要具有 标题 1 、 标题 2 和 标题 3 列。

    如果要添加任务，请添加另一个树级别以包含四个标题列。 若要删除列，请参阅 删除树级别 。

  • 保存 Excel 文件。

  • 输入要导入的层次结构 的工作项类型和 标题 。 选择工作项类型后， “状态 ”字段会自动填充默认值。

    请确保光标停留在包含数据的单元格中。 否则， “发布 ”按钮可能显示为“已禁用”。

    ID 现在已分配给工作项。 在后台，所选的链接类型用于链接层次结构中的每个工作项。 长篇故事链接到功能，功能链接到用户情景。

  • 若要检查创建的链接，请选择一个工作项，然后选择 “链接和附件 ”。

    例如，此处显示了为导入的功能创建的子链接和父链接。

  • 若要向其他字段赋值，请打开 “选择列” ，添加字段，进行分配，然后发布更改。

  • 若要更改层次结构，请剪切并粘贴工作项的行，以将其放置在新父项下。 请确保选择整个表行。 发布更改时，会删除旧的分层链接，并创建新的分层链接。

    可以使用 或树缩进/缩 来降级或提升树层次结构中的工作项。 验证父工作项标题左侧或右侧的列是否为 Title 列。 列顶部的标题应为 标题 n ，否则添加树级别。

    删除树级别

  • 首先，先发布对工作项所做的更改，然后再删除树级别。 移除树级别需要刷新，这会覆盖工作项列表中的数据。 你将丢失尚未发布的任何数据。

  • 接下来，删除要删除的树级 标题 编号 列（编号最高的列）下的任何内容。 此列应是树中编号最高的列。

  • 刷新 工作表。 将删除包含 Title 的空值的列。

    如果尝试删除列，将收到错误消息。

    使用树列表时的有用提示

  • Excel 解释 “标题 ”列中的数据，以确定工作项之间的链接模式。 发布更改时，以下任何情况都会导致错误、无效链接或在不正确的工作项之间创建树链接：
    • 工作项之间的一行在层次结构中为空
    • 工作项的标题位于错误的列中。 请确保为每个子工作项输入标题。
    • 在一行中，多个 Title 列包含数据。 请仅在每行中的一个标题列中输入文本。
    • 列表已排序。 请不要对树列表进行排序。 对树列表进行排序可能更改分层链接关系。 如果你确实对树列表进行了排序，则可通过立即刷新来从此操作恢复。
    • 若要解决错误，请参阅 解决无效链接 。
    • 父子链接的工作项只能有一个父级。 你无法将同一工作项任务添加到两个积压工作 (backlog) 项。 相反，你需要定义不同的工作项任务。

    使用查询列表批量更新工作项

    批量更新许多工作项的最简单方法是使用要更新的工作项创建查询，然后在 Excel 中打开该查询。

    请遵循以下提示，使你的工作保持同步：

    • 首次打开已保存的工作表时，请使用 ( 刷新 ) 从数据存储下载最新数据。
    • 使用 向工作表添加列，输入其他 字段的数据。
    • 为了避免数据冲突，请经常发布你的添加项和修改项。
    • 为了防止数据丢失，请在发布或刷新之前，定期保存你的工作簿。

    • 在 Web 门户或 Visual Studio 中，创建包含要更新的工作项的工作项查询。 有关详细信息，请参阅 使用查询编辑器创建和保存托管查询 。

    • 打开 Excel 并连接到Azure Boards项目。 使用 将 Azure DevOps 项目连接到 Excel 中提供的四种方法之一。

    • 如果从 Web 门户或 Visual Studio 打开了查询，则已完成。 进行任何所需的更改。 打开 “选择列” ，添加字段，进行分配，并发布更改。

    • 如果从 Excel 开始，请打开一个空白工作表。 只要从工作簿绑定到的同一项目中选择查询，就可以将工作表添加到现有工作簿。

    • 从“团队”功能区中选择“ 新建列表 ”。

      启用树命令

      如果 树组 命令不可用，则工作表将配置为平面列表、查询列表。 将列表转换为输入列表或基于树查询的列表，以启用树组命令。 若要了解如何操作，请参阅 更改列表类型或查询 的下一部分。

      更改列表类型或查询

      可以更改工作表中列出的工作项。 具体而言，您可以：

    • 将平面列表更改为树列表
    • 从查询列表更改为输入列表
    • 从输入列表更改为查询列表
    • 更改工作表引用的查询

    如果要将单一列表更改为树列表，可以。 但是，如果列表是查询列表，则首先需要重新配置该列表。 你会知道它是一个平面列表，查询列表，因为 树组 命令被禁用。

    若要将查询列表转换为输入列表，请执行以下步骤。

    • 首先，发布所做的任何更改。

    • 接下来，在 “团队 ”功能区上，选择 “配置 ”、“ 列表 ”。

    • 查询 。 定义包含所需工作项集或超集的查询时，请使用此方法。
    • ID 。 如果知道要链接到的工作项的 ID，请使用此方法。 在“ ID ”框中，键入要查找的工作项的 ID，用逗号或空格分隔。
    • 标题包含 。 使用此方法可查找标题字段中具有通用字词或短语的工作项。 在 和类型 列表中，选择要检索的工作项的类型。

    若要最大程度地减少运行查询所需的时间，请缩小搜索的筛选条件。

    • 选择 “查找” 。

      仅列出为所选项目定义的工作项和指定的工作项类型。 若要对列字段进行排序，请选择列“ 标题 ”。

    • 在返回的工作项列表中，选择一个或多个工作项的检查框。

    • 选择应链接到当前工作项的每个工作项。 还可以在单击时按 SHIFT 键以选择一系列工作项，或在单击时按 Ctrl 键以选择多个工作项。
    • 选择 “全选” 以选择列表中的所有工作项。

    添加或删除列字段

    如果以 “新建列表” 开头的工作表，则只会看到一组默认字段列。 可以使用“团队”功能区上的 “选择列”添加列 。

    如果从现有查询启动工作表，将看到为查询定义的所有列字段。 在此处，可以使用 “选择列”添加列 。 但是，添加内容不会修改基础查询。

    • 若要为其他字段赋值，请选择 “列选项” 以添加感兴趣的字段。

    • 若要移动或删除字段，请选择该字段， > 然后选择 或 < 图标。
    • 若要更改字段顺序，请使用向上和向下箭头在列表中向上或向下移动字段。
    • 可以添加富文本字段（如 “说明 ”字段），但在发布时可能会丢失部分格式。

    • 字段显示在工作表中后，赋值并发布更新。 使用标识字段（接受用户帐户的标识字段）时，请参阅下一部分 选择用户帐户 。

    • 保存工作表。

      选择用户帐户

      可以使用“选择用户”功能查找用户帐户并将值分配给命名字段的人员。 此外，此功能还提供对最近使用的 (MRU) 值的访问权限。 如果团队包含数百个或数千个用户帐户，则需要使用此功能。

      如果没有 “选择用户” 功能，则必须完全按照数据库中的用户名输入用户名，否则在尝试发布时将收到数据验证错误。

    • 如果尚未安装或更新到最新版本的 Visual Studio (至少 VS 2015.1 或更高版本 ，请立即执行此操作。 需要最新更新才能访问“选择用户”功能。

    • 选择一个标识或以人命名的字段以激活“团队”功能区中的 “选择用户” 功能。

      标识或以人命名的字段是包含用户标识的字段。 这些字段通常同步到用户帐户数据库，例如 Azure Active Directory、Active Directory 或工作组。

    • 开始键入用户帐户的名称，“分配用户”对话框将自动筛选结果，直到可以选择感兴趣的帐户。

      在以该字母开头的名称开头输入一个要制表符的字母。 仅输入用户名，因为无法识别帐户别名。

      你会注意到，当你选择用户名时，Excel 会记住你最近的选择，你可以直接从字段中选择用户帐户。

      有关链接工作项的详细信息，请参阅 链接用户情景、问题、bug 和其他工作项 。

      查看和添加链接

      不能使用“链接和附件”对话框批量更新工作项链接。 只能使用树列表批量更新树拓扑链接类型。

    • 若要将工作项链接到其他工作项，请选择该工作项，然后选择 “链接和附件 ”。 在“链接”选项卡中，选择“ 链接到 ”，然后选择“ 链接类型和 工作项” (要链接到) 。 选择 “确定” ，然后选择 “发布 ”。

      完成后，选择 “关闭” 以关闭对话框。

    • 若要将多个工作项链接到同一个工作项 () ，请对连续行使用 Ctrl 单击 或对非连续行使用 Shift 单击 进行多选。

      查找要链接到的工作项

      在“添加链接”对话框中，可以打开辅助对话框以选择要链接到的一个或多个工作项。 如果要使用保存的查询查找并列出要链接到的工作项，请先 定义要使用的查询 。

      在“添加链接”对话框中， (Visual Studio) 选择“ 浏览 ”按钮，打开以下对话框。

      “ 选择链接的工作项 ”对话框的工作方式与 “获取工作项 ”对话框相同。 若要了解详细信息，请参阅将 现有工作项添加到 本文前面所述的工作表。

      向链接列表添加列

    • 在“ 链接 ”选项卡中，选择“ 列” 图标，然后添加要显示的字段。 此处添加“分配到”和“状态”字段。

    • 若要更改链接到的工作项，请输入工作项的 ID，或选择 “浏览 ”以查找 () 链接到的工作项。

      “ 选择链接的工作项 ”对话框的工作方式与 “获取工作项 ”对话框相同。 若要了解详细信息，请参阅将 现有工作项添加到 本文前面所述的工作表。

    • 若要添加附件，请选择工作项，然后选择 “链接和附件” ，然后选择“ 附件 ”选项卡。

      选择要附加的文件，然后选择 “确定” ，然后选择 “发布 ”。

      完成后，选择 “关闭” 以关闭对话框。

    • 若要将同一附件 () 添加到多个工作项，请对连续行使用 Ctrl 单击 进行多选，或者对非连续行使用 Shift 单击 。

      可以从 Web 门户为平面列表查询创建报表或图表。 请参阅 通过创建基于状态和趋势查询的图表来跟踪进度 。

      只能使用本地Azure DevOps Server 中的“新建报表 ”创建 Excel 报表。 这些报表要求将项目的项目集合配置为支持 SQL Server Analytics Server。

      可以使用基于工作项的简单列表使用 “新建报表” 功能创建报表。

      若要了解详细信息，请参阅 从工作项查询创建 Excel 报表 。

      解决发布错误

      若要解决在 Excel 中工作时出现的发布错误，请参阅以下文章之一：

    • 解决数据冲突 ：自上次从 Excel 发布以来，当Azure Boards中的字段值发生更改时，会发生数据冲突。

    • 解决数据验证错误 ：如果字段值违反该字段和工作项类型的规则，则会发生数据验证错误。

    • 解决树层次结构中的无效链接 ：如果工作组成员将 Excel 中的工作项视为层次结构或树列表，然后移动工作项或对列表进行排序，使其中断工作项之间的依赖关系，则会发生无效链接。 通过查看错误消息和重新定位工作项来反映工作项结构，可解决此错误。

    • 地址错误 TF208104：分层链接关系已锁定 ：
      如果收到错误 TF208104，则会发布对字段所做的更改。 但不会发布对链接层次结构的更改。 至少有一个为工作项定义的链接关系被另一个进程锁定，例如 Project Server 集成。

    • (Web 门户) 批量修改工作项
    • Azure DevOps Office 集成问题
    • 常见问题解答：在连接到 Azure Boards 的 Excel 中工作
    • 使用 CSV 文件批量导入或更新工作项
    • 查看和添加工作项
    • 基本 Excel 任务