如何使用 SDS V2.1 CSV 文件 (经典) 部署学校数据同步

项目
10/22/2023

重要

到 2024 年底，学校数据同步 (经典) 体验将替换为新的学校数据同步体验。我们建议你开始计划下一年回到学校的新体验的过渡。

可以将逗号分隔值 (CSV) 文件与学校数据同步 (SDS) 配合使用，将学生信息系统 (SIS) 数据导入和同步到Office 365。 SDS 可以将学生、教师、学校、分区和名单信息从 SIS 同步到Microsoft Entra ID和Office 365。使用此方法，你将从 SIS 数据导出或创建用于学校数据同步的 CSV 文件，设置同步配置文件，并将 CSV 上传到 SDS 进行处理。

注意

CSV V2 格式的当前客户可能会在 2022 年 5 月之前继续使用。建议使用 CSV V2.1 格式及其附加功能。

使用 SDS V2.1 CSV 文件格式

本文内容：

开始之前

请确保满足以下先决条件：

教育版租户Office 365
全局管理员帐户
启用了学校数据同步 (计划 1)

注意

通过 SDS 提供的数据可以通过 MS Graph 访问租户中的第三方应用程序。仅同步要提供给这些第三方的数据。

创建同步配置文件并导入 CSV 文件

导出或创建五个必需的 CSV 文件，如果需要，可导出或创建所有或部分可选五个 CSV 文件，并确保它们可供使用。

注意

如果要同步卫报 (联系人) ，还需要在 users.csv 中包含他们的记录。具有监护人角色的用户需要 familyName、givenName 和 email 字段，但电话号码是可选的。若要支持监护人和学生之间的关系，你需要在 relationships.csv 中包含每个关系和关系角色的记录。

按照以下步骤创建同步配置文件并导入文件。同步配置文件是 SDS 用于同步计划上传的 CSV 数据的一组选项和设置。最多可以在单个Office 365租户中创建三个同步配置文件。

若要访问 SDS，请启动专用 Web 浏览器，导航到“sds.microsoft.com”，选择“登录”，并在出现提示时输入Office 365全局管理员帐户凭据。

创建同步配置文件并上传 CSV 文件

登录后，在左侧导航窗格中选择“ + 添加配置文件 ”以创建同步配置文件。

添加配置文件。

在 “选择连接类型 ”页上，输入同步配置文件的名称，然后选择“ 上传 CSV 文件和CSV 文件：SDS V2.1 格式”。完成后，选择“ 开始”。

选择“连接类型”。

在 “同步选项” 页上，选择相应的选项以创建新用户或同步现有用户。然后选择“ 上传文件” 以上传四个 SDS V2.1 CSV 文件。上传后，根据需要完成页面上的选择，然后选择“ 下一步”。

注意

如果运行 SDS 以使用 SDS v1 CSV 格式、Clever CSV 格式、OneRoster API 或 PowerSchool API 创建用户，则必须首先创建“同步现有用户”配置文件，以将定位点 ID 更新到以前创建的所有用户的新 V2.1 架构。初始同步完成后，可以创建 SDS V2.1 同步配置文件，并包括 SDS 之前创建的相同用户。

同步选项。

选择此屏幕上的“上传”按钮时，系统会要求上传所有必需的文件，并可以选择上传其他文件。

选择要添加的数据文件。

添加文件后，选择“上传”按钮，然后继续在“同步选项”屏幕上做出选择。

选择要上传的数据文件。

团队创建选项 – 选中此框可确保 SDS 为每个同步的课堂创建 Microsoft 365 组和课堂团队。如果未选中该框，则 SDS 将仅创建Microsoft 365 组。
替换不支持的特殊字符 - 选中此框将允许 SDS 在同步运行时自动替换不支持的特殊字符。特殊字符将替换为“_”，并且不再在该对象的同步过程中导致错误。
课堂组显示名称的同步选项 - 选中此框将允许教师在第一次同步后控制分区显示名称，并阻止 SDS 覆盖教师所做的分区 DisplayName 更改。
延迟学生访问 - 启用此选项可让你设置 SDS 同步成员身份的日期，并使学生能够查看其课程。禁用此选项可立即同步学生。
何时应停止同步？ - 你通常需要在学年或学期结束时执行此操作。 SDS 停止同步配置文件后，可以选择根据需要清理与此配置文件关联的类。

注意

目前，具有混合格式的单个租户 (即，将 V1 和 V2 同步配置文件主动运行且两者都设置为“同步到见解”) 将不起作用。

在 “用户选项” 页上，选择适当的标识匹配选项，然后选择“ 下一步”。

用户选项。

主键 (源目录) - 这是用于 SDS 标识匹配的 CSV 文件中的属性。观看标识匹配视频，了解有关如何选择适当的源目录属性和正确配置标识匹配设置的其他信息。
主键 (Microsoft Entra ID) - 这是用于 SDS 标识匹配Microsoft Entra ID中的 User 属性。观看标识匹配视频，了解如何选择适当的目标目录属性，以及如何为教师正确配置标识匹配设置。

在“ 审阅 ”页上，确保已做出适当的选择。如果不需要其他更改，请选择“ 创建配置文件”。创建同步配置文件后，SDS 将开始预同步验证过程。如果在此过程中发现任何错误，可以选择修复这些错误并重新上传文件，然后再单击“恢复同步”按钮并启动实际同步过程。如果收到错误并选择不更新它们，则仍可以选择恢复同步而不解决错误。

“审阅”页。