GitHub 集成

  • 项目

GitHub 集成简介

通过 Viva Goal GitHub 集成，可以根据 GitHub 存储库中问题的进度自动更新 OKR) 进度 (目标和关键结果。

让我们使用此示例：使用 GitHub 来跟踪问题的状态，并且你Viva Goals的目标是每个季度解决 30 个问题。 将此目标链接到 GitHub 中的相应存储库时，当关联存储库中的问题得到解决时，OKR 的状态将更新。 对于以用户为中心的目标，还可以跟踪特定用户正在处理的问题进度。 Viva Goals会自动同步值并绘制目标进度图表，从而节省时间，同时保持 OKR 最新状态。

如何启用 GitHub 集成

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

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

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

  2. 对于 GitHub，可以选择 启用 集成。 如果以前已建立连接或集成已启用，则可以选择 管理 已启用的集成。

    屏幕截图显示了集成页上突出显示的“启用”选项。

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

    屏幕截图显示了在 Viva Goals 中禁用 GitHub 的位置。

如何配置 GitHub 连接

启用集成后，下一步是配置 GitHub 连接。

  1. 选择“ 新建连接”，然后登录到 GitHub 帐户。

    屏幕截图显示了在 Viva Goals 中添加新 GitHub 连接的位置。

  2. 提供连接的名称。

    屏幕截图显示了在 Viva Goals 中为新 GitHub 连接输入名称的位置。

  3. 可以选择与组织中的其他用户共享连接。

  4. 选择“下一步”以启动并运行此集成。 可以随时编辑保存的连接。

注意

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

如何将 GitHub 连接连接到 OKR

配置连接后，下一步是将 OKR 链接到 GitHub 存储库。

  1. 创建或编辑 OKR 时，选择“ 连接数据源”以自动更新进度。 从下拉菜单中选择“ GitHub”。

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

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

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

  4. 选择一个连接，所有 关联的存储库 都将在下拉列表中提供。 选择存储库和 里程碑。

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

  5. 为特定用户正在处理的问题选择一个 被分配者 。 选择适用的 自定义标签 。

  6. 可以跟踪已关闭和打开的问题的状态。 选择适当的状态。

    如果你选择 KPI 指标来跟踪进度，则根据问题计数或已关闭的问题百分比（如果选择完成百分比来跟踪进度）计算进度。

    注意

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

  7. 转到 “下一步 ”，然后选择“ 保存”。

现在，你已将目标链接到 GitHub 中的存储库，以跟踪问题的进度并自动更新相应 OKR 的状态。

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

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

  • 如果进度比预期的任何时候少 25% 以上，则 OKR 状态 处于危险之中，并且进度栏将为红色。