共用方式為

Learn 組織報表服務開發人員參考文件

  • 發行項

本文提供實作 Microsoft Learn 組織報表服務的開發人員和要求者的資訊。 我們也建議您參閱 Learn 組織服務最佳做法文章、版本資訊和常見問題集，以支援您的開發旅程。

資料字典

租用戶專屬的資料集

租用戶特定資料是由成就、認證、進度，以及使用者資料集提供。

重要

租用戶特定資料中的 userId 是 Learn 設定檔使用者識別碼，與 Microsoft Entra ObjectId 不同。

若要為租用戶中的使用者取得具有 displayName 的進度記錄：

  • 將您自己的 Microsoft Entra 資料 objectId 與租用戶特定的 Users 資料集AADObjectId聯結
  • 將租用戶特定的使用者 資料集 userId 加入進度userId
  • 選取您自己的 Microsoft Entra 資料 displayName 和適用的進度資料。

當您在 Microsoft Entra 系統管理中心下載使用者詳細資料時，匯出會包含 displayName CSV 格式中的其他屬性。

成就

Achievements 資料集：內含此租用戶中使用者所有贏得獎項的資訊，這些通常是在完成課程模組及學習路徑後所獲得的獎項。 使用者完成課程模組時將獲得徽章，並在學習路徑完成時獲得獎盃。

只要檢視使用者的設定檔，就能在即時網頁上查看使用者成就。 (範例)

tenantId userId awardReason awardType awardUid SourceType SourceUid AwardedOn
{guid} {guid} badge.module.basic.completed 徽章 learn.intro-to-compute.badge 模組 learn.intro-to-compute {datetimeoffset}
{guid} {guid} trophy.path.basic.completed 獎盃 learn.cloud-foundations.trophy LearningPath learn.cloud-foundations {datetimeoffset}

套用的技能

Applied Skills 資料集包含此租用戶中使用者已獲得的所有 Applied Skills 相關資訊，通常是作為完成實驗室工作階段的結果。 成功完成實驗室工作階段時，使用者可能會獲得技能。

tenantId userId appliedSkillsUid labProfileName examScoredDate
{guid} {guid} applied-skill.build-azure-ai-vision-solution APL-3004:建置 Azure AI 視覺解決方案 {datetime}
{guid} {guid} applied-skill.build-collaborative-apps-microsoft-teams APL-4001:建置適用於 Microsoft Teams 的共同作業應用程式 {datetime}

認證

認證資料集包含此租用戶中的使用者因完成一或多個測驗 (視認證所需) 而獲得的所有認證相關資訊，這些認證在過去兩年中仍然有效或已過期。

tenantID userId AwardType TranscriptName SourceUid AwardedOn CertificationStartDate CertificationEndDate StayCurrentEligibilityStartDate
{guid} {guid} Certification Microsoft 認證：Azure AI 工程師技術師 certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} Certification Microsoft 認證：Power Platform 基本概念 certification.power-platform-fundamentals {int} {int} {int} {int}

日期 {int} 值會格式化為 YYYYMMDD。

進度

進度資料集包含此租用戶中的使用者從完成片段內容 (例如個別單元、完整課程模組和學習路徑) 中已賺取多少 XP 點數的相關資訊。 並非所有內容都相等，因此如果包含互動功能，或使用者第一次完成 100% 知識檢定時，可能會獲得更多積分。

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed Unit learn.intro-to-compute.1-introduction 100 {datetimeoffset}
{guid} {guid} points.module.basic.completed 模組 learn.create-azure-account 200 {datetimeoffset}
{guid} {guid} points.path.basic.completed LearningPath learn.cloud-foundations 2100 {datetimeoffset}

使用者

Users 資料集：內含在其他租用戶專屬的資料集中所參考到的所有使用者資訊。 請注意，此資料集不包含任何 PII 資訊。 userId 是 Learn 設定檔使用者識別碼，與 Microsoft Entra ObjectId (AADObjectId) 不同。 當您回報時，您必須將此資料加入 Microsoft Entra 使用者清單，才能查看其他資料的使用者資訊更完整的清單。

tenantId userId AADObjectId CreatedOn
{guid} {guid} {guid} {datetime}

Microsoft Learn 資料集

Microsoft Learn 資料（並非個別租用戶特定）是由 HierarchyAppliedSkills、HierarchyCertification、HierarchyLearningPath、HierarchyLearningPathModule、HierarchyModule 和 HierarchyUnit 資料集提供。

HierarchyAppliedSkills

HierarchyAppliedSkills 資料集包含 Microsoft Learn 中所有 Applied Skills 的相關目錄資訊。

若要深入瞭解 Applied Skills 及其與其他內容類型的關係，請檢視 Learn 內容類型一文 中的 Applied Skills 章節。

appliedSkillsUid title URL 等級 產品 roles 主題 工作
applied-skill.build-azure-ai-vision-solution 建置 Azure AI 視覺解決方案 /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["developer","ai-engineer","maker"] ["artificial-intelligence"] ["建立電腦視覺資源"、"分析影像"、"建立自訂影像分析模型"、"定型和評估模型"、"取用自訂模型"]
applied-skill.build-collaborative-apps-microsoft-teams 建置適用於 Microsoft Teams 的共同作業應用程式 /credentials/applied-skills/build-collaborative-apps-microsoft-teams/ ["intermediate"] ["office-teams","ms-graph","entra-id","ms-copilot"] ["developer"] ["backend-development","frontend-development","custom-app-development"] ["建立聊天機器人"、"建立傳訊延伸模組"、"建立 webhooks"、"建立 Teams 索引標籤"、"將 Microsoft Graph 整合到 Teams 應用程式中"、"分配 Teams 應用程式"]

HierarchyCertification

HierarchyCertification 資料集包含 Microsoft Learn 中所有認證的相關目錄資訊。

若要深入了解認證及其與其他內容類型的關係，請檢視 Learn 內容類型一文中的認證章節。

certificationUid type title 摘要 URL iconUrl 等級 產品 roles 測驗
certification.azure-administrator 0 Microsoft 認證：Azure Administrator Associate Azure 系統管理員會實作、管理和監視組織的 Microsoft Azure 環境。 /certifications/azure-administrator/ /media/learn/certification/badges/microsoft-certified-associate-badge.svg ["intermediate"] ["azure","azure-virtual-machines","azure-storage","azure-active-directory","azure-virtual-network","azure-resource-manager"] ["administrator"] ["exam.az-104"]

HierarchyLearningPath

HierarchyLearningPath 資料集包含 Microsoft Learn 上所有學習路徑的目錄資訊。

若要深入了解學習路徑及其與其他內容類型的關係，請檢視 Learn 內容類型文章 中的 學習路徑章節。

LearningPathUid title URL durationInMinutes points iconUrl 等級 產品 roles 語言
learn.create-serverless-applications 建立無伺服器應用程式 /training/paths/create-serverless-applications/ 517 1925 /training/achievements/create-serverless-applications.svg ["beginner","intermediate"] ["azure","azure-functions","azure-portal","azure-cosmos-db","azure-storage","azure-cloud-shell"] ["developer","student"] ["powershell"]

HierarchyLearningPathModule

HierarchyLearningPathModule 資料集包含課程模組與學習路徑的對應。 (注意：課程模組可以是多個學習路徑的一部分。)

若要深入了解學習路徑及其與其他內容類型的關係，請檢視 Learn 內容類型文章中的 課程模組章節 和 學習路徑章節。

LearningPathUid ModuleUid
learn.security-ops-sentinel azure.query-data-sentinel
learn.architect-data-platform learn.access-data-with-cosmos-db-and-sql-api

HierarchyModule

HierarchyModule 資料集包含所有課程模組 (課程) 的目錄資訊。

若要深入了解課程模組及其與其他內容類型的關係，請檢視 Learn 內容類型一文 中的 模組章節。

moduleUid title URL iconUrl durationInMinutes points 等級 產品 roles 語言
learn.languages.powershell-write-first 編寫您的第一個 PowerShell 程式碼 /training/modules/powershell-write-first/ /training/achievements/powershell/powershell-write-first-code.svg 17 200 ["beginner"] ["dotnet"] ["developer","student"] ["powershell"]

HierarchyUnit

HierarchyUnit 資料集包含所有單元 (課程模組片段) 的目錄資訊。

若要深入了解單元及其與其他內容類型的關係，請檢視 Learn 內容類型一文 中的 單元章節。

unitUid title URL durationInMinutes points moduleUid
learn.azure.query-data-sentinel.1-introduction 簡介 /training/modules/query-data-sentinel/1-introduction/ 5 100 azure.query-data-sentinel
learn.azure.query-data-sentinel.2-exercise-setup 練習 - 使用 Azure Sentinel 活頁簿查詢及視覺化資料 /training/modules/query-data-sentinel/2-exercise-setup/ 10 100 azure.query-data-sentinel

下一步

檢閱下列資源，以協助您在開發旅程中前進: