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

重要

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

为 Microsoft 365 教育版租户设置 SDS

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

SDS 访问和首次登录

  • 若要访问 SDS 管理员门户,请启动 Web 浏览器,导航到 sds.edu.cloud.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 文件的屏幕截图以查看所选规则详细信息。

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

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

    注意

    用户匹配在数据引入期间执行,不会在 Microsoft Entra ID 中写入或更新用户对象。 执行匹配并将其存储在 SDS 数据湖中。 有关详细信息,请参阅将数据管理到 Microsoft 365 时,在将数据转发写入匹配链接时,将 数据管理到 Microsoft 365 用户预配类型 。

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

    警告

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

    警告

    如果 SIS/SMS 用户(例如员工角色组中的用户)可以与@domain1或@domain2或@domain3关联,则必须根据源选择 (示例:prefix@domain) 中所选的属性,在源数据中包含@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。

编辑连接数据配置

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

重要

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

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

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

    提示

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

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

    注意

    用户匹配在数据引入期间执行,不会在 Microsoft Entra ID 中写入或更新用户对象。 执行匹配并将其存储在 SDS 数据湖中。 有关详细信息,请参阅将数据管理到 Microsoft 365 时,在将数据转发写入匹配链接时,将 数据管理到 Microsoft 365 用户预配类型 。

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

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

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

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

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

    • 如果同时为教职员工和学生角色设置了 isPrimary,则将基于教职员工角色进行匹配。

    • 如果未为任何角色设置 isPrimary,尤其是同时设置了教职员工和学生角色,则匹配基于教职员工角色。

    重要

    配置“将数据管理到 Microsoft 365 用户提供类型时,如果已激活该选项以创建不匹配的用户,则使用这些规则来定义 Microsoft Entra UserPrincipalName 属性的构造。

    选择“下一步”以继续。

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

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

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

  • 查看提供的信息。 如果一切正常,请选择“ 提交 ”按钮。 如果没有,可以导航回更正。

    编辑审阅的屏幕截图。

    编辑处理的屏幕截图。

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

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