SDS V1 CSV 文件格式

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

如果使用 SDS V1 格式，则必须对文件设置适当的格式。 上传与本文所述完全命名的文件。 列标题区分大小写。 CSV 文件必须采用 UTF-8 格式且符合 RFC。 此外，我们不接受传入数据中的换行符。 若要查看和下载 SDS V1 CSV 文件的示例集， 请参阅 SDS GitHub 存储库。

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

• school.csv

• student.csv

• teacher.csv

可选/必需：如果仅管理用户，则不需要。 如果同时管理类和课堂注册，则需要提供以下三个文件以及前面提到的三个文件。 如果不是，请不要选择任何具有这些名称的文件。

• section.csv

• studentenrollment.csv

• teacherroster.csv

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

• user.csv

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

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

具有“数据类型”列中标记的已定义枚举值的字段具有一组它们支持的特定值。 枚举字段支持的默认值集 请参阅默认值列表。

school.csv

• 列出的所有组织都将设置为组织类型“school”。

student.csv

• 需要使用“学校 SIS ID”字段引用关联的学校，并生成 school.csv 文件的依赖项。
• 列出的所有用户都将设置为角色类型“student”。
• 应以ISO8601格式提供日期值。
• 年级级别 ENUM 的传入值上缺少前导零“0”（例如“1”）将与定义的值列表 (ENUM) “01”匹配，并将存储为“01”。

teacher.csv

• 需要使用“学校 SIS ID”字段引用关联的学校，从而生成 school.csv 文件的依赖项。
• 列出的所有用户都将设置为角色类型“teacher”。
• 在年级级别 ENUM 的传入值上缺少前导零“0”。 例如，“1”将与 ENUM) “01” (定义的值列表匹配，并存储为“01”。

section.csv

• 需要使用“学校 SIS ID”字段引用关联的学校，从而生成 school.csv 文件的依赖项。
• 如果需要术语信息，建议迁移到 SDS v2.1 CSV 格式 ，同时提供 academicSessions.csv 文件。

studentenrollment.csv

• 这需要使用“Section SIS ID”字段引用关联节，并生成 section.csv 文件的依赖项。
• 这需要使用“SIS ID”字段引用关联用户，并生成 student.csv 文件的依赖项。

teacherroster.csv

• 这需要使用“Section SIS ID”字段引用关联节，并生成 section.csv 文件的依赖项。
• 这需要使用“SIS ID”字段引用关联用户，并生成 teacher.csv 文件的依赖项。

user.csv

• 如果同时同步联系人关系 (监护人) ，则必须在 user.csv 中包含他们的记录。
• 应根据 E.164 标准对电话字段进行格式化，其中使用加号字符并由电话号码成功，或者后跟国家/地区代码、区号、电话前缀和行号的加号字符。

guardianrelationship.csv

• 如果同时同步联系人关系 (监护人) ，则必须在 user.csv 中包含他们的记录。
• 这需要使用“Email”字段引用关联用户，并生成 user.csv 文件的依赖项。
• 这需要使用“SIS ID”字段引用关联用户，并生成 student.csv 文件的依赖项。
• 如果未提供 Role 值，则关系值默认为“userContact”。