通过

设置 Microsoft Learn 组织报告服务

  • 项目

本文将帮助你开始使用 Microsoft Learn 组织报告服务。 如果你不熟悉 Learn 组织报告服务的详细信息或其用例，建议先阅读功能概述。

具体而言，该服务使组织可以从数据集中提取、转换和加载 (ETL) 用户的 Learn 培训和认证数据，然后进一步处理或在 Power BI 等可视化工具中显示它们。 数据集可存储到 Azure Data Lake、Azure Blob 存储、Azure SQL 数据库或 Azure Synapse SQL 池。 组织可使用 Azure Data Share 的无代码 UI 创建和管理其数据共享。

组织报告服务包括每个用户的以下进度信息：为每位用户都提供了 Learn 活动的完成情况，包括：

  • 培训单元
  • 培训模块
  • 已完成的培训学习路径
  • 已获成就（徽章、奖杯、认证、XP）

在数据集中，每位用户获得一个唯一的对象 ID，并且数据集中不存储任何个人身份信息 (PII)。 可通过将对象 ID 发送到组织的 Microsoft 标识服务来识别个人。 有关更多详细信息，请查看“租户特定的数据集和 Microsoft Learn 数据集”部分。

要求

  • 组织必须拥有 Azure 订阅才能创建 Azure Data Share。
  • 代表组织请求此服务的用户必须具有附加到该组织的租户的 Microsoft Entra 帐户。
  • 用户的 Microsoft Entra 帐户需要访问租户的 Azure 门户。

注意

使用此数据共享服务即表示你确认并接受 Microsoft Learn 数据访问和共享协议，同意 Microsoft 就使用组织的租户 ID 登录的 Learn 用户与组织共享 Learn 数据。

接受 Learn 组织报告服务数据共享

若要为组织创建 Learn 组织报表实例，需执行几个步骤：

  1. 选择下面的蓝色“入门”按钮。
  2. 使用工作帐户进行身份验证（如果尚未身份验证）。
  3. 接受许可协议。
  4. 选择目标数据类型（SQL、数据湖或 Blob）。
  5. 设置同步计划。

创建后，可以通过 Azure 门户查看 Azure Data Share。

管理数据共享

数据共享是作为单个实体共享的一组数据集。 数据集可来自 Azure Data Share 支持的多个 Azure 数据源。 目前，Azure Data Share 支持 Azure Blob 存储和 Azure Data Lake Store。 有关此服务的元素，请访问 Azure Data Share 术语页面。

在数据共享中，你将有控件来更新同步计划、手动同步和查看上次运行状态与历史记录。

重要

如果选择同步到 SQL 数据库，并且想要使用下面的 Power BI 模板而不在 Power BI 中执行其他配置，请不要让 Azure Data Share 在名称中创建具有租户 ID 的表。 你应该能够在 Azure Data Share 同步过程中，从表名称中删除租户 ID。 如果选择使用自定义命名约定，仍可以使用 Power BI 模板，只需在 Power BI 中编辑查询即可使用正确的表名称。

Screen shot of the Azure portal on the Data Share configuration pane highlighting Trigger snapshot setting.

此外，你还可将收件人添加到现有数据共享中。

  1. 导航到已发送的数据共享。

  2. 在 Azure Data Share 中，导航到已发送的共享并选择“邀请”选项卡。此处会列出已针对此数据共享向其发送邀请的所有收件人。 若要新添一个，请选择“添加收件人”。

    Screen shot of the Azure portal on the Data Share configuration pane highlighting the Add Recipient button.

  3. 页面右侧将弹出一个面板。 选择“添加收件人”，然后在空白行填写新收件人的电子邮件地址。 可添加任意数量的收件人。

    Add recipients control in the Azure portal to send e-mail notifications.

  4. 选择“添加并发送邀请”。这将向新收件人发送指向此数据共享的邀请电子邮件。

在 Microsoft Entra 管理中心下载用户详细信息

若要查看有关进度和完成数据集中列出的用户的扩展信息，需要将 Microsoft Learn 数据集与你的 Microsoft Entra ID 中的用户信息联接在一起。 可以从 Microsoft Entra 管理中心下载用户及其信息列表。

重要

若要从 Microsoft Entra 管理中心下载用户列表，必须使用 Microsoft Entra ID 中分配给一个或多个组织级别管理员角色的用户登录（用户管理员是所需的最低角色）。 来宾邀请者和应用程序开发人员不被视为管理员角色。

若要下载用户列表：

  1. 使用组织中的用户管理员帐户登录到 Microsoft Entra 组织。

  2. 导航到“Microsoft Entra ID”>“用户”。

  3. 通过勾选左栏中每个用户旁边的框来选择“要下载的用户”。 注意：此时，无法选择所有导出用户。 必须单独选择每个用户。

  4. 在 Microsoft Entra ID 中，选择“用户”>“下载用户”。

  5. 在“下载用户”页上，选择“开始”以接收列出用户配置文件属性的 CSV 文件 。 如果有错误，可以在“批量操作结果”页下载并查看结果文件。 该文件包含每个错误的原因。

    Azure portal showing button to download users CSV file.

    下载文件将包含已筛选的用户列表。

    包含以下用户属性：

    • userPrincipalName
    • displayName
    • surname
    • mail
    • givenName
    • objectId
    • userType
    • jobTitle
    • department
    • accountEnabled
    • usageLocation
    • streetAddress
    • state
    • country
    • physicalDeliveryOfficeName
    • city
    • postalCode
    • telephoneNumber
    • mobile
    • authenticationAlternativePhoneNumber
    • authenticationEmail
    • alternateEmailAddress
    • ageGroup
    • consentProvidedForMinor
    • legalAgeGroupClassification

若要了解步骤和更多详细信息，请参阅文章《在Microsoft Entra 管理中心下载用户列表》。

用于 SQL DB 存储的 Power BI 模板

我们根据 Azure Data Share 中的标准 SQL Server 和 DB 配置（即数据集和 DB 之间的 1:1 映射）创建了一个 Power BI 模板。 这是可视化和对组织报告数据集（包括概要视图以及组织中个人的用户级别培训进度）进行报告的起点，但也可以扩展为进一步生成报表并联接到其他数据。

如果你有兴趣将此模板用于报告解决方案，请查看为 SQL DB 存储设置 Microsoft Learn 组织报告服务 Power BI 模板一文。

后续步骤

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