学校数据同步常见问题解答

什么是学校数据同步?

学校数据同步是 Office 365 教育版 中的一项免费服务,可从 SIS 中读取名册,并为 Microsoft Teams、教育版Intune和第三方应用程序创建课程。 Microsoft Teams 将对话、内容和应用汇集在 Office 365 教育版中。

学校数据同步支持哪些 SIS/MIS 供应商?

由于学校数据同步导入 CSV 文件中的数据,因此它几乎支持市场上的每一个 SIS。 SDS 还支持通过行业标准 OneRoster API 导入名单数据。 客户已与 70 多家 SIS 供应商和数据提供程序一起部署了 SDS。

学校数据同步在哪里可用?

学校数据同步目前在全球除中国和德国以外的所有区域都可用。

哪些应用适用于学校数据同步?

学校数据同步将学校、分区、学生、教师和名册数据从 SIS 导入到Office 365以便可供许多第一方和第三方应用程序使用。 请访问https://sds.microsoft.com查看使用Office 365和学校数据同步数据进行单一登录和名册集成的 EDU 应用列表。

SDS 是自动同步更改还是必须重启同步才能同步发生更改?

同步在创建同步配置文件后持续运行,除非手动停止。 对于 OneRoster API,与 SIS 的连接是连续的,并且始终轮询要同步的数据更改。 如果运行的同步配置文件使用基于 CSV 的可用同步方法之一,可以通过上传包含数据更改的新 CSV 文件来同步数据中的更改。 可以通过 SDS 门户或 SDS 工具包上传新文件。 上传新的 CSV 文件后,如果未遇到任何错误,同步过程将自动开始。 如果你是新数据集包含错误,则可能需要先修正这些错误并重新加载文件,或者点击同步配置文件上的恢复同步按钮以继续同步,而不考虑找到的错误。

访问和管理学校数据同步的权限要求是什么?

若要访问和管理 SDS,帐户必须是租户中的全局管理员。

哪些学校数据同步架构 (对象和属性) 通过 REST API 提供?

教育属性参考包含可用潜在数据的完整列表。 CSV 文件参考介绍了可通过 SDS 导入的必填字段。

如何将数据从 SIS 导出为 Microsoft 所需的 CSV 格式?

由于每个 SIS 都不同,因此我们鼓励学校数据同步 (SDS) 客户联系其 SIS 供应商,以获取支持和帮助,以一种可接受的 SDS 格式、Clever 格式或 OneRoster 格式 () 构建从 SIS 到 CSV 文件的相应导出。 许多 SIS 已具有 CSV 导出功能,不需要自定义工具或数据库提取程序即可完成导出过程。 但是,Microsoft 不支持由 SIS 供应商构建的 SIS 提取器工具。 请联系 SIS 供应商,获取数据导出方面的帮助。

Term StartDate 和 Term EndDate 属性的格式是什么?

学校数据同步不会将 Term StartDate 和 Term EndDate 属性格式限制在当前允许的 .NET 选项之外,但我们建议使用格式 mm/dd/yyyyy (即 2016 年 11 月 19 日或 2016 年 6 月 12 日) 。 未来的开发工作可能会与使用这些属性的特性和功能的此建议保持一致。

是否可以导出 SDS 生成的同步问题/错误?

是的,可以在 SDS UI 中导出配置文件上按配置文件生成的错误列表。 若要导出错误列表,请登录 sds.microsoft.com > 在“将所有错误下载为 .csv 文件”按钮上选择同步配置文件 > 。

Microsoft 是否为我的 SIS 数据提供提取器工具?

Microsoft 不会为任何 SIS 供应商生成或维护提取器工具。 许多 SIS 已在 SIS 中内置了数据提取工具。 如果 SIS 不包含提取工具,并且需要帮助将数据从 SIS 提取为架构 CSV 格式,请联系 SIS 供应商获取支持。

为什么 SDS 中的电子邮件地址存在字符限制?

Microsoft 365 中所有对象的Email地址必须遵守 Internet 电子邮件地址寻址的多个 RFC 标准,并且 SDS 符合每个核心Office 365服务(包括 SharePoint Online、Exchange Online 和 Microsoft Entra ID)中的字符限制。

设置学校数据同步时需要创建多少个同步配置文件?

大多数情况下,学校只需在学校数据同步 (SDS) 中创建单个同步配置文件即可同步所有学校、分区、教师、学生和名册。 有几个原因需要创建更多同步配置文件:

用于标识匹配的多个域 - 配置 SDS 时,必须将源目录中的用户与Microsoft Entra ID中的用户进行匹配。 在每个同步配置文件中,可以为教师指定单个域,为学生指定单个域。 如果教师或学生为标识匹配配置中使用的属性配置了多个域,则可能需要创建多个同步配置文件,以确保租户中的所有用户都匹配。 建议尽量减少在学生和教师之间为核心标识匹配属性(如 UserPrincipalName 和 Mail 属性)配置的域数。

多个同步方法或源目录 - SDS 允许你以几种不同的方式同步对象和属性。 目前,我们接受三种不同类型的 CSV 文件格式, (SDS 格式、Clever 格式、OneRoster 格式) 。 SDS 还允许 API 连接使用 OneRoster API 同步对象和属性。 如果需要从多个源目录导入数据,则需要配置多个同步配置文件。 例如,可能需要一个同步配置文件来同步 OneRoster 中的对象,需要另一个同步配置文件来同步 SDS 格式 CSV 文件中的对象。 建议尽可能减少同步配置文件的数量。

Create新用户和同步现有用户的组合 - SDS 允许你根据源目录数据在 Microsoft Entra ID 中创建新的用户帐户,或与Microsoft Entra ID中已存在的现有用户同步。 如果需要创建一些新用户,并针对某些现有用户进行同步,则需要两个或更多个同步配置文件。 只能在单个同步配置文件中选择这两个选项之一。

csv 文件中的行数超过 200 万 - SDS 对单个同步配置文件中上传的一组 CSV 文件中可以包含的行数有限制。 当前限制为每个 CSV 文件 200 万行。 如果 CSV 文件包含超过 200 万行,则需要 (与学校 () 拆分) 的所有分区、教师、学生、名册,沿学校行拆分整个 CSV 文件集。 拆分后,使用相同的设置创建更多同步配置文件,并相应地上传拆分文件。

CSV 文件中的标题和列是否超出了我打算同步的内容?

是的,CSV 文件可能包含额外的标头和数据。 只有同步配置文件安装向导中选择的属性才会尝试同步。 将忽略任何额外的数据标头和列。

如果我们从 Classroom 中删除用户或分区,当我们再次同步时,它们是否会重新出现?

下次运行同步时,不会覆盖通过 Classroom 手动更新课堂名单。 学校数据同步基于上次同步对名单进行更改,而不是基于手动更改,但以下两项操作除外:重置同步和重新创建同步配置文件。 除了这些例外,以下是 SDS 处理手动添加和删除的方式。

示例 1:

  1. 课堂与教师和学生同步
  2. 教师转到 Classroom,向课堂添加一名合作教师
  3. 然后,该课堂将同步,且不会更改教师注册
  4. (正确行为) 共同教师的成员身份不受影响
  5. 然后,该课堂与添加的副教师同步
  6. () 共同教师的成员身份不受影响的正确行为
  7. 然后,在删除副教师后同步该课堂
  8. (从课堂中删除副教师) 正确的行为

示例 2:

  1. 课堂与教师和学生同步
  2. 教师转到课堂以将学生从课堂中删除
  3. 然后,该课堂将同步,且不会更改学生注册
  4. (正确行为) 学生的非成员身份不受影响
  5. 然后,该课堂与删除的学生同步
  6. () 学生的非成员身份不受影响的正确行为
  7. 然后,在重新添加学生时同步该课堂
  8. (将学生重新添加到课堂) 正确的行为

Microsoft Entra Connect 和 SDS 做什么,它们如何协同工作?

Microsoft Entra Connect (Microsoft Entra Connect) 将本地 AD 用户、组和对象同步到Office 365 Microsoft Entra ID。

学校数据同步 (SDS) 将学生信息系统 (SIS) 中的更多学生和教师属性与已由 Microsoft Entra Connect 同步和创建的现有用户同步。 添加“学生”和“教师”属性可改进标识,并使应用能够基于这些可区分的属性和教育角色提供更丰富的用户体验。 SDS 允许你在Teams 教育版、用于教育设备策略的Intune基于学校的安全组、OneNote 课堂笔记本以及用于第三方应用程序集成的课堂名单中自动创建课堂团队。 Microsoft Entra Connect 和 SDS 永远不会发生冲突,因为 SDS 不会同步或覆盖由 Microsoft Entra Connect 管理的任何属性。 SDS 还提供创建新用户的选项,因此,如果不想从本地 AD 使用 Microsoft Entra Connect 同步和创建用户,可以使用 SDS 直接从 SIS 同步和创建这些用户。

Microsoft Entra Connect 和 SDS 还同步和创建其他对象类型,如组、管理单元和联系人,但与用户不同,这些对象类型不会组合在Microsoft Entra ID中形成单独的和唯一的对象。

Microsoft Entra Connect 和 sds 如何协同工作。

如果我解锁了过期的配置文件,会发生什么情况?

  • 如果 CSV 配置文件过期,并且你将其解锁以设置新的到期日期,则会清除增量处理快照,并且发送到 SDS (经典) 的下一个数据集将作为新数据集进行处理。 如果要上传任何新课程和/或注册,则不会从前一组课程中删除注册。
  • 对于 OneRoster API 同步,配置文件过期后,需要创建新的配置文件。 不会从以前的类中删除注册。

学校数据同步不支持哪些特殊字符?

学校数据同步中不支持几个特殊字符。在创建配置文件期间,你可以让 SDS 自动将找到的不受支持的特殊字符替换为“_”。 以下 链接 介绍了不受支持的字符。

重要

如果有多个同步配置文件,并且需要启用删除特殊字符的选项,则必须在 ALL 同步配置文件上启用此设置。 如果不在同步配置文件之间共享数据,则匹配可能会出现问题。