共用方式為

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 和關鍵結果著重於推動影響 (也就是結果) ，而 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 延伸模組直接在連結的 Azure DevOps 工作專案中檢視 ()
  2. 使用 KPI 追蹤計畫的進度： 此方法可讓您根據 Azure DevOps 工作項目狀態來追蹤計劃進度。 單一數值會與 Viva Goals 同步。
  3. 追蹤索引鍵結果的進度： 此方法可讓您根據 Azure DevOps 工作項目狀態來追蹤 KR 進度。 單一數值會與 Viva Goals 同步。

如何設定 Azure DevOps 整合

Viva Goals 租使用者和組織管理員必須啟用 Azure DevOps 整合。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 內的現有查詢。
    • 工作專案： 可讓您連接到特定工作項目類型的一或多個工作專案。 這種方法可讓您直接連線到包含支援工作的「父代」工作專案;系統會自動包含子工作專案。

如果使用連線到 'Shared Query' 方法：

  1. 選取 共用查詢 方法。
  2. 搜尋並選取包含 Azure DevOps 工作專案的共享查詢。
  3. 選取您想要用來計算計劃進度的工作項目類型。 您可以從查詢中的任何工作項目類型或共享查詢中的所有工作項目中選擇。
  4. 選取您想要用於追蹤計劃進度的 Azure DevOps 字段。 Viva Goals 計劃進度會計算為所選工作項目類型的完成百分比。
  5. 選取 [下一步]。
  6. 選取 [儲存]。

您現在應該會在方案旁邊看到 Azure DevOps 圖示。 您也應該會在 Viva Goals 方案檢視中看到 Azure DevOps 工作專案詳細數據。 Viva Goals 現在會自動同步處理工作專案詳細數據，並根據您共用查詢內所選工作專案類型的 ADO 字段，每小時更新計劃進度一次。

如果使用 Connect to Work Items 方法：

  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 內的現有查詢
    • 工作專案： 可讓您連接到特定工作項目類型的一或多個工作專案。 這種方法可讓您直接連線到包含支援工作的「父代」工作專案;系統會自動考慮子工作專案。

如果使用連線到 'Shared Query' 方法：

  1. 選取 共用查詢 方法。
  2. 搜尋並選取包含 Azure DevOps 工作專案的共享查詢。
  3. 選取您想要用來計算計劃進度的工作項目類型。 您可以從查詢中的任何工作項目類型或查詢中的所有工作項目中選擇。
  4. 選取您想要用於追蹤計劃進度的 Azure DevOps 字段。
  5. 選取 [下一步]。
  6. 選取 [儲存]。

您現在應該會在方案旁邊看到 Azure DevOps 圖示。 Viva Goals 現在會每小時自動更新進度一次。

如果使用 Connect to Work Items 方法：

  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 內的現有查詢
    • 工作專案： 可讓您連接到特定工作項目類型的一或多個工作專案。 這種方法可讓您直接連線到包含支援工作的「父代」工作專案;系統會自動考慮子工作專案。

如果使用連線到 'Shared Query' 方法：

  1. 選取 共用查詢 方法。
  2. 搜尋並選取包含 Azure DevOps 工作專案的共享查詢。
  3. 選取您要用於計算金鑰結果進度的工作項目類型。 您可以從查詢中的任何工作項目類型或共享查詢中的所有工作項目中選擇。
  4. 選取您要用於追蹤索引鍵結果進度的 ADO 欄位。
  5. 選取 [下一步]。
  6. 選取 [儲存]。

您現在應該會在金鑰結果旁邊看到 Azure DevOps 圖示。 Viva Goals 現在會每小時自動更新進度一次。

如果使用 Connect to Work Items 方法：

  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 以取得詳細數據。