通过

将数据连接到学校数据同步

  • 项目

重要

通过学校数据同步 (SDS) 连接和提供机构数据，即表示你有权与Microsoft共享此数据，并承诺遵守组织的数据治理标准。

为 Microsoft 365 教育版租户设置 SDS

  • Microsoft 365 教育版租户
  • 需要全局管理员权限
  • 访问 SDS 的全局管理员需要 SDS 计划 1 (A1) 或 SDS 计划 2 (A3/A5) 许可证

SDS 访问和首次登录

  • 若要访问 SDS 管理门户，请启动 Web 浏览器，导航到 sds.microsoft.com，然后使用 Microsoft 365 全局管理员帐户登录。

  • 选择“让我们开始吧”。

    显示欢迎消息的屏幕截图。

  • 选择 继续。

    显示 SDS 概述的屏幕截图。

    在下一步之前，请稍等片刻，让服务预配到租户。

    显示等待服务预配完成时挂起的屏幕截图。

  • 选择 “源”格式。 对于通过 SDS v2.1 CSV 或 SDS v1 CSV 提供的数据，请选择“CSV”。 对于通过 OneRoster API 提供的数据，请选择“API”。 做出选择后，选择“ 下一步”。

    显示 csv 或 API 格式提示的屏幕截图。

  • 提供已连接数据学生信息系统 (SIS) 或学生管理系统的名称 (短信) 。 包括有助于区分不同源之间的连接数据的信息，以便进行管理和故障排除。 对于格式版本，请选择“ SDS v2.1 CSV”。 选择“下一步”以继续。

    显示提示输入名称和 v2.1 csv 格式的屏幕截图。

  • 选择“ 浏览设备 ”，显示浏览和选择对话框。

    注意

    在创建连接数据配置期间进行初始上传后，无论是否在可选文件中进行了数据更改，都需要始终为后续上传提供同一组文件。 如果不这样做，系统将确定记录不再处于活动状态，并按此类方式对其进行标记。

    选择提示浏览 v2.1 csv 文件的屏幕截图。

  • 导航到文件位置并选择文件。

    请参阅 SDS V2.1 CSV 文件格式。

    必需：必须先选择列出的三个文件，然后才能继续。 如果只管理用户，而不管理类，则只需提供这些文件。

    • orgs.csv
    • users.csv
    • roles.csv

    可选/必需：如果仅管理用户，则不需要。 如果同时管理课堂和课堂注册，则需要提供列出的两个文件以及前面的三个文件。 如果不是，请不要选择任何具有这些名称的文件。 如果选择了其中一个文件，而另一个未选中，则选择 “下一步”时，将显示一条消息，指出其中一个文件缺失。 在继续操作之前，需要更正。

    • classes.csv
    • enrollments.csv

    可选：以下是可选文件，用于增强体验。 不需要，除非前面的文件具有基于提供的注释的数据引用。

    • academicSessions.csv (如果 roles.csv、classes.csv 或 courses.csv 包含学术会话数据，则提供这些数据以避免在处理数据时出现错误消息。)
    • courses.csv (如果 classes.csv 数据包含指向课程的链接，则提供这些链接以避免在处理数据时出现错误消息。)
    • demographics.csv
    • userFlags.csv
    • relationships.csv

    导航到文件位置并选择 v2.1 csv 文件的屏幕截图。

  • 完成选择文件后，选择“ 下一步 ”以继续。 在继续下一屏幕之前，系统将验证所选文件的名称。 如果未找到所需文件，则会显示一条消息，并且需要处理并重新选择该文件。

    显示验证 v2.1 csv 文件名的屏幕截图。

  • 验证文件名后，将上传文件以验证所选文件的结构，并使用基于 SDS CSV v2.1 规范的标头名称正确设置格式。

    • 如果收到消息： 找到的一个或多个文件与预期格式不匹配。 查看屏幕，查看是否有任何文件的格式不正确。 更正问题后，需要导航回上一屏幕以重新选择文件。

    • 如果收到消息： 我们无法找到一个或多个可选文件。 查看屏幕以查看找不到哪些文件。 如果不希望收到此消息，则需要导航回上一屏幕以重新选择文件。 否则，请选择“ 下一步 ”以继续。

    上传和验证文件头的 v2.1 文件的屏幕截图。

  • 验证文件架构后，SDS 将从上传的文件执行快速数据验证。 上传的数据通过一些 SDS 数据匹配和验证规则，以帮助识别所需的良好和提供的可选数据。 这并非全部验证规则，而是最常遇到的规则。

    提示

    在载入或 csv 上传体验期间，数据验证结果不会阻塞，你有两个选项：退出并在修复数据后稍后返回，或继续执行下一步以继续设置数据连接，然后通过后续上传提供更正的数据。

    通过数据验证处理的 v2.1 文件的屏幕截图。

    通过数据验证处理的 v2.1 文件的屏幕截图。

  • 有关标记为调查的数据的详细信息，请从列表中选择文件名的视图详细信息，以深入了解特定项目。

    你可以逐个下载报告，以便了解源系统中的调查和修复。

    显示标记的文件列，并能够展开和调查哪些规则标记它们。

    已选择用于查看详细信息的 v2.1 csv 文件的屏幕截图。

    单击规则即可看到前 10 条记录的另一个摘要，例如出于目的。

    已选择用于查看所选规则详细信息的 v2.1 文件的屏幕截图。

    调查完成后，关闭对话框，然后选择“ 下一步”。

  • 选择用户标识规则选项。 为教职员工和学生角色做出选择。 如果教职员工和学生的规则不同，请选择拆分选项以定义唯一规则。 对所选内容感到满意后，选择“ 下一步 ”继续。

    注意

    用户匹配在数据生成过程中执行，不会在 Entra ID Microsoft写入或更新用户对象。 匹配将执行并存储在 SDS 数据湖中。 有关详细信息，请参阅 管理Microsoft 365 用户预配类型的 数据，了解如何在管理数据时将匹配链接转发到 Microsoft 365。

    • 源中的属性：基于来自 SIS/SMS 的数据的用户属性。
      • 可用的源选项包括 Username、 Email 和 ActiveDirectory MatchId。
    • 要匹配的属性：要匹配Microsoft Entra ID 中的 user 属性。
      • 可用Microsoft Entra ID 匹配选项为 UserPrincipalName 和 Mail。
    • (可选) 如果用户数据不包括 @domain 值，请从列表中选择一个域。

    警告

    选择域是可选的，仅当基于源中所选 属性 的传入数据不包括 @domain 值时，才应使用。 如果记录上缺少值，SDS 不会 检查和追加值。 SDS 会将域选择追加到可能导致 @domain@domain 的所有记录，并且无法在这些实例中找到与 Entra ID 中用户Microsoft用户映射的匹配项。

    警告

    如果 SIS/SMS 用户（例如员工角色组中的用户）可以关联到@domain1、@domain2或@domain3则必须基于源选择 (示例 (所选属性，在源数据中包含@domain： prefix@domain) 。 若要将 属性匹配到： UserPrincipalName 或 Mail ，则需要此属性来查找要匹配的正确Microsoft Entra 用户。

    在用户具有多个角色的实例中，以下规则用于确定应在用户记录和 Microsoft Entra 用户对象之间使用哪些教职员工或学生匹配规则。

    • 如果为所有学生角色设置了 isPrimary，即使存在与教职员工角色的关联，也会根据学生角色进行匹配。

    • 如果为任何教职员工角色设置了 isPrimary，即使存在与学生角色的关联，也会根据教职员工角色进行匹配。

    • 如果为教职员工和学生角色都设置了 isPrimary，则会根据教职员工角色进行匹配。

    • 如果未为任何角色设置 isPrimary，尤其是教职员工和学生角色的混合，则匹配基于教职员工角色。

    重要

    将“管理数据”配置为Microsoft 365 用户预配类型时，如果激活选项“ 创建不匹配的用户”，则使用这些规则来定义 Microsoft Entra UserPrincipalName 属性的构造。

    显示用户标识规则提示的屏幕截图。

  • 输入 SDS 应阻止从连接的数据源同步数据更新的日期。 大多数情况下，在学年结束时停止同步数据。 最大值为自同步开始日期起 18 个月。

    显示同步结束日期提示的屏幕截图。

  • 查看提供的信息。 如果一切正常，请选择“ 连接数据 ”按钮。 如果没有，可以导航回正确。

    评审的屏幕截图。

    处理的屏幕截图。

  • 连接数据配置已创建，并且第一次运行挂起，请选择“ 完成 ”按钮。

    已为源创建连接数据配置的屏幕截图。

    提示

    在定义 Connect 数据配置 后、活动首次运行期间或首次运行完成后，可以立即设置管理数据配置。

    显示主页仪表板和管理数据操作的屏幕截图。

  • 若要检查同步运行的状态，请导航回“主页”仪表板页。

    如果数据没有任何问题，则主页仪表板将状态为“未找到数据错误或警告”。在上次运行期间，我们没有遇到任何数据错误或警告。继续完成出色的工作！

    如果发现数据存在问题，“主页”仪表板会通知 “我们发现你的数据存在一些问题， 并鼓励你 调查同步运行状况。

    提示

    若要在初始 CSV 上传后提供数据更新，请参阅 手动 SDS CSV 上传。

    提示

    可以使用 Power Automate 自动上传 CSV。 有关详细信息，请参阅 自动执行 SDS CSV 上传。

编辑 Connect 数据配置

  • 在主页仪表板中，使用左侧导航转到 同步 |配置。

重要

无论 SDS v1 CSV 或 v2.1 CSV 格式如何，以下步骤都是相同的。

显示 csv 同步配置的屏幕截图。

  • 在“连接的数据”选项卡上，选择 “编辑已配置源的源详细信息 ”。

    提示

    若要在初始 CSV 上传后提供数据更新，请参阅 手动 CSV 上传。

  • 查看用户标识规则选项。

    注意

    用户匹配在数据生成过程中执行，不会在 Entra ID Microsoft写入或更新用户对象。 匹配将执行并存储在 SDS 数据湖中。 有关详细信息，请参阅 管理Microsoft 365 用户预配类型的 数据，了解如何在管理数据时将匹配链接转发到 Microsoft 365。

    • 源中的属性：基于来自 SIS/SMS 的数据的用户属性。
      • 可用的源选项包括 Username、 Email 和 ActiveDirectory MatchId。
    • 要匹配的属性：要匹配Microsoft Entra ID 中的 user 属性。
      • 可用Microsoft Entra ID 匹配选项为 UserPrincipalName 和 Mail。

    要 使属性匹配： UserPrincipalName 或 Mail，例如 - prefix@domain，源数据中必须包含 @domain 。

    在用户具有多个角色的实例中，以下规则用于确定应在用户记录和 Microsoft Entra 用户对象之间使用哪些教职员工或学生匹配规则。

    • 如果为所有学生角色设置了 isPrimary，即使存在与教职员工角色的关联，也会根据学生角色进行匹配。

    • 如果为任何教职员工角色设置了 isPrimary，即使存在与学生角色的关联，也会根据教职员工角色进行匹配。

    • 如果为教职员工和学生角色都设置了 isPrimary，则会根据教职员工角色进行匹配。

    • 如果未为任何角色设置 isPrimary，尤其是教职员工和学生角色的混合，则匹配基于教职员工角色。

    重要

    将“管理数据”配置为Microsoft 365 用户 provisingin 类型时，如果激活选项“ 创建不匹配的用户”，则使用这些规则来定义 Microsoft Entra UserPrincipalName 属性的构造。

    选择“下一步”以继续。

    显示编辑用户标识规则提示的屏幕截图。

  • 查看 SDS 应阻止从连接数据源同步数据更新的日期。 大多数情况下，在学年结束时停止同步数据。 最大值为自同步开始日期起 18 个月。

    屏幕截图显示同步结束日期提示的编辑。

  • 查看显示的信息。 如果一切正常，请选择“ 提交 ”按钮。 否则，你可以导航回正确。

    编辑评审的屏幕截图。

    编辑处理的屏幕截图。

  • 连接数据配置已更新，选择“ 关闭 ”按钮。

    源的连接数据配置已更新的屏幕截图。