Jira 集成

项目
05/20/2024

注意

租户管理员必须先从Viva Goals租户设置启用 Jira Server 集成，然后才能在Viva Goals组织的Viva Goals集成部分中显示该集成。

将 Jira 与 Viva Goals 集成后，链接的 Jira 用户情景或长篇故事的所有更新都会自动作为目标进度和关键结果进行跟踪， (OKR) Viva Goals。此强大的功能可确保 OKR 进程不会等待手动检查，因为进度在Viva Goals中实时更新。

下面是两种方案，团队看到了Viva Goals与 Jira 集成的好处：

产品经理将其目标、交付功能电子邮件市场活动与 Jira 中的史诗链接在一起。随着史诗中的故事完成，目标越来越接近其目标。
工程团队决定在一个季度内修复 20 个 bug。他们将目标链接到提交所有 bug 的史诗，并将关键绩效指标的目标 (KPI) 成功指标设置为 20。 Viva Goals记录在关闭 20 个 bug 时，目标已达到其目标。

如何启用 Jira 云集成

管理员按照以下步骤启用集成：

在边栏中，转到“管理员”并选择“集成”选项卡。
在 Jira 中，可以选择启用集成。如果之前已建立连接或集成已启用，则可以选择管理已启用的集成。

可以从同一部分禁用集成：转到 “更改 ”，然后从下拉列表中选择“ 禁用集成 ”。

如何配置 Jira 连接

启用集成后，第一步是配置 Jira 连接：

选择“ 新建连接”，并提供连接的名称。
添加 Jira 帐户的服务器 URL 。
对于云中的 Jira 实例，请输入电子邮件地址和应用程序编程接口， (API) 与 Jira 帐户关联的令牌。请参阅为 Jira 云帐户生成 API 令牌的说明。
选择“ 下一步 ”以运行集成。可以随时编辑保存的连接。

在大多数情况下，一个连接就足够了。但Viva Goals允许连接到多个 Jira 实例。选择“ 新建连接 ”以添加另一个实例。可以向连接添加名称以区分它们。当成员将其 OKR 链接到 Jira 情景时，这些名称会显示给成员。

如何将 Jira 连接链接到 OKR

配置连接后，下一步是将 OKR 链接到 Jira 中的故事或史诗：

创建或编辑 OKR 时，选择“ 连接数据源”以自动更新进度。在下拉菜单中，选择“ Jira”。
如果已创建连接，或者管理员已与你共享连接，则会自动选择该连接。仅当尚未创建或共享连接时，Viva Goals才会提示创建新连接。
选择要用于度量关键结果进度的方法、完成百分比或 KPI (成功指标) 。如果选择 KPI，请提供指标、起始值和目标值。
选择一个连接，并添加一个 JQL 查询，以匹配与目标或关键结果相关的任何问题。与查询匹配的 Jira 问题将链接到目标或关键结果的成功。

可以从 Jira 复制 JQL 查询。使用 Jira 中的筛选器搜索要链接到目标的问题。接下来，选择“ 高级 ”选项，Jira 会自动将搜索转换为 JQL 查询。可以将查询字符串复制并粘贴到与 Viva Goals 的集成中。

可以随时编辑链接到目标或关键结果的 JQL 查询。任何编辑都提示重新计算当前进度。

注意

如果使用 Jira 下一代项目，则与经典 Jira 项目相比，对 JQL 的支持行为有所不同。例如，Jira 下一代项目不支持基于 Epic 链接的查询。对于这种情况，Jira 指出：

用户应使用父级 =查询下一代长篇故事。如果要合并这两个项目类型的 Epic，则此类查询的示例为：“Epic Link” = NPC-6 OR parent = NJDP-5。现在可以在全局问题导航器中选择“父”字段作为列，并从 Jira 导出。

选择要用于跟踪进度的指标。有关支持的 Jira 指标的详细信息，请参阅下表：

跟踪进度的依据	完成百分比	Kpi
票证计数	标记为已完成的票证占与指定 JQL 配置匹配的票证总数的百分比。示例 OKR：在本季度之前交付 Jira 集成。 (按此项目中已完成任务的百分比衡量)	与指定的 JQL 配置匹配的票证数。示例 OKR：本季度完成 10 次咨询。 (按标记为已完成) 的咨询票数衡量
花费的时间	在已完成的票证上花费的总小时数中，在与指定的 JQL 配置匹配的票证上花费的总小时数中百分比。示例 OKR：命中本季度计费小时数的 100%。	与指定的 JQL 配置匹配的票证花费的总小时数。示例 OKR：完成本季度 200 小时的咨询。
原始估算	已完成票证上估计的总小时数占票证上与指定 JQL 配置匹配的估计小时总数的百分比。示例 OKR：实现 80% 的功能交付速度。	票证上与指定的 JQL 配置匹配的总估计小时数。示例 OKR：为客户端 A 计划 350 小时的工作。
剩余估计值	不适用	与 JQL 配置匹配的票证的总剩余估计值。示例 OKR：确保本季度节省 20 小时的成本。
Progress	不适用	与 JQL 配置匹配的票证的进度指标的平均值。 Jira 中票证的进度按记录时间/总时间计算。示例 OKR：计划训练项目的平均进度为 70%。
[故事要点]	已完成票证上的故事点数占与指定 JQL 配置匹配的票证上总故事点数的百分比。	与指定 JQL 配置匹配的票证上已完成的票证上的故事点数（总故事点数）。
自定义字段 - 这些字段在 Jira 实例中可用。 Viva Goals自动拉取 Jira 实例中的所有数字自定义字段，并且可以跟踪其进度。	跟踪 Jira 实例中关联的数值自定义字段的完成百分比。	跟踪 Jira 实例中关联的数值自定义字段的总完成数。

注意

有关 Jira 时间和进度跟踪的详细信息，请参阅此 Jira 文章。

如果选择按 KPI 跟踪进度，则可以在选项之间切换，以仅按已完成票证或按所有票证衡量进度。

注意

已完成 票证包括与 Jira Done 工作流状态类别关联的所有状态的票证，而不管票证的解析状态如何。 (请参阅如何为公司管理的项目创建工作流) 。

Jira 集成的工作原理示例

让我们看一下 JIRA 集成的工作原理的两个不同的示例。

示例 1

产品经理 Dana 将其目标 (Ship 功能Email市场活动) 与 Jira 的史诗相关联。用于设置链接的简单 JQL 查询可以是：

“Epic Link” = AE-786

如果史诗中有 10 个故事由团队中的不同设计师、工程师和测试人员拥有，那么每当 10 个故事之一关闭时，Dana 目标的进度就会更新。例如，在 Jira 中关闭三个故事时，Viva Goals会自动将目标进度更新为 30%。如果在 Epic 下添加了第 11 个故事，则此进度将重新计算为 27%。

示例 2

考虑提高 产品整体质量的目标。在这种情况下，你可能希望跟踪生成的 bug 数，而不是作为总体质量的指标来跟踪问题的进度。可以使用跟踪字段中 的“票证计数 ”指标来实现所需的设置。 Viva Goals将自动计算生成的所有票证。

当目标或关键结果链接到 Jira 时，成员可以看到指示连接的进度栏旁边的 Jira 图标。

进度栏的以下颜色指示目标的状态：

如果进度随时比预期进度少 0 到 25%，则 OKR 状态处于落后状态，并且进度栏将为橙色。
如果进度比预期的进度少 25% 以上，则 OKR 状态 处于危险之中，并且进度栏将为红色。

Viva Goals每 60 分钟从 Jira 拉取一次新更新。但是，也可以手动刷新以拉取任何新更改。

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

虽然目标和关键结果会告诉你你的目标是什么以及你如何知道何时达到目标，但计划功能有助于使团队专注于日常执行，以实现关键结果。

什么是计划？

计划有助于跟踪组织为实现 OKR 而执行的所有工作。与关键结果一样，可以在Viva Goals的目标和其他关键结果下创建计划，具体取决于它们有助于实现的结果。若要创建计划，请选择目标或关键结果下的 “添加计划 ”。

有两种使用计划的建议方案：

目标由 KPI 指标跟踪： 如果必须完成某个计划才能实现 KPI 指标，建议将计划创建为目标的子级。计划进度不会汇总到父级，因为它是基于 KPI 指标的。
目标具有多个关键结果： 计划可以是关键结果的同级，因此可以查看实现目标所需的成果 (关键结果) ，以及实现这些成果所需的输出 () 计划。

计划始终放在层次结构的每个级别的目标和关键结果之后。

如何在 Viva Goals 和 Jira 中集成计划

Viva Goals的举措目前支持常用的项目管理系统 Jira。与当前的 Jira 集成一样，可以指定 JQL 来检索 Jira 中构成计划的任务列表。

虽然Viva Goals支持 OKR 的 Jira 集成，但计划可让你查看各个任务及其完成状态。此功能可帮助你更深入地了解执行。计划更新还标注了自上次检查以来发生了哪些更改：哪些任务已完成，以及添加或删除了任何任务。

Viva Goals定期检查 Jira 中的计划进度和更新状态。针对计划计算进度和状态，就像针对关键结果一样。与关键结果一样，还可以根据计划检查，以便暂时替代状态。但是，只要Viva Goals在 Jira 中未检测到计划的完成状态发生更改，此阶段才会持续，此时它将使用自动更新覆盖检查。

计划的当前限制

计划当前具有以下限制：

无法创建未对齐的顶级计划。它们必须与目标或关键结果保持一致。
创建计划时，无法编辑该计划的对齐方式。只能在现有目标或关键结果下创建它，并且它将与该目标或关键结果保持一致。
不支持专用计划。所有Viva Goals用户都可以看到计划。
无法克隆计划，并且无法执行批量操作，例如一次更改多个计划的时间段。
计划最多可以有 200 个任务。

如何通过Viva Goals中的 Jira 故事点跟踪进度

随着组织增加复杂的计划，团队在满足现实的最后期限时变得越来越具有挑战性。这是计划估计非常方便的地方。估算过程不必繁重。如果做得正确，估计会促进多个举措的实现。

有几个估计指标。一个是故事点，它是敏捷框架中的估计指标，用于衡量实现工作项所涉及的工作量。 Jira 中的情景点有助于估算冲刺计划期间积压的工作项。

如何使用故事点在Viva Goals中跟踪关键结果的进度

关键结果的状态将自动更新，具体取决于在 Jira 中完成的故事点。

在 Viva Goals 中创建或编辑关键结果时，请选择要用于衡量进度的方法：完成百分比或 KPI (成功指标) 。

如果选择按完成百分比衡量进度：

选择“ 连接数据源 ”以自动更新进度。在下拉菜单中，选择“Jira”。
如果已创建连接，或者管理员已与你共享连接，则会自动选择该连接。仅当尚未创建或共享连接时，Viva Goals才会提示创建新连接。
提供 JQL，然后从用于跟踪进度的下拉菜单中选择“ 故事点”。
选择“ 下一步>保存”。

如果选择通过 KPI 指标度量进度：

如果选择按 故事点 跟踪进度，则指标名称将自动设置为故事点。但是，可以自定义指标的名称。设置目标值和起始值。
选择“ 连接数据源 ”以自动更新进度。在下拉菜单中，选择“ Jira”。
如果已创建连接，或者管理员已与你共享连接，则会自动选择该连接。仅当尚未创建或共享连接时，Viva Goals才会提示创建新连接。
提供 JQL，然后从用于跟踪进度的下拉菜单中选择“ 故事点”。
默认情况下，将选中“ 仅统计已完成的票证 ”复选框。如果要通过 Jira 中已完成票证的故事点来衡量关键结果的进度，此选项非常方便。但是，如果要通过与 Jira 中 JQL 相关的所有票证的故事点来衡量关键结果的进度，而不考虑完成状态，请清除复选框。
选择“ 下一步>保存”。

如何使用故事点跟踪Viva Goals计划进度

计划的状态将根据 Jira 中完成的故事点自动更新。

在 Viva Goals 中创建或编辑计划时，请选择“选择向计划添加任务的选项”。在下拉菜单中，选择“ Jira”。
如果已创建连接，或者管理员已与你共享连接，则会自动选择该连接。仅当尚未创建或共享连接时，Viva Goals才会提示创建新连接。
提供 JQL，然后从用于跟踪进度的下拉菜单中选择“ 故事点”。

将与 JQL 关联的所有任务以及其他任务详细信息（如姓名、故事点、被分配者和截止日期）列出。
选择“ 下一步>保存”。

有关在 Viva Goals 中使用 Jira 故事点的常见问题

是否可以按 Jira 实例中的自定义字段跟踪进度？

是的，可以通过 Jira 实例中的自定义字段跟踪Viva Goals中关键结果和计划的进度。除了 Viva Goals 支持的指标外，还可以从 Jira 引入任何数值自定义字段来度量进度。

故事点和故事点估计之间有什么区别？

Jira 有两种类型的服务项目：经典和下一代。对经典项目的估计是故事点，下一代项目的估计是故事点估计。

通过