GitLab 集成

关于 GitLab 集成

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

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

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

如何启用 GitLab 集成

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

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

    Viva Goals 中集成页的屏幕截图。

  2. 对于 GitLab,可以选择 启用 集成。 如果已创建连接,则可以选择 “管理 集成”。

    屏幕截图突出显示了 Viva Goals 中 GitLab 的启用选项。

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

    屏幕截图显示了在 Viva Goals 中选择“禁用 GitLab 集成”的位置。

对于管理员:如何将 GitLab 连接到 Viva Goals 帐户

  1. 以管理员身份启用集成后,需要从 GitLab 配置页配置 GitLab 连接。

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

    屏幕截图显示你选择在 Viva Goals 中添加新 GitLab 连接的位置。

  3. 输入连接的名称。

    屏幕截图显示了在 Viva 目标中命名新 GitLab 连接的位置。

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

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

如何使用 GitLab 集成并将 GitLab 项目连接到 OKR

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

  1. 创建或编辑 OKR 时,从数据源中选择“ 自动”。 从下拉菜单中选择“ GitLab”。

    屏幕截图显示选择 GitLab 作为数据源的位置。

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

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

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

    显示添加 GitLab 连接详细信息的位置的屏幕截图。

  5. 选择 “被分配者” 以跟踪由特定用户处理的问题。 选择适用的 自定义标签

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

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

如何使用 GitLab 集成计算进度

如果选择 KPI 指标来跟踪进度,则 OKR 的进度将根据问题计数进行计算。 如果选择“完成百分比”来跟踪进度,则会根据已关闭的问题数来计算百分比。

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

注意

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

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

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

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

如何禁用 GitLab 集成

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

注意

如果 Gitlab 中的项目在未标记为 完成的所有子任务的情况下关闭,Viva Goals 将认为该项目自关闭以来已完成。