通过

Azure DevOps 集成

  • 项目

Azure DevOps 集成简介

Viva Goals与 Microsoft Azure DevOps 集成，以自动更新Viva Goals中的关键结果和项目。 关键结果和项目进度根据连接的 Azure DevOps 工作项自动更新。 可以使用 Azure DevOps 集成来

  • 自动跟踪关键结果的进度
  • 自动跟踪计划 KPI 的进度
  • 自动跟踪计划的进度和任务。
    • 此方法更新计划进度，将 Azure DevOps 工作项详细信息与Viva Goals计划“任务”同步，并且与 Viva Goals Azure DevOps 扩展一起使用时，Viva Goals OKR 对齐详细信息将直接显示在 Azure DevOps 链接的工作项中。

有关连接到关键结果、计划指标和计划任务时 Azure DevOps 集成如何工作的更多详细信息，请参阅下文。

(OKR) 与输出 (计划的结果)

OKR 的基本原则之一是区分结果与输出。 OKR 和关键结果侧重于推动影响 (即结果) ，而Viva Goals计划侧重于输出 - 计划实现关键结果的工作。 两者都是要跟踪的重要指标，但它们的度量值不同。

虽然可以将Viva Goals关键结果和计划与 Azure DevOps 工作项集成，但了解差异非常重要。 Azure DevOps 主要侧重于跟踪工作，因此将Viva Goals计划与 Azure DevOps 集成更为常见。 有一些示例可以基于 Azure DevOps 工作项跟踪关键结果进度。

何时使用 Azure DevOps 集成

可通过三种方法将 Azure DevOps 与Viva Goals工作流集成。 下面介绍了其中每个功能的详细信息：

  1. 使用任务跟踪计划的进度： 除了基于 Azure DevOps 工作项跟踪计划进度外，此方法还支持跨平台用户体验。 Azure DevOps 工作项详细信息已同步到Viva Goals计划视图，Azure DevOps 工作与Viva Goals OKR 的一致性可以直接通过 Azure DevOps 扩展 (即将推出)
  2. 使用 KPI 跟踪计划的进度： 此方法使你能够基于 Azure DevOps 工作项状态跟踪计划进度。 单个数值与Viva Goals同步。
  3. 跟踪关键结果的进度： 使用此方法可以根据 Azure DevOps 工作项状态跟踪 KR 进度。 单个数值与Viva Goals同步。

如何设置 Azure DevOps 集成

Azure DevOps 集成需要由Viva Goals租户和组织管理员启用。Viva Goals管理员必须先为其租户启用 Azure DevOps 集成， (在 Viva Goals 中启用集成 |Microsoft Learn) 。 在租户级别启用后，Viva Goals组织管理员必须为其组织启用它 (Viva Goals集成管理概述。)

注意

启用后，组织中有权创建/编辑 OKR 和/或计划的任何用户都可以在 Viva Goals 与 Azure DevOps 之间设置集成！

如何启用 Azure DevOps 与计划集成

此方法是将 Azure DevOps 中的工作与 OKRsin Viva Goals 保持一致的建议方法。 除了基于 Azure DevOps 工作项跟踪计划进度外，此方法还支持跨平台用户体验。 Azure DevOps 工作项详细信息会同步到Viva Goals计划视图，当与 Viva Goals Azure DevOps 扩展一起使用时，Azure DevOps 工作与Viva Goals OKR 的一致性将直接显示在链接的 Azure DevOps 工作项中。

  1. 在Viva Goals中选择“添加计划”或编辑现有计划。

  2. 选择“ 结果”。

  3. 选择“添加任务”。

  4. 从数据源中选择“自动”。

  5. 从可用集成列表中选择 “Azure DevOps ”。

  6. 选择适当的 Azure DevOps 连接。 如果需要创建新的 Azure DevOps 连接，则需要登录到 Azure DevOps 以创建数据连接。 每个 Azure DevOps 项目都需要一个新连接。 登录后：

    • 提供连接名称：建议在名称中包含 Azure DevOps 组织和项目，以供将来参考。
    • 选择 Azure DevOps 组织
    • 选择 Azure DevOps 项目
    • 选择“下一步”。

  7. 选择连接方法：

    • 共享查询： 用于连接到 Azure DevOps 中保存的现有查询。
    • 工作项： 用于连接到特定工作项类型的一个或多个工作项。 此方法允许你直接连接到包含支持工作的“父”工作项;将自动包含子工作项。

如果使用连接到“共享查询”方法：

  1. 选择 共享查询 方法。
  2. 搜索并选择包含 Azure DevOps 工作项的共享查询。
  3. 选择要用于计算计划进度的工作项类型。 可以从查询中的任何工作项类型或共享查询中的所有工作项中进行选择。
  4. 选择要用于跟踪计划进度的 Azure DevOps 字段。 Viva Goals计划进度按所选工作项类型的完成百分比计算。
  5. 选择“下一步”。
  6. 选择“保存”。

现在，应在计划旁边看到 Azure DevOps 图标。 还应在Viva Goals计划视图中看到 Azure DevOps 工作项详细信息。 Viva Goals现在会自动同步工作项详细信息，并根据共享查询中选择的工作项类型的 ADO 字段，每小时更新一次计划进度。

如果使用“连接到工作项”方法：

  1. 选择 工作项 方法。
  2. 选择要连接到的工作项类型 - 建议在包含正在完成的工作的 Azure DevOps 层次结构中选择“父”工作项类型。 集成将自动包括子工作项。 例如，连接到作为任务的父级功能，而不是连接到每个单独的任务。
  3. 搜索并选择所选类型的特定工作项 () 。
  4. 选择要用于计算计划进度的工作项类型。 可以选择按特定工作项类型 (（即直接连接到的类型）或其任何子类型) 或所有工作项 (（即连接和子) ）来度量进度。
  5. 选择要用于跟踪计划进度的 ADO 字段。
  6. 选择 下一步。
  7. 选择“保存”。

现在，应在计划旁边看到 Azure DevOps 图标。 还应在Viva Goals计划视图中看到 Azure DevOps 工作项详细信息。 Viva Goals现在会自动同步工作项详细信息，并根据所选工作项类型的 Azure DevOps 字段每小时更新此计划进度一次。

完成上述步骤后，不仅会定期自动更新Viva Goals计划进度，还会启用以下功能：

  • Azure DevOps 工作项详细信息显示在Viva Goals计划视图中，以及 Azure DevOps 工作项详细信息的超链接
  • 如果已启用 Viva Goals Azure DevOps 扩展，则可以从链接的 Azure DevOps 工作项中的“Viva Goals”选项卡中访问 OKR 与 Azure DevOps 工作项之间的完全对齐方式。

如何将 Azure DevOps 集成与计划 KPI 配合使用

如果要使用单个数值更新Viva Goals计划进度，请使用此方法。 此方法不会在Viva Goals计划视图中显示 Azure DevOps 工作项;此方法也无法在 Azure DevOps 工作项中嵌入Viva Goals。

  1. 在Viva Goals中选择“添加计划”或编辑现有计划。

  2. 选择“ 结果”。

  3. 选择“ 添加指标 ”并填写必要的详细信息 (，即名称、类型、单位、起始值、目标值)

    • 对于基于百分比的指标，计划进度是根据已完成工作项的选定 ADO 字段值与总工作项的百分比计算的。
    • 对于 (数值、货币) 的非基于百分比的指标，计划进度是已完成的选定 ADO 字段值（可选）总工项的计数。

  4. 选择“ 进度”。

  5. 从数据源中选择“自动”。

  6. 从可用集成列表中选择 “Azure DevOps ”。

  7. 选择适当的 Azure DevOps 连接。 如果需要创建新的 Azure DevOps 连接，则需要登录到 Azure DevOps 以创建数据连接。 每个 Azure DevOps 项目都需要一个新连接。 登录后：

    • 提供连接名称：建议在名称中包含 Azure DevOps 组织和计划，以便将来参考。
    • 选择 Azure DevOps 组织
    • 选择 Azure DevOps 项目
    • 选择“下一步”。

  8. 选择连接方法：

    • 共享查询： 用于连接到存储在 Azure DevOps 中的现有查询
    • 工作项： 用于连接到特定工作项类型的一个或多个工作项。 此方法允许你直接连接到包含支持工作的“父”工作项;会自动考虑子工作项。

如果使用连接到“共享查询”方法：

  1. 选择 共享查询 方法。
  2. 搜索并选择包含 Azure DevOps 工作项的共享查询。
  3. 选择要用于计算计划进度的工作项类型。 可以从查询中的任何工作项类型或查询中的所有工作项中进行选择。
  4. 选择要用于跟踪计划进度的 Azure DevOps 字段。
  5. 选择“下一步”。
  6. 选择“保存”。

现在，应在计划旁边看到 Azure DevOps 图标。 Viva Goals现在每小时自动更新进度一次。

如果使用“连接到工作项”方法：

  1. 选择 工作项 方法。
  2. 选择要连接到的“工作项类型”-我们建议在包含正在完成的工作的 Azure DevOps 层次结构中选择“父”工作项类型。 集成将自动包括子工作项。 例如，连接到作为任务的父级功能，而不是连接到每个单独的任务。
  3. 搜索并选择所选类型的特定工作项 () 。
  4. 选择要用于计算计划进度的工作项类型。 可以选择按特定工作项类型 (（即直接连接到的类型）或其任何子类型) 或所有工作项 (（即连接和子) ）来度量进度。
  5. 选择要用于跟踪计划进度的 ADO 字段。
  6. 选择 下一步。
  7. 选择“保存”。

现在，应在计划旁边看到 Azure DevOps 图标。 Viva Goals现在每小时自动更新此计划一次。

如何将 Azure DevOps 集成与关键结果配合使用

如果要使用单个数值更新Viva Goals键结果进度，请使用此方法。 此方法不会在 Viva Goals 中显示 Azure DevOps 工作项;此方法也无法在 Azure DevOps 工作项中嵌入Viva Goals。

  1. 选择“在Viva Goals中添加密钥结果”或编辑现有密钥结果

  2. 选择“ 添加指标 ”并填写必要的详细信息 (，即名称、类型、单位、起始值、目标值)

    • 对于基于百分比的指标，主要结果进度是根据已完成工作项的所选 ADO 字段值百分比与工作项总数的百分比计算的。
    • 对于 (数值、货币) 的非基于百分比的指标，关键结果进度是已完成的选定 ADO 字段值（可选）的总工作项的计数。

  3. 选择“ 进度”。

  4. 从数据源中选择“自动”。

  5. 从可用集成列表中选择 “Azure DevOps ”。

  6. 选择适当的 Azure DevOps 连接。 如果需要创建新的 Azure DevOps 连接，则需要登录到 Azure DevOps 以创建数据连接。 每个 Azure DevOps 项目都需要一个新连接。 登录后：

    • 提供连接名称：建议在名称中包含 Azure DevOps 组织和计划，以便将来参考。
    • 选择 Azure DevOps 组织。
    • 选择 Azure DevOps 项目。
    • 选择“下一步”。

  7. 选择连接方法：

    • 共享查询： 用于连接到存储在 Azure DevOps 中的现有查询
    • 工作项： 用于连接到特定工作项类型的一个或多个工作项。 此方法允许你直接连接到包含支持工作的“父”工作项;会自动考虑子工作项。

如果使用连接到“共享查询”方法：

  1. 选择 共享查询 方法。
  2. 搜索并选择包含 Azure DevOps 工作项的共享查询。
  3. 选择要用于计算关键结果进度的工作项类型。 可以从查询中的任何工作项类型或共享查询中的所有工作项中进行选择。
  4. 选择要用于跟踪关键结果进度的 ADO 字段。
  5. 选择“下一步”。
  6. 选择“保存”。

现在，关键结果旁边应会显示 Azure DevOps 图标。 Viva Goals现在每小时自动更新进度一次。

如果使用“连接到工作项”方法：

  1. 选择 工作项 方法。
  2. 选择要连接到的“工作项类型”-我们建议在包含正在完成的工作的 Azure DevOps 层次结构中选择“父”工作项类型。 集成将自动包括子工作项。 例如，连接到作为任务的父级功能，而不是连接到每个单独的任务。
  3. 搜索并选择所选类型的特定工作项 () 。
  4. 选择要用于计算关键结果进度的工作项类型。 可以选择按特定工作项类型 (（即直接连接到的类型）或其任何子类型) 或所有工作项 (（即连接和子) ）来度量进度。
  5. 选择要用于跟踪关键结果进度的 ADO 字段。
  6. 选择 下一步。
  7. 选择“保存”。

现在，应该会在“关键结果”旁边看到“Azure DevOps”图标。 Viva Goals现在将根据所选工作项类型的 ADO 字段每小时自动更新此计划一次。

Viva Goals中的 ADO 字段的进度计算：

跟踪进度依据 百分比指标 数字指标
工作项计数 给定查询或工作项类型的总工作项中已完成的工作项的百分比。 给定查询或工作项类型的工作项数。
故事点 已完成工作项的故事点占给定查询或工作项类型的工作项总故事点的百分比。 给定查询或工作项类型的工作项的故事点总和。
努力 已完成工作项的工作量占给定查询或工作项类型的工作项总工作量的百分比。 给定查询或工作项类型的工作项的工作量总和。
原始估算 已完成工作项的总原始估计小时数占给定查询或工作项类型的所有工作项的总原始估计小时数的百分比。 给定查询或工作项类型的工作项的原始估计小时数之和。
剩余工时 不适用 给定查询或工作项类型的工作项的剩余工作时间总计。
已完成的工作 给定查询或工作项类型的所有工作项的总已完成工时占已完成工作项总工时数的百分比。 给定查询或工作项类型的工作项的总已完成工作时间。
自定义字段 给定查询或工作项类型的 ADO 中关联数值自定义字段的完成百分比。 给定查询或工作项类型的 ADO 中关联数值自定义字段的总和。

排查连接问题

若要与 Azure DevOps 集成，Viva Goals服务需要能够访问在 Viva Goals 中创建连接时配置的 Azure DevOps 组织中的工作项和计划。 根据组织管理其Microsoft Entra条件访问策略和 Azure DevOps 权限的方式，Viva Goals可能无法访问信息。

禁止的错误

如果在创建 Azure DevOps 连接时遇到禁止的错误消息，则可能是 IP 地址约束或其他条件访问策略追溯。 在这种情况下，需要验证是否在 Azure DevOps 组织上启用了“启用Microsoft Entra ID CAP 验证”策略，有关详细信息，请参阅 Azure DevOps 文档。

解决方案

有两个选项，可以在 Azure DevOps 组织上关闭启用Microsoft Entra ID CAP 验证策略。 这需要 Azure DevOps 管理员，或者需要将 Viva Goals 服务出站 IP 地址添加到租户的条件访问策略Microsoft Entra ID。

常见问题解答 (常见问题解答)

  1. 将Viva Goals计划任务与 Azure DevOps 连接时，为什么在使用“连接到工作项”方法时，我的共享查询中看不到所有工作项和/或所有子工作项？
    1. 无论Viva Goals计划是否连接到 Azure DevOps，Viva Goals都不会公开所有工作项。 Viva Goals显示的内容取决于在设置过程中选择如何计算总体Viva Goals计划进度。 如果选择按任何工作项计算计划进度，Viva Goals如果直接连接到工作项，则确实会公开所有共享查询工作项或所有子项。

      但是，我们认为选择“任何”工作项类型是例外，因为此方法会公开Viva Goals UX 中不需要的过多工作项详细信息。 我们假设大多数用户选择按共享查询中的特定工作项类型或已连接工作项的子级来计算进度。 Viva Goals将使用该决定来限制我们在 Viva Goals UX 中公开的内容。

      例如，假设 Azure DevOps 工作正在跟踪功能、用户情景和任务。 进一步假设，你选择根据用户情景完成跟踪Viva Goals计划进度。 Viva Goals将仅显示Viva Goals计划视图中的功能和用户情景。 用户可以根据需要快速“双击”Azure DevOps 获取更多详细信息。