使用 SDS v2.1 CSV 引入数据

项目
11/29/2023

为Microsoft 365 教育版租户设置 SDS

Microsoft 365 教育版租户
需要全局管理员权限

警告

可以使用 CSV (逗号分隔值) 文件来同步学校信息系统 (SIS) /学生管理系统 (短信) 。 SDS 仅支持上传 UTF-8 格式且符合 RFC 的 CSV 文件。每个 CSV 文件都必须包含“必需”下标有“是”的字段的数据，指出“否”的字段为“可选”数据。标记为“必需”的字段标头必须存在于提供的文件中，否则将不接受它们。如果未传递相应的可选数据，则标记为“可选”的字段标头不需要存在于文件中。有关详细信息，请参阅 SDS v2.1 CSV 文件格式。

重要

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

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

选择“让我们开始吧”。
选择继续。

在下一步之前，请稍等片刻，让服务预配到租户。
选择 “创建新的入站流 ”和“ 下一步 ”以继续。
选择数据源。对于 SDS CSV 2.1，选择“ 连接到我的数据”选项。
选择格式。对于 CSV，请选择“ CSV”选项。 接下来 继续。
需要提供 SIS/SMS 的名称。此外，选择“ SDS 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
完成选择文件后，选择“ 下一步 ”以继续。在继续下一屏幕之前，系统将验证所选文件的名称。如果未找到所需文件，则会显示一条消息，并且需要处理并重新选择该文件。
验证文件名后，将上传文件以验证所选文件的结构，并使用基于 SDS CSV v2.1 规范的标头名称正确设置格式。
- 如果收到消息： 下面找到的一个或多个文件与预期格式不匹配，请查看屏幕，查看是否有任何文件的格式不正确。更正问题后，需要导航回上一屏幕以重新选择文件。
- 如果收到消息： 我们无法找到一个或多个可选文件，请查看屏幕以查看找不到哪些文件。如果不希望收到此消息，则需要导航回上一屏幕以重新选择文件。否则，请选择“ 下一步 ”以继续。
验证文件架构后，SDS 将从上传的文件执行快速数据验证。上传的数据通过一些 SDS 数据匹配和验证规则，以帮助识别所需的良好和提供的可选数据。这并非全部验证规则，而是最常遇到的规则。

提示

在载入或 csv 上传体验期间，数据验证结果不会阻塞，你有两个选项：退出并在修复数据后稍后返回，或继续执行下一步以继续设置数据连接，然后通过后续上传提供更正的数据。
有关标记为调查的数据的详细信息，请从列表中选择文件名的视图详细信息，以深入了解特定项目。

还可以按文件下载报告，以便了解源系统中的调查和修复。

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

通过单击规则，你将能够看到前 10 条记录的另一个摘要，例如出于目的。

调查完成后，关闭对话框，然后选择“ 下一步”。
选择当前学年并提供友好名称，例如 2023 或 2022 - 2023。 (字符必须为 utf8，否则将自动剥离) 。

重要

学年用于关联传入数据，以帮助构建逐年的历史数据。该方法与学年与日历年保持一致。例如，如果学年跨日历年（例如，从 8/15/2022 开始，到 2023 年 6 月 15 日结束），则要选择的学年值为结束年份 2023 年。有关详细信息，请参阅学年处理

输入学年的开始和结束日期。

输入 SDS 应基于此源定义的学年停止同步数据的日期。最常见的是停止同步刚刚输入的学年结束日期的数据。

选择“下一步”以继续。
选择用户标识规则选项。为教职员工和学生角色做出选择。

注意

用户匹配是使用入站流执行的，不会在 Microsoft Entra ID 中写入或更新用户对象。匹配将执行并存储在教育数据湖中。有关详细信息，请参阅 Microsoft 365 管理用户，了解如何使用出站流转发匹配链接。
- 源中的属性：基于来自 SIS/SMS 的数据的用户属性。
  - 可用的源选项包括“用户名”、“Email”和“ActiveDirectory MatchId”。
- 要匹配的属性：要匹配Microsoft Entra ID中的 user 属性。
  - 可用Microsoft Entra ID匹配选项为 UserPrincipalName 和 Mail。
- (可选) 如果用户数据不包括 @domain 值，请从列表中选择一个域。
警告

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

警告

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

在用户具有多个角色的实例中，以下规则用于确定应在用户记录和Microsoft Entra用户对象之间使用哪些教职员工或学生匹配规则。
- 如果为所有学生角色设置了 isPrimary，即使存在与教职员工角色的关联，也会根据学生角色进行匹配。
- 如果为任何教职员工角色设置了 isPrimary，即使存在与学生角色的关联，也会根据教职员工角色进行匹配。
- 如果为教职员工和学生角色都设置了 isPrimary，则会根据教职员工角色进行匹配。
- 如果未为任何角色设置 isPrimary，尤其是教职员工和学生角色的混合，则匹配基于教职员工角色。
重要

配置 Microsoft 365 管理用户流时，如果激活选项以创建不匹配的用户，则使用这些规则来定义 Microsoft Entra UserPrincipalName 属性的构造。

对所选内容感到满意后，选择“ 下一步 ”继续。
查看“ 查看和创建”上显示的信息。如果一切正常，请选择“ 创建 ”按钮。否则，你可以导航回正确。
已创建入站数据流，并且首次运行挂起，请选择“ 完成 ”按钮。请返回查看首次运行的状态。

提示

在定义 Connect 数据配置后、活动首次运行期间或首次运行完成后，可以立即设置管理数据配置。
若要检查运行状态，请导航回“开始仪表板”页。

如果数据没有任何问题，则主页仪表板将声明“未找到数据错误或警告”和“在上次运行期间，我们没有遇到任何数据错误或警告。继续伟大的工作！

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

注意

若要在首次运行后手动上传更改以更新源数据中的更改，请参阅使用 SDS CSV 更新源数据

具有相应运行的最大上传次数为每个日历日六次。如果上传一天六次，则根据每 12 小时的 SDS 自动运行节奏，最多只能再运行两次。

使用 SDS v2.1 CSV 引入数据

为Microsoft 365 教育版租户设置 SDS

SDS 访问和首次登录

其他资源