适用于 SDS 的巧妙格式 CSV 文件

可以使用 Clever 格式的 CSV (逗号分隔值) 文件，将学校信息系统 (SIS) 与Office 365同步。 使用此文件格式引入以下数据类别，可以照亮用于预配的核心 SDS 功能。 它还允许你增强下面列出的 Microsoft 365 产品和功能的体验。

将 Clever 格式 CSV 文件用于 SDS 时，必须正确设置文件的格式。 本部分介绍用于 SDS 的格式设置要求。 下面以绿色突出显示唯一 的绝对必填 字段。 这也与 CSV 文件示例 页上的示例信息有关。 必须具有以下五个 CSV 文件，具体命名如下所述。 admins.csv 不接受在 SDS 中使用。

重要

我们接受的 CSV 文件和导出的默认 CSV 文件存在一些差异。 为了上传这些 CSV 文件并成功同步，它们必须遵循此处列出的格式。 有关详细信息，可在此页底部找到。 CSV 文件必须采用 UTF-8 格式。

students.csv

teachers.csv

schools.csv

sections.csv

enrollments.csv

每个 CSV 文件必须包含以下 绿色突出显示 的所有必填字段。 每个 CSV 文件还可以包含列出的任何可选字段。 如果 CSV 文件包含任何不受支持的字符，则通过在 SDS 同步配置文件安装向导中选择“替换不支持的特殊字符”选项，可以在同步期间内联替换这些字符。 但是，这不会删除“空格”，这些空格也无效。 下表按文件列出了文件中的必需属性和可选属性：

注意

Microsoft 建议对 SDS CSV 文件中的所有日期字段使用 ISO 8601 格式 ，格式为 YYYY-MM-DD 或 YYYYMMDD。 SDS 计划在未来几个月内引入功能，这些功能要求在下文所述的“期限开始日期”和“结束日期”字段中采用此格式。

• >Students.csv 出生日期
• >Sections.csv Term StartDate
• >Sections.csv 术语结束日期

默认 Clever 格式 CSV 文件与 SDS 接受的文件之间的差异

SDS 接受的 Clever CSV 文件与 Clever 导出的默认 CSV 文件之间存在一些差异，这可能会导致一些混淆。 最大的区别是 Student.csv 文件中的“用户名”和“密码”列。

用户名字段主要用于配置文件创建期间的匹配条件。 可以在有关如何使用 Clever 格式 CSV 文件进行部署的步骤 5 中查看此内容。

为配置文件创建全新的用户时，将使用用户名列和密码列。

其他差异是可选的同步属性。 SDS 将仅将上的扩展属性同步到上面列出的相关组和用户。 如果这些文件中的任何一个包含其他信息，同步仍将处理，但附加信息不会绑定到用户或组。 这是预期行为，对于所有 CSV 配置文件同步都是如此。

示例：如果按照 Clever 文档中的规定使用“性别”列上传了 student.csv 文件，则 SDS 仍将处理该文件并将其他属性同步到目标学生，但不会为性别同步属性。