使用 Microsoft Learn 組織報表服務的最佳做法
本文說明使用 Learn 組織報表服務的最佳做法。
瞭解 Microsoft Learn 資料存取和共用合約
使用此資料共用服務時，您承認並接受 Microsoft Learn 資料存取與共享合約，允許 Microsoft 與貴組織共用 Learn 資料，讓 Learn 使用者以貴組織租使用者識別碼登入。 請先閱讀並瞭解此合約，再使用 Microsoft Learn 組織報表服務，並在任何生產環境中納入輸出。
規劃您將用來視覺化此服務中提供的資料的報表解決方案
根據預設，Microsoft Learn 組織報表服務會提供原始完成資料給組織，且沒有任何儀表板。 您可以擷取資料並將其匯出至 CSV，以快速檢視資料，但必須聯結在一起，才能產生影響。
我們已提供 適用於 SQL DB 儲存體的 Learn 組織報表 Power BI 範本，其中包含許多標準資料視覺效果，但您也可以使用您選擇的任何報表解決方案。 請事先規劃您想要使用的內容，以便將之連結到資料儲存體，作為安裝程序的一部分。
瞭解 Learn 內容模型
為了有效地使用 Microsoft Learn 組織報表服務回應，請務必瞭解 Microsoft Learn 中可用的內容類型及其彼此的關聯性。 如需詳細資訊，請檢閱 Learn 內容類型文章。
特別注意:
- UID 代表「唯一識別碼」，而且對每個內容物件而言都是唯一的。 如果 UID 變更，即使標題或其他中繼資料保持不變，內容也會被視為新的物件。
- 課程模組是 Learn 訓練目錄中的核心物件。 它們全都能夠獨立存在，也就是說，課程模組會教導其內案例或概念端對端，而不需要採用必要條件課程模組。 對於課程模組來說，就是這樣，它們不是學習路徑的一部分。 對於其他課程模組來說，它們會以一或多個學習路徑組合在一起，引導使用者建置更進階的概念。 課程模組不一定要是學習路徑的一部分，或者也可以是一或多個學習路徑的一部分。
- 單元不會寫入為獨立內容。 單元應按照課程模組的特定順序進行。 基於這個理由，我們會包含課程模組詳細資料頁面和第一個單元的連結，以便使用者從該處開始並照順序進行內容。
瞭解當地語系化如何在 Learn 中運作，以及當地語系化內容如何反映在組織報表輸出中
Microsoft Learn 支援網站上超過 65 個地區設定，而且大部分內容已轉譯成這些地區設定。 我們的目標是提供內容中所教授的產品的所有語言版本的內容，但並非所有地區設定體驗都有可用的翻譯內容。
當地區設定記錄沒有相關聯的翻譯可用時，網站上的內容和 API 回應會「恢復」為預設值英文。 在 API 輸出的情況下，當系統出現恢復情況時，您會在其他地區設定回應中看到英文中繼資料。 不過，內容的 URL 仍會指向地區設定，即使主要內容可能會恢復，其中原因是為了允許使用者仍然可在該地區設定中瀏覽網站 (這將顯示翻譯頁首/頁尾，以及任何其他有可用翻譯的連結)。
當更新內容發佈至英文內容時，我們的當地語系化管線會努力儘快更新的當地語系化版本 - 通常會在原始變更後的幾天內完成。 您可以透過網站頁尾查看支援地區設定的完整清單 (選取您要檢視網站之語言的連結)。
我們的訓練內容完成記錄與地區設定無關，這表示我們不會將當地語系化的內容版本區分為使用者訓練完成記錄中的個別物件。 無論使用者完成訓練所使用的語言為何，他們都會獲得整體物件的點數，而且我們不會儲存其完成內容所使用之語言的參照。 這表示如果您在學習體驗中實作 Learn 組織報表服務資料，您必須將此納入考慮，而且，如果您以個別物件的形式載入內容物件，請實現它們之間的等效性，以便無論使用者使用哪種語言完成訓練，他們都能獲得其他語言的學分，而不必重新進行訓練。
瞭解內容版本設定如何在 Learn 中運作，以及如何反映在組織報表輸出中
值得注意的是，內容會隨時更新。 我們通常會每天發佈兩次更新。 它們可能是次要更新，例如次要文字變更，或主要更新，例如主要修訂版本、新增內容或刪除內容。 一般而言，內容組合會以具有成千上萬個參與者的龐大、高度控管開放原始碼專案來管理，因此，隨時都有變更。 如果您在生產系統中使用 Learn 組織報表服務資料，您應該注意這一點，並確定您的系統能夠進行處理。
新增內容物件時，它們會顯示為回應中的新物件 (由 UID 識別)。 修改內容後，您可以根據其 last_modified 值來判斷。 當內容被刪除後，系統將會從回應中將之移除。 雖然 API 回應中更新的內容有時會稍有延遲，但當使用者遵循內容的 URL 時，一律能看到最新的資訊。 刪除時，舊的 URL 會重新導向至新的內容或體驗。
目前沒有任何內容版本的參照超過 last_modified 日期。
瞭解組織報表服務的限制
請參閱 Learn 組織報表服務功能概觀一文 中的限制。
定期重新整理資料
如果您使用 Learn 組織報表服務資料的目錄資訊，來支援您的業務程序，或將之作為網站體驗的一部分向客戶顯示，請確定您每天至少重新整理內容一次。
值得注意的是，內容會隨時更新。 我們通常會每天發佈兩次更新。 它們可能是次要更新，例如次要文字變更，或主要更新，例如主要修訂版本、新增內容或刪除內容。 一般而言，內容組合會以具有成千上萬個參與者的龐大、高度控管開放原始碼專案來管理，因此，隨時都有變更。 如果您在生產系統中使用組織報表服務資料，您應該注意這一點，並確定您的系統能夠進行處理。
請確定已使用 Microsoft Entra 而聯結的資訊會定期重新整理
為了解每個完成記錄的指涉物件，您必須將組織報表資料集資料聯結至您的 Microsoft Entra 資訊，以讓名稱出現在完成記錄旁邊。 如果您未重新整理已使用 Microsoft Entra 而聯結的資料，則可能具有過時人事資料的完成記錄，或遺失與其相關聯的 PII 資料。
參考開發人員文件
Learn 組織報表服務開發人員文件 包含回應中提供的完整資料清單，以及針對如何使用每個欄位來支援絕佳的學習體驗的建議。
下一步
如需支援 Learn 組織報表服務的詳細資訊，請檢閱下列文章: