GitLab 集成

Viva Goals GitLab 集成,你可以根据 GitLab 项目中问题的进度自动更新 OKR (目标结果和关键结果) 进度。

假设你使用 GitLab 跟踪项目,并且你Viva Goals有一个目标,每个季度解决 30 个问题。 将此目标链接到 GitLab 中的相应项目时,OKR 的状态将随着关联项目下的问题得到解决而更新。 还可以跟踪特定用户正在处理的问题进度,以用户为中心的目标。 Viva Goals会自动同步值并绘制目标进度图表,从而节省时间,同时保持 OKR 最新状态。

所有用户和管理员都可以使用此功能。 管理员可以从管理员仪表板管理集成。

启用 GitLab 集成

管理员可以按照以下步骤启用此集成:

  1. 在边栏中,转到“管理员”并选择“集成”选项卡。

  2. 搜索 GitLab,或在 “数据集成 ”部分下找到它。

  3. 选择“GitLab”旁边的“启用”。 如果已创建连接,则可以改为 管理 集成。

    可以通过选择“管理>更改>禁用集成”来禁用集成

以管理员身份将 GitLab 连接到Viva Goals帐户

  1. 以管理员身份启用集成后,需要从“ GitLab 配置 ”页配置 GitLab 连接。 可以通过转到“管理员>Integrations”并选择“GitLab”旁边的“管理”来访问此页面。

  2. 选择“ 新建连接 ”并登录到 GitLab 帐户。

  3. 输入连接的名称。

  4. 可选择与组织中的其他用户共享此连接。 选择“下一步”以启动并运行此集成。 可以随时编辑保存的连接。

  5. Viva Goals允许连接到多个项目。 选择“ 新建连接” ,从另一个项目提取数据。 按名称区分这些连接。 当用户将 OKR 与 GitLab 数据链接时,这些名称会显示给其他用户。

将 GitLab 项目连接到 OKR

配置连接后,下一步是将 OKR 链接到 GitLab 项目。

  1. 创建或编辑 OKR 时,打开 “进度和状态” 下拉列表。 在包含文本“连接到数据源进行自动进度更新”的部分中,找到并选择 GitLab 的图标。

  2. 如果已创建连接,或者管理员与你共享了连接,则会自动选择该连接。 仅当尚未创建或共享连接时,Viva Goals才会提示创建新连接。

  3. 选择要使用度量进度的方法: 完成百分比KPI (成功指标) 。 如果选择 KPI,请提供指标、起始值和目标值。

  4. 如果有多个连接,请选择一个。 所有 关联的项目 都将在下拉列表中提供。 选择 “项目 ”,然后选择 “里程碑”。

  5. “分配到 ”字段中选择一个条目,以跟踪特定用户正在处理的问题。 根据需要选择 “标签 ”。

  6. 选择适当的状态以跟踪已关闭/打开的问题的状态。 此选项仅适用于 KPI 类型的 OKR。

  7. 可以通过键入问题 ID 或问题标题直接搜索问题;或者,可以从“ 问题 ”字段的下拉列表中选择它们。 还可以选择多个问题并将其连接到 OKR。

计算 OKR 的进度

如果使用 KPI 指标来跟踪进度,则会根据问题计数计算 OKR 的进度。 如果使用完成百分比来跟踪进度,则会根据已关闭的问题数来计算百分比。

如果在每个问题下添加了子任务,则将根据子任务的状态来计算进度。 例如,如果将两个问题(每个问题都有两个子任务)连接到 OKR,则关闭问题 1 中的子任务 1 时,进度将更新为 25%。 稍后关闭问题 1 中的子任务 2 时,OKR 进度将为 50%。

备注

如果选择“完成百分比”来跟踪进度,则仅根据已关闭问题百分比计算进度。 如果还想要跟踪未解决的问题,则必须选择 KPI 指标来跟踪进度。

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

  • 如果进度比任何时间点的预期进度少 0 到 25%,则 OKR 状态处于 落后状态,并且进度栏将为橙色。

  • 如果进度比预期的任何时候少 25% 以上,则 OKR 状态 存在风险,并且进度栏将为红色。

禁用 GitLab 集成

管理员可以随时禁用 GitLab 集成:转到“集成”部分中的“GitLab”,然后选择“管理”。 在 “GitLab 配置” 页上,选择“ 更改>禁用集成”。

备注

如果 Gitlab 中的项目已关闭,但未将所有子任务标记为已完成,Viva Goals仍会认为该项目已完成,因为它已关闭。