使用 SDS v1 CSV 格式的数据引入

  • 项目

警告

SDS (经典) 转换客户：并非所有字段都支持将数据引入基于 v1 格式的新 SDS 体验。 你会发现它们已在“必需”列下的“SDS v1 CSV 文件格式”中记录，因为数据不受支持。 此外，通过的 成绩 值和 课程主题 值必须与相应的值列表保持一致 ， (ENUM) 代码。

为Microsoft 365 教育版租户设置 SDS

  • Microsoft 365 教育版租户

  • 需要全局管理员权限

    重要

    可以使用 CSV (逗号分隔值) 文件来同步学校信息系统 (SIS) /学生管理系统 (短信) 。 SDS 仅支持上传 UTF-8 格式的 CSV 文件。

    每个 CSV 文件都必须包含“必需”下标有“是”的字段的数据，指出“否”的字段为“可选”数据。 标记为“必需”的字段标头必须存在于提供的文件中，否则将不接受它们。 如果未传递相应的可选数据，则标记为“可选”的字段标头不需要存在于文件中。

    有关详细信息， 请参阅 SDS v1 CSV 文件格式。

  1. 选择“打开学校数据同步”。

    显示打开 SDS 的请求的屏幕截图。

    显示打开 SDS 的处理请求的屏幕截图。

    在下一步之前，请等待 15 分钟的时间将服务预配到租户。

    显示暂停以完成服务预配的屏幕截图。

  2. 屏幕将刷新以验证 SDS 是否已完成预配服务。 如果完成，首先连接机构的数据。 选择 “连接数据”。

    选择连接数据提示的屏幕截图。

  3. 选择 “创建新的入站流 ”和“ 下一步 ”以继续。

    显示创建新入站流的提示的屏幕截图。

  4. 选择数据源。 对于 CSV，你将选择“ 连接到我的数据”选项。

  5. 选择格式。 对于 CSV，你将选择“ CSV”选项。 接下来 继续。

    选择 CSV 的屏幕截图。

  6. 需要提供 SIS/SMS 的名称。 此外，选择“SDS v1 CSV”。 接下来 继续。

    显示输入 SIS 名称并选择 CSV 格式的提示的屏幕截图。

  7. 选择“ 浏览文件 ”，显示浏览和选择对话框。

    选择提示浏览 CSV 文件的屏幕截图。

    重要

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

  8. 导航到文件位置并选择文件。

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

    请参阅 SDS v1 CSV 文件格式。

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

    • school.csv

    • student.csv

    • teacher.csv

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

    • section.csv

    • studentenrollment.csv

    • teacherroster.csv

    可选：这些操作不需要继续，但可能会增强体验。 如果选择了以下文件之一，还必须选择另一个文件才能继续。

    • user.csv

    • guardianrelationship.csv (要求用户和学生记录来生成联系人关联。)

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

    显示验证文件名的屏幕截图。

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

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

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

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

  11. 选择当前学年并提供友好名称，例如 2023 或 2022 - 2023。 (字符必须为 utf8，否则将自动剥离) 。

    重要

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

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

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

    选择“下一步”以继续。

    提示“学年”和“停止同步日期”的屏幕截图。

  12. 选择用户标识规则选项。 为教职员工和学生角色做出选择。

    注意

    用户匹配是使用入站流执行的，不会在 Azure AD 中写入或更新用户对象。 匹配将执行并存储在教育数据湖中。 有关详细信息，请参阅 Microsoft 365 管理用户 ，了解如何使用出站流转发匹配链接。

    • 源中的属性：基于来自 SIS/SMS 的数据的用户属性。
      • 可用的源选项包括“用户名”、“Email”和“ActiveDirectory MatchId”。
    • 要匹配的属性：要匹配的 Azure AD 中的用户属性。
      • 可用的 Azure AD 匹配选项包括 UserPrincipalName 和 Mail。
    • (OPTIONAL) 如果用户数据不包括 @domain 值，请从列表中选择域。

    警告

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

    警告

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

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

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

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

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

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

    重要

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

    对所选内容感到满意后，选择“ 下一步 ”继续。

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

  13. 查看“ 查看和创建”上显示的信息。 如果一切正常，请选择“ 创建 ”按钮。 如果没有，你将能够导航回正确。

    “查看和创建”的屏幕截图。]

    选择“创建”后处理的屏幕截图。]

  14. 已创建入站数据流，并且第一次运行挂起，请选择“ 下一步 ”按钮。 请返回查看首次运行的状态。

    已创建入站流的屏幕截图。]

    显示第一次运行处于挂起状态的屏幕截图。]

    显示运行正在进行中的屏幕截图。]

  15. 在为第一次运行留出时间后，导航回主页。

    如果数据没有问题，你将看到 “未找到数据错误”或“警告”。 你将能够继续设置出站流。 有关要选择的可用选项，请参阅热门操作。

    如果发现数据存在问题，你将看到“我们发现你的数据存在一些问题”。 有关详细信息，请选择“ 调查运行运行状况 ”“可以继续设置出站流”。 有关要选择的可用选项，请参阅热门操作。 但是，建议在继续操作之前更正任何错误。 有关详细信息，请参阅 调查运行运行状况。

    注意

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

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