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

發行項
04/08/2024

本文提供實作 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

下一步

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

共用方式為