通过

Learn 组织报告服务开发人员参考文档

  • 项目

本文为实现 Microsoft Learn 组织报告服务的开发人员和请求者提供信息。 我们还建议查看 Learn 组织服务最佳做法文章、发行说明和常见问题以支持你的开发之旅。

数据字典

租户特定的数据集

租户特定的数据由“成就”、“认证”、“进度”和“用户”数据集提供。

重要

特定于租户的数据中的 userId 是 Learn 配置文件用户标识符，它不同于 Microsoft Entra ObjectId。

要为租户中的用户获取带有 displayName 的进度记录，请执行以下操作：

  • 将自己的 Microsoft Entra 数据 objectId 与特定于租户的 Users 数据集 AADObjectId 联接
  • 将特定于租户的 Users 数据集 userId 联接到 ProgressuserId
  • 选择自己的 Microsoft Entra 数据 displayName 和适用的进度数据。

在 Microsoft Entra 管理中心下载用户详细信息时，导出将包含 CSV 格式 displayName 和其他属性。

成就

“成就”数据集包含有关此租户中用户获得的所有奖励的信息，通常是完成模块和学习路径的结果。 模块完成后，用户将获得徽章，学习路径完成后，用户将获得奖杯。

通过查看用户的个人资料，可以在实时站点上显示用户成就。 （示例）

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}

应用的技能

“应用技能”数据集包含有关此租户中用户获得的所有应用技能的信息，这通常通过完成实验室会话获得。 成功完成实验室会话后，用户可能会获得一种技能。

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} 认证 Microsoft Certified: Azure AI Engineer Associate certification.azure-ai-engineer {int} {int} {int} {int}
{guid} {guid} 认证 Microsoft Certified: Power Platform Fundamentals certification.power-platform-fundamentals {int} {int} {int} {int}

日期 {int} 值的格式设置为 。

进度

“进度”数据集包含有关此租户中的用户通过完成内容片段（例如单个单元、完整的模块和学习路径）获得的 XP 积分数信息。 并非所有内容都相同，因此，如果内容中包含交互性，或者他们第一次 100% 完成知识检查，则用户可能会获得更多积分。

tenantId userId XPReason SourceType SourceUid XP AwardedOn
{guid} {guid} points.unit.basic.completed 单位 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}

用户

“用户”数据集包含在其他租户特定的数据集中引用的所有用户的信息。 请注意，此数据集不包含任何 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 中所有应用技能的目录信息。

若要详细了解应用技能及其与其他内容类型的关系，请查看 Learn 内容类型文章中的应用技能部分。

appliedSkillsUid title url 等级 products 角色 主题 任务
applied-skill.build-azure-ai-vision-solution 构建 Azure AI 视觉解决方案 /credentials/applied-skills/build-azure-ai-vision-solution/ ["intermediate"] ["azure-computer-vision"] ["开发人员","AI 工程师","创造者"] ["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"] ["开发人员"] ["backend-development","frontend-development","custom-app-development"] ["生成机器人","创建消息传递扩展","生成 Webhooks","创建 Teams 选项卡","将 Microsoft Graph 集成到 Teams 应用中","分发 Teams 应用"]

HierarchyCertification

HierarchyCertification 数据集包含有关 Microsoft Learn 中所有认证的目录信息。

若要详细了解认证及其与其他内容类型的关系，请查看 Learn 内容类型一文中的认证部分。

certificationUid type title 摘要 url iconUrl 等级 products 角色 考试
certification.azure-administrator 0 经 Microsoft 认证：Azure 管理员助理 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 点 iconUrl 等级 products 角色 语言
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 点 等级 products 角色 语言
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 点 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

后续步骤

查看以下资源，帮助你完成开发之旅：